ALTER DATABASE

ALTER DATABASE is used to specify or modify the default character set and collation of the current database. ALTER SCHEMA has the same effect as ALTER DATABASE.

Synopsis

AlterDatabaseStmt

DatabaseOption

AlterDatabaseStmt ::=
    'ALTER' 'DATABASE' DBName? DatabaseOptionList
DatabaseOption ::=
    DefaultKwdOpt ( CharsetKw '='? CharsetName | 'COLLATE' '='? CollationName | 'ENCRYPTION' '='? EncryptionOpt )

Examples

Modify the test database schema to use the utf8mb4 character set:

ALTER DATABASE test DEFAULT CHARACTER SET = utf8mb4;

Query OK, 0 rows affected (0.00 sec)

Currently, TiDB only supports some character sets and collations. See Character Set and Collation Support for details.

MySQL compatibility

The ALTER DATABASE statement in TiDB is fully compatible with MySQL. If you find any compatibility differences, report a bug.

See also

• CREATE DATABASE
• SHOW DATABASES