Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16

CREATE DATABASE

名称

CREATE DATABASE -- 创建一个新数据库

大纲

CREATE DATABASE name
    [ [ WITH ] [ OWNER [=] user_name ]
           [ TEMPLATE [=] template ]
           [ ENCODING [=] encoding ]
           [ LC_COLLATE [=] lc_collate ]
           [ LC_CTYPE [=] lc_ctype ]
           [ TABLESPACE [=] tablespace_name ]
           [ ALLOW_CONNECTIONS [=] allowconn ]
           [ CONNECTION LIMIT [=] connlimit ] 
           [ IS_TEMPLATE [=] istemplate ] ]

描述

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

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

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

参数

name

要创建的数据库名。

user_name

将拥有新数据库的用户的角色名,或者用DEFAULT来使用默认值(即,执行该命令的用户)。要创建一个被另一个角色拥有的数据库,你必须是该角色的一个直接或间接成员,或者是一个超级用户。

template

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

encoding

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

lc_collate

要在新数据库中使用的排序规则顺序(LC_COLLATE)。这会影响应用到字符串的排序顺序,例如在带 ORDER BY 的查询中,以及文本列上索引所使用的顺序。默认是使用模板数据库的排序规则顺序。附加限制见下文。

lc_ctype

要在新数据库中使用的字符分类(LC_CTYPE)。这会影响字符的类别,如小写、大写和数字。默认是使用模板数据库的字符分类。附加限制见下文。

tablespace_name

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

allowconn

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

connlimit

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

istemplate

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

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

注解

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

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

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

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

不会从模板数据库中复制数据库层面的配置参数(通过ALTER DATABASE设置)。

尽管可以通过指定一个数据库作为模板来从其中而不是template1复制,这(还)不是"COPY DATABASE"功能的一般目的。主要的限制是在模板数据库被拷贝期间其他会话不能连接到它。如果CREATE DATABASE启动时还存在任何其他连接,它将失败。否则,到模板数据库的新连接将被挡在外面直到CREATE DATABASE完成。详见第 22.3 节

为新数据库指定的字符集编码必须与选定的区域设置(LC_COLLATELC_CTYPE)相兼容。如果区域是C(或者等效的POSIX),那么所有编码都被允许,但是对于其他区域设置只有一种编码能正确工作(不过,在 Windows 上 UTF-8 编码能够与任何区域一起使用)。CREATE DATABASE将允许超级用户指定SQL_ASCII编码而不管区域设置,但是这种选择已被废弃并且可能在数据与数据库中存储的区域不是编码兼容时让字符串函数行为失当。

编码和区域设置必须匹配模板数据的编码和区域,除非template0被用作模板。这是因为其他数据库可能包含不匹配指定编码的数据,或者可能包含排序顺序受LC_COLLATELC_CTYPE影响的索引。拷贝这种数据将导致一个由于该新设置损坏的数据库。不过,template0是不会含有任何可能被影响的数据或索引的。

CONNECTION LIMIT选项大概是唯一会被强制的,如果两个新会话在大约同一时间开始并且那时该数据库只剩有一个连接"槽",可能两者都会失败。还有,该限制对超级用户无效。

例子

要创建一个新数据库:

CREATE DATABASE lusiadas;

要在一个默认表空间salesspace中创建一个被用户salesapp拥有的新数据库sales

CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;

要创建一个支持ISO-8859-1字符集的数据库music

CREATE DATABASE music ENCODING 'LATIN1' TEMPLATE template0;

在这个例子中,TEMPLATE template0子句只有在template1的编码不是 ISO-8859-1 时需要。注意改变编码可能要求也选择新的LC_COLLATELC_CTYPE设置。

兼容性

在 SQL 标准中没有CREATE DATABASE语句。数据库等效于目录,而目录的创建由实现定义。

参见

ALTER DATABASE, DROP DATABASE