Todos los productos
Search
Centro de documentos

Tablestore:CreateTable

Última actualización: Sep 22, 2026

Cree una tabla de datos con base en el esquema especificado.

<!--@div {"id":"refbody_0k9_lec_qq8","data-tag="refbody"}-->

Notas de uso

  • Después de crear una tabla de datos, no es posible ejecutar operaciones de lectura y escritura de inmediato. En la mayoría de los casos, estas operaciones se habilitan un minuto después de crear la tabla.

  • Se pueden crear hasta 64 tablas en una sola instancia. Si necesita crear más tablas en una misma instancia, envíe un ticket.

Sintaxis de la solicitud

message CreateTableRequest {
    required TableMeta table_meta = 1;
    required ReservedThroughput reserved_throughput = 2; 
    optional TableOptions table_options = 3;
    repeated PartitionRange partitions = 4;
    optional StreamSpecification stream_spec = 5;
    optional SSESpecification sse_spec = 6;
    repeated IndexMeta index_metas = 7;
    optional bool enable_local_txn = 8;
}

Parámetro

Tipo

Obligatorio

Descripción

table_meta

TableMeta

Sí

El esquema de la tabla de datos. Configure los siguientes parámetros:

Importante

Una vez creada la tabla de datos, no es posible modificar su esquema.

  • table_name: el nombre de la tabla de datos. Debe ser único dentro de la instancia.

  • primary_key: la información de la clave primaria. Una clave primaria puede contener de una a cuatro columnas. El nombre de cada columna debe cumplir con las convenciones de nomenclatura y sus tipos de datos deben ser STRING, INTEGER o BINARY. Para obtener más información sobre las convenciones de nomenclatura y los tipos de datos, consulte Naming conventions and data types.

  • defined_Columns: la información de las columnas predefinidas. Si desea usar un índice secundario para una tabla de datos, debe agregarle columnas predefinidas al momento de crearla. Estas columnas son aquellas que no forman parte de la clave primaria y se definen previamente con tipos de datos específicos. Después de agregar una columna predefinida, puede utilizarla como columna de atributo o como columna de clave de índice en una tabla de índices. También es posible agregar columnas predefinidas una vez creada la tabla de datos. Para obtener más información, consulte Use predefined columns.

reserved_throughput

ReservedThroughput

Sí

El throughput reservado de lectura o escritura de la tabla de datos. Este valor no puede superar los 100,000. Unidad: capacity unit (CU).

Para cambiar el throughput reservado de lectura o escritura, llame a la operación UpdateTable.

table_options

TableOptions

No

Los parámetros de la tabla, que incluyen time_to_live y max_versions.

partitions

PartitionRange

No

El rango de partición de la tabla de datos.

stream_spec

StreamSpecification

No

Especifica si se habilitan los atributos relacionados con Stream.

sse_spec

SSESpecification

No

La configuración de cifrado de la tabla de datos.

index_metas

IndexMeta

No

El esquema de la tabla de índices.

enable_local_txn

bool

No

Especifica si se habilita la función de transacción local para la tabla de datos. Valor predeterminado: false.

Habilite esta función cuando necesite ejecutar operaciones atómicas para leer o escribir una o varias filas de datos.

Sintaxis de la respuesta

message CreateTableResponse {
}

Uso de los SDK de Tablestore

A continuación se muestran los SDK de Tablestore con los que puede crear una tabla de datos según el esquema especificado: