CREATE DATABASE语句用于创建数据库，并可以指定数据库的默认属性（如数据库默认字符集，校验规则等）。

语法

create_database_stmt:
    CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] database_name [database_option_list]

database_option_list:
    database_option [database_option ...]

database_option:
    [DEFAULT] {CHARACTER SET | CHARSET} [=] charset_name
  | [DEFAULT] COLLATE [=] collation_name
  |  LOCALITY=locality_option
  | [MODE = mode_option]
 
locality_option:
    'dn=storage_inst_id_list'

storage_inst_id_list:
    storage_inst_id[,storage_inst_id_list]
    
mode_option:
     {'auto'}
    |{'drds'}

参数说明

参数说明
database_name指定要创建的数据库名称。
CHARSET charset_name指定待创建数据库的字符集。
COLLATE collation_name指定校对规则。
LOCALITY创建数据库时指定该库的存储位置。
说明 通过LOCALITY语法指定了数据库的位置之后，不支持再修改该库的存储位置。
MODE
指定逻辑库所使用的分区模式，支持两种分区模式：
  • drds：DRDS模式，全库只能使用DRDS模式的CREATE TABLE（DRDS模式）语法（如dbpartition by/tbpartition by）进行建表。
  • auto：AUTO模式
    • 不手动指定分区定义时，自动按主键分区；
    • 全库只能使用新的CREATE TABLE（AUTO模式）语法（如partition byhash/Range/List）进行建表。
重要
  • 创建数据库不指定mode，默认是“drds”；
  • 数据库的分区模式不可更改，创建数据库时一旦指定，不能变更。
  • 关于两种分区模式的说明，请参见AUTO模式数据库与DRDS模式数据库。

示例

  • 创建AUTO模式数据库test，并指定字符集为UTF8。
    CREATE DATABASE test MODE=auto default CHARACTER SET UTF8;
Query OK, 1 row affected (0.00 sec)
  • 在实例中创建一个数据库，并通过以下命令指定其存储位置为polardbx-storage-0-master节点。
    CREATE DATABASE db1 MODE=drds LOCALITY='dn=polardbx-storage-0-master';
    说明
    • 如果在创建数据库时未指定数据库的存储位置，系统将默认在所有存储节点中均匀分布数据库。
    • 数据库中分表的存储位置与该库的存储位置保持一致，以实现分表上的数据隔离。
    数据库创建成功后，您可以通过以下语句查看数据库的存储位置信息。
    SHOW CREATE DATABASE db1 MODE=drds;
    返回结果如下所示：
    +----------+------------------------------------------------------------------------+
| DATABASE | CREATE DATABASE                                                        |
+----------+------------------------------------------------------------------------+
| db1      | CREATE DATABASE `db1` /* LOCALITY = "dn=polardbx-storage-0-master" */  |
+----------+------------------------------------------------------------------------+
1 row in set