CREATE DATABASE — 创建一个新数据库
CREATE DATABASEname
[ [ 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 ROLE。
默认情况下,新数据库将通过克隆标准系统数据库template1
被创建。可以通过写TEMPLATE
指定一个不同的模板。特别地,通过写name
TEMPLATE template0
你可以创建一个干净的数据库,它将只包含你的PostgreSQL版本所预定义的标准对象。如果你希望避免拷贝任何可能被加入到template1
中的本地安装对象,这将有所帮助。
name
要创建的数据库名。
user_name
将拥有新数据库的用户的角色名,或者用DEFAULT
来使用默认值(即,执行该命令的用户)。要创建一个被另一个角色拥有的数据库,你必须是该角色的一个直接或间接成员,或者是一个超级用户。
template
要从其创建新数据库的模板名称,或者用DEFAULT
来使用默认模板(template1
)。
encoding
要在新数据库中使用的字符集编码。指定一个字符串常量(例如'SQL_ASCII'
),或者一个整数编码编号,或者DEFAULT
来使用默认的编码(即,模板数据库的编码)。PostgreSQL服务器所支持的字符集在Section 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
完成。详见Section 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;
要在一个默认表空间salesspace
中创建一个被用户salesapp
拥有的新数据库sales
:
CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;
用一种不同的locale创建数据库music
:
CREATE DATABASE music LC_COLLATE 'sv_SE.utf8' LC_CTYPE 'sv_SE.utf8' TEMPLATE template0;
在这个例子中,如果指定的locale和template1
中的不同,则需要TEMPLATE template0
子句(如果不是这样,则显式指定locale是多余的)。
用一种不同的locale和字符集编码创建数据库music2
:
CREATE DATABASE music2 LC_COLLATE 'sv_SE.iso885915' LC_CTYPE 'sv_SE.iso885915' ENCODING LATIN9 TEMPLATE template0;
指定的locale和编码设置必须匹配,否则将会报错。
注意locale名称与操作系统相关,因此上述命令可能无法在任何地方以相同的方式工作。
在SQL标准中没有CREATE DATABASE
语句。数据库等效于目录,而目录的创建由实现定义。