Skip to main content

CREATE DATABASE

Description​

This statement is used to create a new database

Syntax​

CREATE DATABASE [IF NOT EXISTS] <db_name>
[PROPERTIES ("<key>"="<value>"[, ... ])];

Required parameters​

** 1. <db_name>**

Database Name

Optional parameters​

** 1. <PROPERTIES>**

Additional information about this database

Permission Control​

The user executing this SQL command must have at least the following permissions:

PermissionsObjectNotes
CREATE_PRIVCorresponding databaseYou need to have the create permission for the corresponding database

Precautions​

If you want to specify the default replica distribution strategy for the table under db, you need to specify <replication_allocation> (the <replication_allocation> attribute of table has a higher priority than db):

PROPERTIES (
"replication_allocation" = "tag.location.default:3"
)

Example​

  • Create a new database db_test

    CREATE DATABASE db_test;
  • Create a new database and set the default replica distribution:

    CREATE DATABASE `db_test`
    PROPERTIES (
    "replication_allocation" = "tag.location.group_1:3"
    );