CREATE DATABASE

CREATE DATABASE 语句用于在 TiDB 上创建新数据库。按照 SQL 标准，“数据库”一词在 MySQL 术语中最接近 “schema”。

语法图

CreateDatabaseStmt

CREATE DATABASE - 图1

IfNotExists

CREATE DATABASE - 图2

DBName

CREATE DATABASE - 图3

DatabaseOptionListOpt

CREATE DATABASE - 图4

DatabaseOptionList

CREATE DATABASE - 图5

DatabaseOption

CREATE DATABASE - 图6

PlacementPolicyOption

CREATE DATABASE - 图7

1. CreateDatabaseStmt ::=
2. 'CREATE' 'DATABASE' IfNotExists DBName DatabaseOptionListOpt

4. IfNotExists ::=
5. ( 'IF' 'NOT' 'EXISTS' )?

7. DBName ::=
8. Identifier

10. DatabaseOptionListOpt ::=
11. DatabaseOptionList?

13. DatabaseOptionList ::=
14. DatabaseOption ( ','? DatabaseOption )*

16. DatabaseOption ::=
17. DefaultKwdOpt ( CharsetKw '='? CharsetName | 'COLLATE' '='? CollationName | 'ENCRYPTION' '='? EncryptionOpt )
18. |   DefaultKwdOpt PlacementPolicyOption

20. PlacementPolicyOption ::=
21. "PLACEMENT" "POLICY" EqOpt PolicyName
22. |   "PLACEMENT" "POLICY" (EqOpt | "SET") "DEFAULT"

语法说明

CREATE DATABASE 用于创建数据库，并可以指定数据库的默认属性（如数据库默认字符集、排序规则）。CREATE SCHEMA 跟 CREATE DATABASE 操作效果一样。

1. CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name
2. [create_specification] ...

4. create_specification:
5. [DEFAULT] CHARACTER SET [=] charset_name
6. | [DEFAULT] COLLATE [=] collation_name

当创建已存在的数据库且不指定使用 IF NOT EXISTS 时会报错。

create_specification 选项用于指定数据库具体的 CHARACTER SET 和 COLLATE。目前 TiDB 只支持部分的字符集和排序规则，请参照字符集支持。

示例

1. CREATE DATABASE mynewdatabase;

1. Query OK, 0 rows affected (0.09 sec)

1. USE mynewdatabase;

1. Database changed

1. CREATE TABLE t1 (a int);

1. Query OK, 0 rows affected (0.11 sec)

1. SHOW TABLES;

1. +-------------------------+
2. | Tables_in_mynewdatabase |
3. +-------------------------+
4. | t1                      |
5. +-------------------------+
6. 1 row in set (0.00 sec)

MySQL 兼容性

CREATE DATABASE 语句与 MySQL 完全兼容。如发现任何兼容性差异，请尝试 TiDB 支持资源。

另请参阅