# CREATE DATABASE #### 功能描述 创建一个新的数据库。缺省情况下新数据库将通过复制标准系统数据库template0来创建，且仅支持使用template0来创建。 #### 注意事项 - 只有拥有CREATEDB权限的用户才可以创建新数据库，系统管理员默认拥有此权限。 - 不能在事务块中执行创建数据库语句。 - 在创建数据库过程中，出现类似"Permission denied"的错误提示，可能是由于文件系统上数据目录的权限不足。出现类似"No space left on device"的错误提示，可能是由于磁盘满引起的。 #### 语法格式 ``` CREATE DATABASE database_name [ [ WITH ] { [ OWNER [=] user_name ] | [ TEMPLATE [=] template ] | [ ENCODING [=] 'encoding' ] | [ LC_COLLATE [=] 'lc_collate' ] | [ LC_CTYPE [=] 'lc_ctype' ] | [ DBCOMPATIBILITY [=] 'compatibility_type' ] | [ TABLESPACE [=] tablespace_name ] | [ CONNECTION LIMIT [=] connlimit ] | [ DBTIMEZONE [=] 'time_zone']}[...] ]; ``` #### 参数说明 - **database_name** 数据库名称。 取值范围：字符串，要符合[标识符命名规范](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0327.html#ZH-CN_TOPIC_0000002235339153__zh-cn_topic_0000002235101877_section1257443811315)。 - **OWNER \[ = \] user_name** 数据库所有者。缺省时，新数据库的所有者是当前用户。 取值范围：已存在的用户名。 - **TEMPLATE \[ = \] template** 模板名。即从哪个模板创建新数据库。GaussDB采用从模板数据库复制的方式来创建新的数据库。初始时，GaussDB包含两个模板数据库template0、template1，以及一个默认的用户数据库postgres。 取值范围：仅template0。 - **ENCODING \[ = \] 'encoding'** 指定数据库使用的字符编码，可以是字符串（如'SQL_ASCII'）、整数编号。 不指定时，默认使用模板数据库的编码。模板数据库template0和template1的编码默认与操作系统环境相关。template1不允许修改字符编码，因此若要变更编码，请使用template0创建数据库。 常用取值：GBK、UTF8、Latin1、GB18030等，具体支持的字符集如下。 表1GaussDB字符集 | **名称** | **描述** | **语言** | **是否服务器端？** | **ICU（International Components for Unicode）?** | **字节/字符** | **别名** | |:---|:---|:---|:---|:---|:---|:---| | BIG5 | Big Five | 繁体中文 | 否 | 否 | 1-2 | WIN950, Windows950 | | EUC_CN | 扩展UNIX编码-中国 | 简体中文 | 是 | 是 | 1-3 | - | | EUC_JP | 扩展UNIX编码-日本 | 日文 | 是 | 是 | 1-3 | - | | EUC_JIS_2004 | 扩展UNIX编码-日本, JIS X 0213 | 日文 | 是 | 否 | 1-3 | - | | EUC_KR | 扩展UNIX编码-韩国 | 韩文 | 是 | 是 | 1-3 | - | | EUC_TW | 扩展UNIX编码-中国台湾 | 繁体中文 | 是 | 是 | 1-3 | - | | GB18030 | 国家标准 | 中文 | 是 | 否 | 1-4 | - | | GB18030_2022 | 国家标准 | 中文 | 是 | 否 | 1-4 | - | | GBK | 扩展国家标准 | 简体中文 | 是 | 否 | 1-2 | WIN936, Windows936 | | ISO_8859_5 | ISO 8859-5, ECMA 113 | 拉丁语/西里尔语 | 是 | 是 | 1 | - | | ISO_8859_6 | ISO 8859-6, ECMA 114 | 拉丁语/阿拉伯语 | 是 | 是 | 1 | - | | ISO_8859_7 | ISO 8859-7, ECMA 118 | 拉丁语/希腊语 | 是 | 是 | 1 | - | | ISO_8859_8 | ISO 8859-8, ECMA 121 | 拉丁语/希伯来语 | 是 | 是 | 1 | - | | JOHAB | JOHAB | 韩语 | 否 | 否 | 1-3 | - | | KOI8R | KOI8-R | 西里尔语（俄语） | 是 | 是 | 1 | KOI8 | | KOI8U | KOI8-U | 西里尔语（乌克兰语） | 是 | 是 | 1 | - | | LATIN1 | ISO 8859-1, ECMA 94 | 西欧 | 是 | 是 | 1 | ISO88591 | | LATIN2 | ISO 8859-2, ECMA 94 | 中欧 | 是 | 是 | 1 | ISO88592 | | LATIN3 | ISO 8859-3, ECMA 94 | 南欧 | 是 | 是 | 1 | ISO88593 | | LATIN4 | ISO 8859-4, ECMA 94 | 北欧 | 是 | 是 | 1 | ISO88594 | | LATIN5 | ISO 8859-9, ECMA 128 | 土耳其语 | 是 | 是 | 1 | ISO88599 | | LATIN6 | ISO 8859-10, ECMA 144 | 日耳曼语 | 是 | 是 | 1 | ISO885910 | | LATIN7 | ISO 8859-13 | 波罗的海 | 是 | 是 | 1 | ISO885913 | | LATIN8 | ISO 8859-14 | 凯尔特语 | 是 | 是 | 1 | ISO885914 | | LATIN9 | ISO 8859-15 | 带欧罗巴和口音的LATIN1 | 是 | 是 | 1 | ISO885915 | | LATIN10 | ISO 8859-16, ASRO SR 14111 | 罗马尼亚语 | 是 | 否 | 1 | ISO885916 | | MULE_INTERNAL | Mule内部编码 | 多语种编辑器 | 是 | 否 | 1-4 | - | | SJIS | Shift JIS | 日语 | 否 | 否 | 1-2 | Mskanji, ShiftJIS, WIN932, Windows932 | | SHIFT_JIS_2004 | Shift JIS, JIS X 0213 | 日语 | 否 | 否 | 1-2 | - | | SQL_ASCII | 未指定（见文本） | ***任意*** | 是 | 否 | 1 | - | | UHC | 统一韩语编码 | 韩语 | 否 | 否 | 1-2 | WIN949, Windows949 | | UTF8 | Unicode, 8-bit | ***所有*** | 是 | 是 | 1-4 | Unicode | | WIN866 | Windows CP866 | 西里尔语 | 是 | 是 | 1 | ALT | | WIN874 | Windows CP874 | 泰语 | 是 | 否 | 1 | - | | WIN1250 | Windows CP1250 | 中欧 | 是 | 是 | 1 | - | | WIN1251 | Windows CP1251 | 西里尔语 | 是 | 是 | 1 | WIN | | WIN1252 | Windows CP1252 | 西欧 | 是 | 是 | 1 | - | | WIN1253 | Windows CP1253 | 希腊语 | 是 | 是 | 1 | - | | WIN1254 | Windows CP1254 | 土耳其语 | 是 | 是 | 1 | - | | WIN1255 | Windows CP1255 | 希伯来语 | 是 | 是 | 1 | - | | WIN1256 | Windows CP1256 | 阿拉伯语 | 是 | 是 | 1 | - | | WIN1257 | Windows CP1257 | 波罗的海 | 是 | 是 | 1 | - | | WIN1258 | Windows CP1258 | 越南语 | 是 | 是 | 1 | ABC, TCVN, TCVN5712, VSCII | ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/caution_3.0-zh-cn.png) - 需要注意并非所有的客户端API都支持上面列出的字符集。 - SQL_ASCII设置与其他设置表现存在差异。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码，因为这个声明会忽略编码。在大多数情况下，如果使用了任何非ASCII数据，那么请不要使用SQL_ASCII进行设置，因为数据库将无法转换或者校验非ASCII字符。 ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) - 指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。 - 当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z\[\\\]\^_\`a-z{\|}重叠。其中@\[\\\]\^_'{\|}是数据库中的操作符，直接作为对象名时，会语法报错。例如"侤"字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII"@"符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。 - 若客户端编码为A，服务器端编码为B，则需要满足数据库中存在编码格式A与B的转换。数据库能够支持的所有的编码格式转换详见系统表[PG_CONVERSION](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0853.html#ZH-CN_TOPIC_0000002235460001)（若无法转换，则建议客户端编码与服务器端编码保持一致，客户端编码可通过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'设定该参数。该参数的使用会影响到字符的分类，如大写、小写和数字。默认是使用模板数据库的字符分类。 取值范围：操作系统支持的字符分类。 ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - 对于lc_collate和lc_ctype参数的取值范围，取决于本地环境支持的字符集。例如：在Linux操作系统上，可通过locale -a命令获取操作系统支持的字符集列表，在应用lc_collate和lc_ctype参数时可从中选择用户需要的字符集和字符分类。 - 当指定的字符编码集为GB18030_2022时，其LC_COLLATE和LC_CTYPE的取值范围与GB18030保持一致。 - **DBCOMPATIBILITY \[ = \] 'compatibility_type** **'** 指定兼容的数据库的类型，默认兼容O。 取值范围：A、B、C、PG。分别表示兼容O、MY、TD和POSTGRES。 ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) - A兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。 - 将字符串转换成整数类型时，如果输入不合法，B兼容性会将输入转换为0，而其它兼容性则会报错。 - PG兼容性下，CHAR和VARCHAR以字符为计数单位，其它兼容性以字节为计数单位。例如，对于UTF-8字符集，CHAR(3)在PG兼容性下能存放3个中文字符，而在其它兼容性下只能存放1个中文字符。 - **TABLESPACE \[ = \] tablespace_name** 指定数据库对应的表空间。 取值范围：已存在表空间名。 - **CONNECTION LIMIT \[ = \] connlimit** 数据库可以接受的并发连接数。 ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) - 系统管理员不受此参数的限制。 - connlimit数据库主节点单独统计，数据库整体的连接数 = connlimit \* 当前正常数据库主节点个数。 取值范围：\[-1, 2\^31-1\]的整数。默认值为-1，表示没有限制。 有关字符编码的一些限制： - 若区域设置为C（或POSIX），则允许所有的编码类型，但是对于其他的区域设置，字符编码必须和区域设置相同。 - 若字符编码方式是SQL_ASCII，并且修改者为管理员用户时，则字符编码可以和区域设置不相同。 - 编码和区域设置必须匹配模板数据库，除了将template0当作模板。 因为其他数据库可能会包含不匹配指定编码的数据，或者可能包含排序顺序受LC_COLLATE和LC_CTYPE影响的索引。复制这些数据会导致在新数据库中的索引失效。template0是不包含任何会受到影响的数据或者索引。 - **DBTIMEZONE \[ = \] 'time_zone'** 指定新数据库的时区。例如，通过DBTIMEZONE = '+00:00'设定该参数。该参数会影响新数据库的时区。默认设置为PRC时区。 取值范围：操作系统支持的时区名称和缩写或者-15：59到+15：00时间戳范围。 #### 示例 ``` --创建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; --设置music3的表空间为PG_DEFAULT。 gaussdb=# ALTER DATABASE music3 SET TABLESPACE PG_DEFAULT; --关闭在数据库music3上缺省的索引扫描。 gaussdb=# ALTER DATABASE music3 SET enable_indexscan TO off; --重置enable_indexscan参数。 gaussdb=# ALTER DATABASE music3 RESET enable_indexscan; --删除数据库。 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 'C'; --创建兼容A格式的数据库。 gaussdb=# CREATE DATABASE ora_compatible_db DBCOMPATIBILITY 'A'; --删除兼容TD、A格式的数据库。 gaussdb=# DROP DATABASE td_compatible_db; gaussdb=# DROP DATABASE ora_compatible_db; ``` #### 相关链接 [ALTER DATABASE](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0470.html#ZH-CN_TOPIC_0000002235459149)，[DROP DATABASE](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0580.html#ZH-CN_TOPIC_0000002235459433) #### 优化建议 - **create database** 事务中不支持创建database。 - **ENCODING** **LC_COLLATE** **LC_CTYPE** 当新建数据库Encoding与模板数据库（SQL_ASCII）不匹配（为'GBK' /'UTF8'/'LATIN1'/'GB18030'/'GB18030_2022'）时，必须指定template \[=\] template0。