CREATE DATABASE — 创建一个新数据库
CREATE DATABASEname
[ WITH ] [ OWNER [=]user_name
] [ TEMPLATE [=]template
] [ ENCODING [=]encoding
] [ STRATEGY [=]strategy
] [ LOCALE [=]locale
] [ LC_COLLATE [=]lc_collate
] [ LC_CTYPE [=]lc_ctype
] [ ICU_LOCALE [=]icu_locale
] [ 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
来使用默认值(即,执行该命令的用户)。要创建一个被另一个角色拥有的数据库,你必须是该角色的一个直接或间接成员,或者是一个超级用户。
template
要从其创建新数据库的模板名称,或者用DEFAULT
来使用默认模板(template1
)。
encoding
要在新数据库中使用的字符集编码。指定一个字符串常量(例如'SQL_ASCII'
),或者一个整数编码编号,或者DEFAULT
来使用默认的编码(即,模板数据库的编码)。PostgreSQL服务器所支持的字符集在第 24.3.1 节中描述。附加限制见下文。
strategy
创建新数据库时要使用的策略。如果使用WAL_LOG
策略,数据库将逐块复制,
并且每个块将单独写入预写式日志。这是在模板数据库较小的情况下最有效的策略,
因此是默认值。还可以使用旧的FILE_COPY
策略。此策略为目标
数据库使用的每个表空间向预写式日志写入一个小记录。每个这样的记录表示在文件系
统级别将整个目录复制到新位置。虽然这确实大大减少了预写式日志的卷量,特别是如
果模板数据库很大,但它也会强制系统在创建新数据库之前和之后执行检查点。在某些情
况下,这可能会对整体系统性能产生明显的负面影响。
locale
这是一种同时设置LC_COLLATE
和LC_CTYPE
的快捷方式。
其他语言环境设置 lc_messages, lc_monetary,
lc_numeric, and lc_time不是每个数据库固定的,
也不是由该命令设置的。
如果要将它们设置为特定数据库的默认值,则可以使用 ALTER DATABASE... SET
.
lc_collate
要在新数据库中使用的排序规则顺序(LC_COLLATE
)。这会影响应用到字符串的排序顺序,例如在带 ORDER BY 的查询中,以及文本列上索引所使用的顺序。默认是使用模板数据库的排序规则顺序。附加限制见下文。
lc_ctype
要在新数据库中使用的字符分类(LC_CTYPE
)。这会影响字符的类别,如小写、大写和数字。默认是使用模板数据库的字符分类。附加限制见下文。
icu_locale
如果使用ICU区域设置提供程序,则指定ICU区域设置ID。
locale_provider
指定在此数据库中用于默认排序的提供程序。可能的值包括:
icu
,
libc
。 libc
是默认值。可用的选择取决于操作系统和构建选项。
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
语句。数据库等效于目录,而目录的创建由实现定义。