📣
TiDB Cloud Premium is now in public preview. Unlimited growth, instant elasticity, advanced security for enterprise workloads. Try it out →

CREATE DATABASE



Create a database.

Syntax

CREATE [ OR REPLACE ] DATABASE [ IF NOT EXISTS ] <database_name> [ OPTIONS ( DEFAULT_STORAGE_CONNECTION = '<connection_name>', DEFAULT_STORAGE_PATH = '<path>' ) ]

Parameters

ParameterDescription
DEFAULT_STORAGE_CONNECTIONThe name of an existing connection (created via CREATE CONNECTION) to use as the default storage connection for tables in this database.
DEFAULT_STORAGE_PATHThe default storage path URI (e.g., s3://bucket/path/) for tables in this database. Must end with / and match the connection's storage type.

Access control requirements

PrivilegeObject TypeDescription
CREATE DATABASEGlobalCreates a database.

To create a database, the user performing the operation or the current_role must have the CREATE DATABASE privilege.

Examples

The following example creates a database named test:

CREATE DATABASE test;

The following example creates a database with a default storage connection and path:

CREATE CONNECTION my_s3 STORAGE_TYPE = 's3' ACCESS_KEY_ID = '<key>' SECRET_ACCESS_KEY = '<secret>'; CREATE DATABASE analytics OPTIONS ( DEFAULT_STORAGE_CONNECTION = 'my_s3', DEFAULT_STORAGE_PATH = 's3://mybucket/analytics/' );

Was this page helpful?