描述

CREATE DATABASE 创建一个新的 PostgreSQL 数据库。

要创建一个数据库，你必须是一个超级用户或者拥有特殊的 CREATEDB 权限。请参考 CREATE ROLE。

默认情况下，新的数据库将通过克隆标准系统数据库 template1 来创建。可以通过写入 TEMPLATE name 来指定一个不同的模板。特别是，通过写入 TEMPLATE template0，你可以创建一个原始的数据库（一个其中不存在用户定义的对象，并且系统对象也没有被修改过的数据库），只包含你的 PostgreSQL 版本预定义的标准对象。如果你想避免复制任何可能被添加到 template1 的安装本地对象，这将非常有用。

参数

可选参数可以按任意顺序写入，而不仅限于上面说明的顺序。

注意

CREATE DATABASE 不能在事务块内部执行。

类似于 “无法初始化数据库目录” 的错误很可能与数据目录的权限不足、磁盘已满或其他文件系统问题有关。

使用 DROP DATABASE 删除数据库。

程序 createdb 是围绕此命令的包装程序，为了方便而提供。

数据库级别的配置参数（通过 ALTER DATABASE 设置）和数据库级别的权限（通过 GRANT 设置）不会从模板数据库中复制。

尽管可以通过指定其名称作为模板来复制 template1 之外的数据库，但这（目前）不打算作为通用的 “COPY DATABASE” 功能。主要的限制是，在复制模板数据库时，没有其他会话可以连接到该模板数据库。如果在启动时存在任何其他连接，CREATE DATABASE 将会失败；否则，对模板数据库的新连接将被锁定，直到 CREATE DATABASE 完成。 有关更多信息，请参见 第 22.3 节。

为新数据库指定的字符集编码必须与所选的区域设置（LC_COLLATE 和 LC_CTYPE）兼容。如果区域设置为 C（或等效的 POSIX），则允许所有编码，但对于其他区域设置，只有一种编码可以正常工作。（但是，在 Windows 上，UTF-8 编码可以与任何区域设置一起使用。） CREATE DATABASE 将允许超级用户指定 SQL_ASCII 编码，而不管区域设置如何，但此选择已被弃用，如果将与区域设置不兼容的字符数据存储在数据库中，可能会导致字符字符串函数行为异常。

编码和区域设置必须与模板数据库的匹配，除非使用 template0 作为模板。这是因为其他数据库可能包含与指定的编码不匹配的数据，或者可能包含其排序顺序受 LC_COLLATE 和 LC_CTYPE 影响的索引。复制此类数据会导致根据新设置损坏的数据库。但是，已知 template0 不包含任何会受到影响的数据或索引。

目前没有使用具有不确定性比较的数据库区域设置的选项（有关说明，请参见 CREATE COLLATION）。如果需要此功能，则需要使用每列排序规则。

CONNECTION LIMIT 选项仅大致强制执行；如果在数据库仅剩一个连接“槽位”时大约同时启动两个新会话，则这两个会话都可能失败。此外，该限制不会对超级用户或后台工作进程强制执行。

示例

创建新数据库

CREATE DATABASE lusiadas;

创建由用户 salesapp 拥有，默认表空间为 salesspace 的数据库 sales

CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;

创建具有不同区域设置的数据库 music

CREATE DATABASE music
    LOCALE 'sv_SE.utf8'
    TEMPLATE template0;

在此示例中，如果指定的区域设置与 template1 中的区域设置不同，则需要 TEMPLATE template0 子句。（如果相同，则显式指定区域设置是多余的。）

创建具有不同区域设置和不同字符集编码的数据库 music2

CREATE DATABASE music2
    LOCALE 'sv_SE.iso885915'
    ENCODING LATIN9
    TEMPLATE template0;

指定的区域设置和编码设置必须匹配，否则会报告错误。

请注意，区域设置名称特定于操作系统，因此以上命令可能无法在所有地方以相同方式工作。

兼容性

SQL 标准中没有 CREATE DATABASE 语句。数据库等效于目录，其创建是实现定义的。

另请参阅