Todos los productos
Search
Centro de documentos

:CREATE DATABASE

Última actualización: Sep 09, 2026

Ejecute la instrucción CREATE DATABASE para crear una base de datos. Durante este proceso, especifique los atributos predeterminados de la base de datos, como el conjunto de caracteres y la intercalación (collation) predeterminados.

Sintaxis

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ámetroDescripción
database_nameNombre de la base de datos cuyos atributos desea modificar mediante la instrucción CREATE DATABASE. Si no especifica este parámetro, se modifican los atributos de la base de datos predeterminada actual.
CHARSET charset_nameConjunto de caracteres de la base de datos que desea crear.
COLLATE collation_nameIntercalación (collation) de la base de datos que desea crear.
LOCALITYUbicación donde desea crear la base de datos.
Nota Una vez que se especifica la ubicación de almacenamiento de una base de datos con la sintaxis LOCALITY, esta ubicación no se puede modificar.
MODE
Modo de particionamiento de la base de datos lógica. Valores válidos:
  • auto/partitioning: la base de datos se particiona con el modo de particionamiento automático.
    • Si no especifica manualmente la definición de particiones, la base de datos se particiona según la clave primaria.
    • En las bases de datos particionadas con este modo, solo se pueden usar las sintaxis más recientes de CREATE TABLE para crear tablas. Por ejemplo: PARTITION BY HASH, PARTITION BY RANGE y PARTITION BY LIST.
  • drds/sharding: la base de datos se particiona con el modo DRDS. En las bases de datos particionadas con este modo, solo se pueden usar las sintaxis de CREATE TABLE (AUTO mode) exclusivas de dicho modo para crear tablas. Por ejemplo: DBPARTITION BY y TBPARTITION BY.
Importante
  • Si no especifica el valor de este parámetro, se usa el valor predeterminado drds/sharding.
  • Una vez que establece un modo de particionamiento para una base de datos, este no se puede cambiar.

Ejemplos

  • Cree una base de datos llamada test y establezca el conjunto de caracteres en UTF-8.

    CREATE DATABASE test default CHARACTER SET=UTF8 mode=auto;
    Query OK, 1 row affected (3.36 sec)                   
  • Cree una base de datos en el nodo polardbx-storage-0-master de una instancia de PolarDB-X.

    CREATE DATABASE db1 LOCALITY='dn=polardbx-storage-0-master';
    Nota
    • Si no especifica la ubicación de una base de datos al crearla, el sistema distribuye uniformemente sus datos entre todos los nodos de almacenamiento.

    • La base de datos y sus fragmentos de tabla deben almacenarse en la misma ubicación. De esta manera, se aíslan los datos de dichos fragmentos.

    Después de crear la base de datos, ejecute a continuación la siguiente instrucción para consultar su ubicación:

    SHOW CREATE DATABASE db1;

    Se devuelve un resultado similar al siguiente:

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