描述

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

要创建数据库，你必须是超级用户，或者拥有特殊的 CREATEDB 权限。见CREATE USER。

默认情况下，新数据库通过克隆标准系统数据库 template1 来创建。可以通过写成 TEMPLATE name 指定其他模板。特别是，写成 TEMPLATE template0 时，可以创建一个全新的数据库，它只包含你的 PostgreSQL 版本预定义的标准对象。如果你希望避免复制任何可能已添加到 template1 中的站点本地附加对象，这会很有用。

参数

可选参数可以按任意顺序书写，不一定要按照上面的顺序。

注解

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

形如“could not initialize database directory”的错误，多半与数据目录权限不足、磁盘已满或其他文件系统问题有关。

使用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 不包含任何会受此影响的数据或索引。

CONNECTION LIMIT 选项只是近似地被强制执行；如果两个新会话几乎同时启动，而该数据库只剩下一个连接“槽”，则两者都可能失败。此外，该限制对超级用户或后台工作进程无效。

示例

要创建一个新数据库：

CREATE DATABASE lusiadas;

要创建一个由用户 salesapp 拥有、默认表空间为 salesspace 的数据库 sales：

CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;

要创建一个使用不同区域设置的数据库 music：

CREATE DATABASE music
    LC_COLLATE 'sv_SE.utf8' LC_CTYPE 'sv_SE.utf8'
    TEMPLATE template0;

在这个示例中，如果指定的区域设置与 template1 中的不同，则必须使用 TEMPLATE template0 子句。（如果相同，那么显式指定区域设置就是多余的。）

要创建一个使用不同区域设置和不同字符集编码的数据库 music2：

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

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

请注意，区域设置名称是特定于操作系统的，因此上述命令未必在所有环境中都以相同方式工作。

兼容性

SQL 标准中没有 CREATE DATABASE 语句。数据库相当于目录，而目录的创建由实现定义。

参见