createdb
是一个用于创建数据库的核心实用程序,本质上是 CREATE DATABASE
SQL 命令的包装器。
createdb
添加于 PostgreSQL 7.0。
用法
截至 PostgreSQL 15,createdb
不再接受用于提供 conninfo 字符串的 -d 选项;连接参数必须单独提供或通过环境变量提供。
如果默认的 postgres 数据库不存在,请使用 --maintenance-db
提供要连接到的数据库的名称。
从 PostgreSQL 8.3 开始,createdb
在成功创建数据库后不再输出任何内容。
源代码
createdb
的源代码位于 src/bin/scripts/createdb.c。
更改历史记录
- PostgreSQL 17
- 选项
--locale-provider
接受附加值builtin
(提交 2d819a08)
- 选项
- PostgreSQL 16
- 添加选项
--icu-rules
(提交 30a53b79)
- 添加选项
- PostgreSQL 15
- PostgreSQL 9.2
- 添加选项
--maintenance-db
(提交 68281e00)
- 添加选项
- PostgreSQL 8.4
- 添加选项
-w
/--no-password
(提交 9de59fd1)
- 添加选项
- PostgreSQL 8.3
- 移除选项
--quiet
(提交 9539e64b)
- 移除选项
- PostgreSQL 7.4
- 从 shell 脚本转换为 C 程序 (提交 9e0ab712)
- PostgreSQL 7.3
- 添加对包含空格的标识符的支持 (提交 5804a7ce)
- PostgreSQL 7.1
- 添加选项
--template
(提交 c3b00e7e)
- 添加选项
- PostgreSQL 7.0
- 添加 (提交 240e4c98)
示例
createdb
的基本用法示例
$ createdb -h localhost -p 5432 -U postgres testdb $
从 template0 创建数据库
$ createdb -h localhost -p 5432 -U postgres --template=template0 testdb
尝试创建已存在的数据库
$ createdb -h localhost -p 5432 -U postgres postgres createdb: error: database creation failed: ERROR: database "postgres" already exists
参考文献
- PostgreSQL 文档: createdb