CREATE DATABASE

This statement creates a new database in TiDB. The MySQL terminology for 'database' most closely maps to a schema in the SQL standard.

Synopsis

CreateDatabaseStmt:

CreateDatabaseStmt

DatabaseSym:

DatabaseSym

IfNotExists:

IfNotExists

DBName:

DBName

DatabaseOptionListOpt:

DatabaseOptionListOpt

Syntax

The CREATE DATABASE statement is used to create a database, and to specify the default properties of the database, such as the default character set and validation rules. CREATE SCHEMA is a synonym for CREATE DATABASE.

CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name [create_specification] ... create_specification: [DEFAULT] CHARACTER SET [=] charset_name | [DEFAULT] COLLATE [=] collation_name

If you create an existing database and does not specify IF NOT EXISTS, an error is displayed.

The create_specification option is used to specify the specific CHARACTER SET and COLLATE in the database. Currently, the option is only supported in syntax.

Examples

mysql> CREATE DATABASE mynewdatabase; Query OK, 0 rows affected (0.09 sec) mysql> USE mynewdatabase; Database changed mysql> CREATE TABLE t1 (a int); Query OK, 0 rows affected (0.11 sec) mysql> SHOW TABLES; +-------------------------+ | Tables_in_mynewdatabase | +-------------------------+ | t1 | +-------------------------+ 1 row in set (0.00 sec)

MySQL compatibility

This statement is understood to be fully compatible with MySQL. Any compatibility differences should be reported via an issue on GitHub.

See also