CREATE DATABASE

功能描述

DATABASE与SCHEMA相同，此语句创建一个新的SCHEMA。

注意事项

• 只有拥有CREATEDB权限的用户才可以创建新数据库，系统管理员默认拥有此权限。
• 在创建数据库过程中，出现类似“Permission denied”的错误提示，可能是由于文件系统上数据目录的权限不足。出现类似“No space left on device”的错误提示，可能是由于磁盘满引起的。

语法格式

CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] database_name [AUTHORIZATION role_id]
    [[create_option] [,...]]
create_option: [DEFAULT] {
    CHARACTER SET [=] default_charset
  | CHAR SET [=] default_charset
  | CHARSET [=] default_charset
  | COLLATE [=] default_collation
}

参数说明

• database_name

  数据库名称。

  取值范围：字符串，要符合标识符说明。

• AUTHORIZATION role_id

  可选。指定创建相应数据库的所有者。缺省时，新数据库的所有者是当前用户。

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

• COLLATE [=] collation_name

  可选。指定新数据库使用的字符集。例如，通过collate = 'zh_CN.gbk'设定该参数。

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

  取值范围：参考库级字符集和字符序。

• {CHAR SET | CHARSET | CHARACTER SET} [=] charset_name

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

  取值范围：参考库级字符集和字符序。

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

• 若区域设置为C（或POSIX），则允许所有的编码类型，但是对于其他的区域设置，字符编码必须和区域设置相同。
• 若字符编码方式是SQL_ASCII，并且修改者为管理员用户时，则字符编码可以和区域设置不相同。
• 编码和区域设置必须匹配模板数据库，除了将template0当作模板。 因为其他数据库可能会包含不匹配指定编码的数据，或者可能包含排序顺序受LC_COLLATE和LC_CTYPE影响的索引。复制这些数据会导致在新数据库中的索引失效。template0是不包含任何会受到影响的数据或者索引。

示例

--创建并切换至测试数据库。
m_db=# CREATE DATABASE test1;
m_db=# USE test1;
--创建表a。
m_db=# CREATE TABLE a(id int);
m_db=# DROP TABLE a;
--删除DATABASE test1。
m_db=# USE public;
m_db=# DROP DATABASE test1;

相关链接

ALTER DATABASE，DROP DATABASE

优化建议

• create database

  事务中不支持创建database。

• ENCODING LC_COLLATE LC_CTYPE

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