CREATE DATABASE - PolarDB

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}
  | [{PARTITION_MODE|MODE} = partition_mode_option]
  | [DEFAULT_SINGLE = default_single_option]  
  
locality_option:
    'dn=storage_inst_id_list'

storage_inst_id_list:
    storage_inst_id[,storage_inst_id_list]
    
partition_mode_option:
		 {'auto'|'partitioning'}
    |{'drds'|'sharding'}

default_single_option: 
	{'on'|'off'}

注意事項

標準版不支援dbpartition（分庫分表）文法，僅企業版執行個體支援建立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模式資料庫。
DEFAULT_SINGLE（版本要求：PolarDB-X 5.4.17-16921956及以上）	指定AUTO模式資料庫是否使用單表自動打散至各個DN節點的分布策略，該選項僅對AUTO模式資料庫有效，對DRDS模式資料庫無效。參數取值如下：當DEFAULT_SINGLE = 'on' 時，AUTO模式資料庫建表且不顯式指定分區定義時，預設建單表並自動打散到執行個體的不同的DN節點；當DEFAULT_SINGLE = 'off' 或沒指定值時，AUTO模式資料庫建表且不顯式指定分區定義時，預設按主鍵自動分區。

樣本

建立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