CREATE DATABASE

Name

CREATE DATABASE -- 创建新数据库

Synopsis

CREATE DATABASE name
    [ [ WITH ] [ OWNER [=] dbowner ]
	   [ TEMPLATE [=] template ]
           [ ENCODING [=] encoding ]
           [ TABLESPACE [=] tablespace ]
           [ CONNECTION LIMIT [=] connlimit ] ]

描述

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

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

通常,创建者成为新数据库的管理员。 超级用户可以用 OWNER 子句创建其它用户所有的数据库。 他们甚至可以创建没有特殊权限的用户所有的数据库。 有CREATEDB权限的非超级用户使用只能创建自己使用的数据库。

缺省时,新数据库将通过克隆标准系统数据库 template1 来创建。不同的模板可以用 TEMPLATE = name 来写。尤其是,如果你用 TEMPLATE = template0, 你可以创建一个很纯净的数据库,只包括你的版本的 PostgreSQL 预定义的 标准对象。这个方法可以避免把任何已经加入到template1 里的本地安装对象拷贝到新数据库。

参数

name

要创建的数据库名。

dbowner

数据库用户的名字,他将拥有新数据库,或者是写 DEFAULT 使用缺省的(也就是执行命令的用户)。

template

从哪个模板创建新数据库,这是模板名。或者用 DEFAULT 使用缺省模板(template1)。

encoding

创建新数据库用的多字节编码方法。声明一个字串文本名字 (比如,'SQL_ASCII'),或者一个整数编号,或者是 DEFAULT 表示使用缺省编码。 PostgreSQL 服务器支持的字符集在 Section 21.2.1 里描述。

tablespace

和新数据库关联的的表空间名字,或者用 DEFAULT 使用模版数据库使用的缺省表空间。 这个表空间将成为在这个数据库里创建的对象的缺省表空间。 参阅 CREATE TABLESPACE 获取更多信息。

connlimit

数据库可以接受多少并发的连接。-1 (缺省)意味着没有限制。

可选参数可以以任意顺序写,而不仅是上面显示的顺序。

注意

CREATE DATABASE 不能在一个事务块里面执行。

类似 "could not initialize database directory" 这样的错误最有可能是因为数据目录的权限不够, 或者磁盘满,或者其它文件系统的问题。

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

程序 createdb 是是这个命令的封装,提供来方便使用。

尽管我们可以通过把某数据库名声明为模板(而非 template1)从非template1数据库拷贝数据库, 但是这(还)不是一个通用的 "COPY DATABASE" 功能。 因此,我们建议当做模板使用的数据库都应该是以只读方式对待的。 参阅 Section 19.3 获取更多信息。

CONNECTION LIMIT 选项只是近似地强制;如果两个新的连接几乎同时发起, 而只剩下一个连接"槽位"了,那么很可能两个连接都失效。 同样,这个限制不强加在超级用户上。

例子

创建一个新的数据库:

CREATE DATABASE lusiadas;

创建一个由用户 salesapp 所有的数据库 sales,缺省表空间是 salesspace

CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;

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

CREATE DATABASE music ENCODING 'LATIN1';

兼容性

在 SQL 标准里没有 CREATE DATABASE 语句。 数据库等同于目录,其创建是由实现决定的。