PostgreSQL自带的命令行工具02- createdb
基础信息
OS版本：Red Hat Enterprise Linux Server release 7.9 (Maipo)
DB版本：16.2
pg软件目录：/home/pg16/soft
pg数据目录：/home/pg16/data
端口：5777
createdb 是 PostgreSQL 中的一个命令行工具，用于创建一个新的 PostgreSQL 数据库。该工具实际上是在后台使用 PostgreSQL 的 CREATE DATABASE SQL 命令来创建数据库的。使用 createdb 工具可以让数据库管理员在命令行环境中快速地创建数据库，无需直接进入 SQL 命令行接口。
通过help查看帮助文档。
[pg16@test ~]$ createdb --help
createdb creates a PostgreSQL database.
Usage:
createdb [OPTION]... [DBNAME] [DESCRIPTION]
Options:
-D, --tablespace=TABLESPACE default tablespace for the database
-e, --echo show the commands being sent to the server
-E, --encoding=ENCODING encoding for the database
-l, --locale=LOCALE locale settings for the database
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
--icu-locale=LOCALE ICU locale setting for the database
--icu-rules=RULES ICU rules setting for the database
--locale-provider={libc|icu}
locale provider for the database's default collation
-O, --owner=OWNER database user to own the new database
-S, --strategy=STRATEGY database creation strategy wal_log or file_copy
-T, --template=TEMPLATE template database to copy
-V, --version output version information, then exit
-?, --help show this help, then exit
Connection options:
-h, --host=HOSTNAME database server host or socket directory
-p, --port=PORT database server port
-U, --username=USERNAME user name to connect as
-w, --no-password never prompt for password
-W, --password force password prompt
--maintenance-db=DBNAME alternate maintenance database
By default, a database with the same name as the current user is created.
Report bugs to <pgsql-bugs@lists.postgresql.org>.
PostgreSQL home page: <https://www.postgresql.org/>
示例1
创建一个名为 “white1” 的数据库：
--创建数据库
[pg16@test ~]$ createdb white1
[pg16@test ~]$ psql -p 5777
psql (16.2)
Type "help" for help.
postgres=# \l
List of databases
Name | Owner | Encoding | Locale Provider | Collate | Ctype | ICU Locale | ICU Rules | Access privileges
-----------+----------+----------+-----------------+-------------+-------------+------------+-----------+-----------------------
postgres | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
template0 | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | | =c/postgres +
| | | | | | | | postgres=CTc/postgres
template1 | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | | =c/postgres +
| | | | | | | | postgres=CTc/postgres
white | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
white1 | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
(5 rows)
这会使用当前用户的默认设置来创建一个新数据库。如果你需要以不同的用户身份来创建数据库，你可以使用 -U 选项来指定用户名，例如：
createdb -U username mydatabase
在这里，username 是 PostgreSQL 中具有创建数据库权限的用户。
示例2
创建数据库white2，指定用户为test2
[pg16@test ~]$ createdb -U test2 white2
[pg16@test ~]$
[pg16@test ~]$ psql -p 5777
psql (16.2)
Type "help" for help.
postgres=# \l
List of databases
Name | Owner | Encoding | Locale Provider | Collate | Ctype | ICU Locale | ICU Rules | Access privileges
-----------+----------+----------+-----------------+-------------+-------------+------------+-----------+-----------------------
postgres | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
template0 | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | | =c/postgres +
| | | | | | | | postgres=CTc/postgres
template1 | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | | =c/postgres +
| | | | | | | | postgres=CTc/postgres
white | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
white1 | postgres | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
white2 | test2 | UTF8 | libc | en_US.UTF-8 | en_US.UTF-8 | | |
(6 rows)
主要选项
-U <username>：指定运行createdb命令的 PostgreSQL 用户。-h <hostname>：指定 PostgreSQL 服务器的主机名，如果你的 PostgreSQL 服务器不是运行在本地机器上。-p <port>：指定 PostgreSQL 服务器的端口，如果不是使用默认端口（默认是 5432）。-e：显示命令执行的 SQL 语句。-T <template>：指定一个模板数据库。新数据库将从指定的模板数据库克隆而来。-O <owner>：指定新数据库的拥有者。
注意
- 使用
createdb之前，确保 PostgreSQL 服务正在运行，并且你具有足够的权限来创建数据库。 - 如果数据库创建成功，
createdb命令通常不会有输出。如果有错误发生（比如数据库已经存在），它会显示错误信息。 - 一些复杂的数据库创建选项（如编码、表空间等）可能需要直接使用 SQL
CREATE DATABASE命令来指定。
createdb 是 PostgreSQL 中一个非常实用的工具，对于快速启动一个新项目或进行开发测试来说，可以节省不少时间和精力。
谨记：心存敬畏，行有所止。