Todos os produtos
Search
Central de documentação

:CRIE DATABASE

Última atualização: Jul 04, 2026

Execute a instrução CREATE DATABASE para criar um banco de dados. Durante a criação, especifique os atributos padrão do banco de dados, como o conjunto de caracteres e a collation padrão.

Sintaxe

create_database_stmt:
    CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] database_name [database_option_list]

database_option_list:
    database_option [database_option ...]

database_option:
    [DEFAULT] {CHARACTER SET | CHARSET} [=] charset_name
  | [DEFAULT] COLLATE [=] collation_name
  |  LOCALITY = locality_option
  | [{PARTITION_MODE|MODE} = partition_mode_option]

locality_option:
    'dn=storage_inst_id_list'

storage_inst_id_list:
    storage_inst_id[,storage_inst_id_list]

partition_mode_option:
     {'auto'|'partitioning'}
    |{'drds'|'sharding'}

Parâmetros

ParâmetroDescrição
database_nameNome do banco de dados cujos atributos serão modificados pela instrução CREATE DATABASE. Se você não especificar esse parâmetro, o sistema modificará os atributos do banco de dados padrão atual.
CHARSET charset_nameConjunto de caracteres do banco de dados a ser criado.
COLLATE collation_nameCollation do banco de dados a ser criado.
LOCALITYLocal onde criar o banco de dados.
Nota Após definir o local de armazenamento de um banco de dados com a sintaxe LOCALITY, não é possível alterar esse local.
MODE
Modo de particionamento do banco de dados lógico. Valores válidos:
  • auto/partitioning: particiona o banco de dados no modo automático.
    • Sem definição manual de partição, o sistema particiona o banco de dados com base na chave primária.
    • Nesse modo, use apenas as versões mais recentes da sintaxe CREATE TABLE para criar tabelas. Exemplos: PARTITION BY HASH, PARTITION BY RANGE e PARTITION BY LIST.
  • drds/sharding: particiona o banco de dados no modo DRDS. Nesse modo, use apenas a sintaxe CREATE TABLE (modo AUTO) específica para criar tabelas. Exemplos: DBPARTITION BY e TBPARTITION BY.
Importante
  • Se você não especificar o valor desse parâmetro, o sistema usará o valor padrão drds/sharding.
  • Não é possível alterar o modo de particionamento após defini-lo para um banco de dados.

Exemplos

  • Crie um banco de dados chamado test e defina o conjunto de caracteres como UTF-8.

    CREATE DATABASE test default CHARACTER SET=UTF8 mode=auto;
    Query OK, 1 row affected (3.36 sec)                   
  • Crie um banco de dados no nó polardbx-storage-0-master de uma instância PolarDB-X.

    CREATE DATABASE db1 LOCALITY='dn=polardbx-storage-0-master';
    Nota
    • Se você não especificar o local durante a criação, o sistema distribuirá os dados uniformemente entre todos os nós de armazenamento.

    • O banco de dados e seus shards de tabela devem residir no mesmo local para garantir o isolamento dos dados nos shards.

    Após criar o banco de dados, execute a seguinte instrução para consultar o local:

    SHOW CREATE DATABASE db1;

    O resultado será semelhante ao exemplo abaixo:

    +----------+------------------------------------------------------------------------+
    | DATABASE | CREATE DATABASE                                                        |
    +----------+------------------------------------------------------------------------+
    | db1      | CREATE DATABASE `db1` /* LOCALITY = "dn=polardbx-storage-0-master" */  |
    +----------+------------------------------------------------------------------------+
    1 row in set