功能描述

创建一个新的数据库。缺省情况下新数据库将通过复制标准系统数据库template0来创建，且仅支持使用template0来创建。

注意事项

只有拥有CREATEDB权限的用户才可以创建新数据库，系统管理员默认拥有此权限。
不能在事务块中执行创建数据库语句。
在创建数据库过程中，若出现类似“could not initialize database directory”的错误提示，可能是由于文件系统上数据目录的权限不足或磁盘满等原因引起。

语法格式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

CREATE DATABASE database_name
    [ [ WITH ] { [ OWNER [=] user_name ] |
               [ TEMPLATE [=] template ] |
               [ ENCODING [=] 'encoding' ] |
               [ LC_COLLATE [=] 'lc_collate' ] |
               [ LC_CTYPE [=] 'lc_ctype' ] |
               [ DBCOMPATIBILITY [=] 'compatibilty_type' ] |
               [ TABLESPACE [=] tablespace_name ] |
               [ CONNECTION LIMIT [=] connlimit ] |
               [ DBTIMEZONE [=] 'time_zone' ] }[...] ];

参数说明

database_name

数据库名称。

取值范围：字符串，要符合标识符命名规范。

OWNER [ = ] user_name

数据库所有者。缺省时，新数据库的所有者是当前用户。

取值范围：已存在的用户名。

TEMPLATE [ = ] template

模板名。即从哪个模板创建新数据库。GaussDB采用从模板数据库复制的方式来创建新的数据库。初始时，GaussDB包含两个模板数据库template0、template1，以及一个默认的用户数据库postgres。

取值范围：仅template0。

ENCODING [ = ] ‘encoding‘

指定数据库使用的字符编码，可以是字符串（如’SQL_ASCII’）、整数编号。

不指定时，默认使用模版数据库的编码。模板数据库template0和template1的编码默认与操作系统环境相关。template1不允许修改字符编码，因此若要变更编码，请使用template0创建数据库。

常用取值：GBK、UTF8、Latin1、GB18030等，具体支持的字符集如下。

需要注意并非所有的客户端API都支持上面列出的字符集。
SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据 ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码， 因为这个声明会忽略编码。在大多数情况下，如果你使用了任何非ASCII数据，那么使用 SQL_ASCII设置都是不明智的，因为数据库将无法帮助你转换或者校验非ASCII字符。

指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。
当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z[\]^_`a-z{|}重叠。其中@[\]^_'{|}是数据库中的操作符，直接作为对象名时，会语法报错。例如“侤”字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII“@”符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。
若客户端编码为A，服务器端编码为B，则需要满足数据库中存在编码格式A与B的转换。数据库能够支持的所有的编码格式转换详见系统表PG_CONVERSION（若无法转换，则建议客户端编码与服务器端编码保持一致，客户端编码可通过GUC参数client_encoding修改）。
若要指定数据库字符集编码为GB18030_2022，且客户端编码也要设置为GB18030时，必须确保客户端操作系统支持的GB18030字符集为2022版本，否则由于GB18030字符集自身的各版本间存在不完全兼容，可能导致数据的不一致性。同时，涉及到历史数据切换为GB18030_2022数据库时应当遵循切库流程，进行数据迁移操作。

LC_COLLATE [ = ] ‘lc_collate‘

指定新数据库使用的字符集。例如，通过lc_collate = ‘zh_CN.gbk’设定该参数。

该参数的使用会影响到对字符串的排序顺序（如使用ORDER BY执行，以及在文本列上使用索引的顺序）。默认是使用模板数据库的字符集。

取值范围：操作系统支持的字符集。

LC_CTYPE [ = ] ‘lc_ctype‘

指定新数据库使用的字符分类。例如，通过lc_ctype = ‘zh_CN.gbk’设定该参数。该参数的使用会影响到字符的分类，如大写、小写和数字。默认是使用模板数据库的字符分类。

取值范围：操作系统支持的字符分类。

对于lc_collate和lc_ctype参数的取值范围，取决于本地环境支持的字符集。例如：在Linux操作系统上，可通过locale -a命令获取操作系统支持的字符集列表，在应用lc_collate和lc_ctype参数时可从中选择用户需要的字符集和字符分类。
当指定的字符编码集为GB18030_2022时，其LC_COLLATE和LC_CTYPE的取值范围与GB18030保持一致。

DBCOMPATIBILITY [ = ] ‘compatibilty_type‘

指定兼容的数据库的类型，默认兼容MySQL。

取值范围：MYSQL、TD、ORA、PG。分别表示兼容MySQL、TD（Teradata）、Oracle和PostgreSQL。

ORA兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。
将字符串转换成整数类型时，如果输入不合法，MYSQL兼容性会将输入转换为0，而其它兼容性则会报错。
PG兼容性下，CHAR和VARCHAR以字符为计数单位，其它兼容性以字节为计数单位。例如，对于UTF-8字符集，CHAR(3)在PG兼容性下能存放3个中文字符，而在其它兼容性下只能存放1个中文字符。
执行语句报错时，部分报错信息中显示“A-format”或“B-format”，“A-format”表示“ORA-format”，“B-format”表示“MYSQL-format”。

TABLESPACE [ = ] tablespace_name

指定数据库对应的表空间。

取值范围：已存在表空间名。

CONNECTION LIMIT [ = ] connlimit

数据库可以接受的并发连接数。

系统管理员不受此参数的限制。
connlimit每个CN单独统计，集群整体的连接数 = connlimit * 当前正常CN节点个数。

取值范围：[-1, 2^31-1]的整数。默认值为-1，表示没有限制。

有关字符编码的一些限制：

若区域设置为C（或POSIX），则允许所有的编码类型，但是对于其他的区域设置，字符编码必须和区域设置相同。
编码和区域设置必须匹配模板数据库，除了将template0当作模板。 因为其他数据库可能会包含不匹配指定编码的数据，或者可能包含排序顺序受LC_COLLATE和LC_CTYPE影响的索引。复制这些数据会导致在新数据库中的索引失效。template0是不包含任何会受到影响的数据或者索引。
DBTIMEZONE [ = ] ‘time_zone‘

指定新数据库的时区。例如，通过DBTIMEZONE = ‘+00:00’设定该参数。该参数会影响新数据库的时区。默认设置为PRC时区。

取值范围：操作系统支持的时区名称和缩写或者-15：59到+15：00时间戳范围。

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

--创建jim和tom用户。
gaussdb=# CREATE USER jim PASSWORD '********';
gaussdb=# CREATE USER tom PASSWORD '********';

--创建一个GBK编码的数据库music（本地环境的编码格式必须也为GBK）。
gaussdb=# CREATE DATABASE music ENCODING 'GBK' template = template0;

--创建数据库music2，并指定所有者为jim。
gaussdb=# CREATE DATABASE music2 OWNER jim;

--用模板template0创建数据库music3，并指定所有者为jim。
gaussdb=# CREATE DATABASE music3 OWNER jim TEMPLATE template0;

--设置music数据库的连接数为10。
gaussdb=# ALTER DATABASE music CONNECTION LIMIT= 10;

--将music名称改为music4。
gaussdb=# ALTER DATABASE music RENAME TO music4;

--将数据库music2的所属者改为tom。
gaussdb=# ALTER DATABASE music2 OWNER TO tom;

--删除数据库。
gaussdb=# DROP DATABASE music2;
gaussdb=# DROP DATABASE music3;
gaussdb=# DROP DATABASE music4;

--删除jim和tom用户。
gaussdb=# DROP USER jim;
gaussdb=# DROP USER tom;

--创建兼容TD格式的数据库。
gaussdb=# CREATE DATABASE td_compatible_db DBCOMPATIBILITY 'TD';

--创建兼容ORA格式的数据库。
gaussdb=# CREATE DATABASE ora_compatible_db DBCOMPATIBILITY 'ORA';

--删除兼容TD、ORA格式的数据库。
gaussdb=# DROP DATABASE td_compatible_db;
gaussdb=# DROP DATABASE ora_compatible_db;

相关链接

ALTER DATABASE，DROP DATABASE

优化建议

create database

事务中不支持创建database。

ENCODING

当新建数据库Encoding与模板数据库（SQL_ASCII）不匹配（为’GBK’ /’UTF8’/’LATIN1’/’GB18030’/’GB18030_2022’）时，必须指定template [=] template0。

父主题： SQL语法

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家