209 lines
5.2 KiB
ReStructuredText
209 lines
5.2 KiB
ReStructuredText
**********************
|
|
Create Database
|
|
**********************
|
|
|
|
.. contents:: Table of Contents
|
|
|
|
|
|
The geodb Database
|
|
=========================
|
|
|
|
We will be using the geodb database throughout these docs and tutorials.
|
|
|
|
We'll see how to create the database and user using psql as well as the control panel and PgAdmin.
|
|
|
|
You can use any PostGIS enabled database, or give your database any other name you wish to.
|
|
|
|
|
|
Create a User
|
|
==================
|
|
|
|
To create a PostgreSQL user, connect to psql
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
root@demo:~# su - postgres
|
|
postgres@lizmap-demo:~$ psql
|
|
psql (15.3 (Ubuntu 15.3-1.pgdg22.04+1))
|
|
Type "help" for help.
|
|
postgres=#
|
|
|
|
Issue the CREATE USER command and supply a password:
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
postgres=# CREATE USER geouser WITH PASSWORD 'SecretPassword';
|
|
|
|
|
|
Replace SecretPassword above with a secure password.
|
|
|
|
Create a Database
|
|
==================
|
|
|
|
To create our PostgreSQL database, geodb, connect to psql
|
|
|
|
.. code-block:: bash
|
|
|
|
postgres@demo:~$ psql
|
|
postgres=#
|
|
|
|
We'll now create the database with the CREATE DATABASE command and give ownership to user we created above:
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
postgres=# CREATE DATABASE geodb WITH OWNER = geouser;
|
|
|
|
|
|
|
|
The above will create our database as well as give ownership of the database to user geouser
|
|
|
|
List Databases
|
|
==================
|
|
|
|
We can list all databases by connecting as postgres and issuing \\l
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
postgres@demo:~$ psql
|
|
psql (15.3 (Ubuntu 15.3-1.pgdg22.04+1))
|
|
Type "help" for help.
|
|
postgres=# \l
|
|
List of databases
|
|
Name | Owner | Encoding | Collate | Ctype | ICU Locale | Locale Provider | Access privileges
|
|
------------+----------+----------+---------+---------+------------+-----------------+-----------------------
|
|
geostore | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
|
|
geodb | geouser | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
|
|
postgisftw | pgis | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
|
|
postgres | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc |
|
|
template0 | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc | =c/postgres +
|
|
| | | | | | | postgres=CTc/postgres
|
|
template1 | postgres | UTF8 | C.UTF-8 | C.UTF-8 | | libc | =c/postgres +
|
|
| | | | | | | postgres=CTc/postgres
|
|
(5 rows)
|
|
|
|
(END)
|
|
|
|
|
|
Connect to Database
|
|
====================
|
|
|
|
To connect to our PostgreSQL database, geodb, connect to psql
|
|
|
|
.. code-block:: bash
|
|
|
|
postgres@demo:~$ psql
|
|
postgres=#
|
|
|
|
Use \\c to connect to the database
|
|
|
|
.. code-block:: bash
|
|
|
|
postgres=# \c geodb
|
|
You are now connected to database "geodb" as user "postgres".
|
|
|
|
|
|
|
|
List Tables
|
|
====================
|
|
|
|
To list all relations in a database, connect to the database and use \\dt
|
|
|
|
.. code-block:: bash
|
|
|
|
postgres=# \c geodb
|
|
postgres=# \dt
|
|
Did not find any relations.
|
|
|
|
Since we just created our database and have not created any tables, no relations are found.
|
|
|
|
Let's connect to the postgisftw database created when we installed pg_tileserv.
|
|
|
|
.. code-block:: bash
|
|
|
|
postgres=# \c postgisftw
|
|
You are now connected to database "postgisftw" as user "postgres".
|
|
|
|
Now, list the relations using \\dt
|
|
|
|
.. code-block:: bash
|
|
|
|
postgisftw=# \dt
|
|
List of relations
|
|
Schema | Name | Type | Owner
|
|
--------+-------------------+-------+----------
|
|
public | configuration | table | pgis
|
|
public | countries | table | pgis
|
|
public | pointsofinterest | table | pgis
|
|
public | spatial_ref_sys | table | postgres
|
|
public | ways | table | pgis
|
|
public | ways_vertices_pgr | table | pgis
|
|
(8 rows)
|
|
|
|
postgisftw=#
|
|
|
|
|
|
We've now seen how to create a PostgreSQL database and user, as well as how to connect to our database and list relations
|
|
|
|
Create Using the Control Panel
|
|
===================================
|
|
|
|
We'll now see how to create our user and database via the control panel.
|
|
|
|
Begin by clicking "PostgreSQL Database Server" on the left menu
|
|
|
|
**1. Click the "PostgreSQL Users" icon as show below**
|
|
|
|
.. image:: 1-Create-DB-user.png
|
|
:width: 100 %
|
|
|
|
|
|
.. image:: spacer.png
|
|
|
|
**2. Click the "Create New User" button as show below**
|
|
|
|
.. image:: 2-Create-DB-user-2.png
|
|
:width: 100 %
|
|
|
|
.. image:: spacer.png
|
|
|
|
**3. For the usrname, enter geouser, for the password enter a secure password.**
|
|
|
|
**4. Click the "Create" button**
|
|
|
|
.. image:: 3-Create-DB-user-3.png
|
|
:width: 100 %
|
|
|
|
.. image:: spacer.png
|
|
|
|
**5. Back on the main PostgreSQL Database menu, click the "Create a New Database" button**
|
|
|
|
.. image:: 4-Create-DB-panel-1.png
|
|
:width: 100 %
|
|
|
|
.. image:: spacer.png
|
|
|
|
**6. For the database name, enter geodb and select the user we created (geouser) from the dropdown for Database Owner.**
|
|
|
|
**7. Click the Create button**
|
|
|
|
.. image:: 5-Create-DB-panel-2.png
|
|
:width: 100 %
|
|
|
|
.. image:: spacer.png
|
|
|
|
**The database should now appear in the main PostgreSQL section.**
|
|
|
|
.. image:: 6-view-database.png
|
|
:width: 100 %
|
|
|
|
.. image:: spacer.png
|
|
|
|
We've now used the control panel to create a PostgreSQL user and database.
|
|
|
|
|
|
|