CREATE DATABASE

CREATE DATABASE
上一页	上一级	SQL 命令	起始页	下一页

CREATE DATABASE — 创建一个新数据库

大纲

CREATE DATABASE name
    [ WITH ] [ OWNER [=] user_name ]
           [ TEMPLATE [=] template ]
           [ ENCODING [=] encoding ]
           [ STRATEGY [=] strategy ]
           [ LOCALE [=] locale ]
           [ LC_COLLATE [=] lc_collate ]
           [ LC_CTYPE [=] lc_ctype ]
           [ ICU_LOCALE [=] icu_locale ]
           [ ICU_RULES [=] icu_rules ]
           [ LOCALE_PROVIDER [=] locale_provider ]
           [ COLLATION_VERSION = collation_version ]
           [ TABLESPACE [=] tablespace_name ]
           [ ALLOW_CONNECTIONS [=] allowconn ]
           [ CONNECTION LIMIT [=] connlimit ]
           [ IS_TEMPLATE [=] istemplate ]
           [ OID [=] oid ]

描述

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

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

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

参数

name #

要创建的数据库名。

user_name #

将拥有新数据库的用户的角色名称，或者DEFAULT以使用默认值（即执行命令的用户）。要创建由其他角色拥有的数据库，您必须能够 SET ROLE为该角色。

template #

要从其创建新数据库的模板名称，或者用DEFAULT来使用默认模板（template1）。

encoding #

要在新数据库中使用的字符集编码。指定一个字符串常量（例如'SQL_ASCII'），或者一个整数编码编号，或者DEFAULT来使用默认的编码（即，模板数据库的编码）。PostgreSQL服务器所支持的字符集在第 24.3.1 节中描述。附加限制见下文。

strategy #

创建新数据库时要使用的策略。如果使用WAL_LOG策略，数据库将逐块复制，并且每个块将单独写入预写式日志。这是在模板数据库较小的情况下最有效的策略，因此是默认值。还可以使用旧的FILE_COPY策略。此策略为目标数据库使用的每个表空间向预写式日志写入一个小记录。每个这样的记录表示在文件系统级别将整个目录复制到新位置。虽然这确实大大减少了预写式日志的卷量，特别是如果模板数据库很大，但它也会强制系统在创建新数据库之前和之后执行检查点。在某些情况下，这可能会对整体系统性能产生明显的负面影响。

locale #

设置新数据库中的默认排序规则和字符分类。排序规则影响字符串的排序顺序，例如，在带有ORDER BY的查询中，以及文本列索引中使用的顺序。字符分类影响字符的分类，例如，小写、大写和数字。还设置操作系统环境的相关方面，LC_COLLATE和LC_CTYPE。默认设置与模板数据库相同。详情请参阅第 24.2.2.3.1 节和第 24.2.2.3.2 节。

可以通过单独设置lc_collate、lc_ctype或icu_locale来覆盖。

提示

其他语言环境设置 lc_messages, lc_monetary, lc_numeric, and lc_time不是每个数据库固定的，也不是由该命令设置的。如果要将它们设置为特定数据库的默认值，则可以使用 ALTER DATABASE... SET.

lc_collate #

在数据库服务器的操作系统环境中设置LC_COLLATE。默认值是 locale的设置（如果指定），否则与模板数据库的设置相同。请参阅下文了解其他限制。

如果 locale_provider 是 libc，还会设置新数据库中使用的默认排序规则，覆盖设置 locale。

lc_ctype #

在数据库服务器的操作系统环境中设置LC_CTYPE。默认值是 locale的设置（如果指定），否则与模板数据库的设置相同。请参阅下文了解其他限制。

如果locale_provider是 libc，还会设置新数据库中使用的默认字符分类，覆盖设置locale。

icu_locale #

指定ICU区域设置（参见第 24.2.2.3.2 节）作为数据库默认的排序规则和字符分类，覆盖locale的设置。区域设置提供程序必须是ICU。默认值是locale的设置（如果指定）；否则与模板数据库的设置相同。

icu_rules #

指定附加的排序规则以自定义此数据库默认排序的行为。这仅支持 ICU。详情请参见第 24.2.3.4 节。

locale_provider #

指定此数据库中默认排序规则的提供者。可能的值是 icu （如果服务器是使用ICU支持构建的）或libc。默认情况下，提供者与template的提供者相同。详情请参见第 24.1.4 节。

collation_version #

指定要存储在数据库中的排序版本字符串。通常，应该省略此选项，这将导致版本根据操作系统提供的数据库排序的实际版本进行计算。此选项旨在供pg_upgrade使用，用于从现有安装中复制版本。

参见ALTER DATABASE，了解如何处理数据库排序规则版本不匹配的情况。

tablespace_name #

将与新数据库相关联的表空间名称，或者DEFAULT来使用模板数据库的表空间。这个表空间将是在这个数据库中创建的对象的表空间。详见CREATE TABLESPACE。

allowconn #

如果为假，则没有人能连接到这个数据库。默认为真，表示允许连接（除了被其他机制约束以外，例如GRANT/REVOKE CONNECT）。

connlimit #

这个数据库允许多少并发连接。-1 （默认值）表示没有限制。

istemplate #

如果为真，则任何具有CREATEDB特权的用户都可以从这个数据库克隆。如果为假（默认），则只有超级用户或者该数据库的拥有者可以克隆它。

oid #

用于新数据库的对象标识符。如果未指定此参数，PostgreSQL 将自动选择一个合适的OID。此参数主要用于pg_upgrade内部使用，只有pg_upgrade可以指定小于16384的值。

可选的参数可以被写成任何顺序，不用按照上面说明的顺序。

注解

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

带有一行“不能初始化数据库目录”的错误大部分与在数据目录上权限不足、磁盘满或其他文件系统问题有关。

使用DROP DATABASE移除一个数据库。

程序createdb是这个命令的一个包装器程序，为了使用方便而提供。

数据库层面的配置参数(参见 ALTER DATABASE)和数据库级权限(参见GRANT)不会从模板数据库中复制。

尽管可以通过指定一个数据库作为模板来从其中而不是template1复制，这（还）不是“COPY DATABASE”功能的一般目的。主要的限制是在模板数据库被拷贝期间其他会话不能连接到它。如果CREATE DATABASE启动时还存在任何其他连接，它将失败。否则，到模板数据库的新连接将被挡在外面直到CREATE DATABASE完成。详见第 23.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;

要在一个默认表空间salesspace中创建一个被用户salesapp拥有的新数据库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语句。数据库等效于目录，而目录的创建由实现定义。

参见

ALTER DATABASE, DROP DATABASE