Todos os produtos
Search
Central de documentação

Tablestore:CreateTable

Última atualização: Sep 22, 2026

Crie uma tabela de dados com base no esquema especificado.

Observações de uso

  • Após criar uma tabela de dados, não execute operações de leitura e gravação imediatamente. Na maioria dos casos, a tabela fica disponível para leitura e gravação um minuto após a criação.

  • Uma única instância suporta até 64 tabelas. Para criar mais tabelas em uma única instância, envie um ticket.

Sintaxe da solicitação

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

Obrigatório

Descrição

table_meta

TableMeta

Sim

O esquema da tabela de dados. Configure os seguintes parâmetros:

Importante

Não modifique o esquema da tabela de dados após a criação.

  • table_name: o nome da tabela de dados. O nome da tabela deve ser exclusivo na instância.

  • primary_key: as informações da chave primária. Uma chave primária pode conter de uma a quatro colunas. O nome de cada coluna deve seguir as convenções de nomenclatura, e os tipos de dados devem ser STRING, INTEGER ou BINARY. Para mais informações sobre convenções de nomenclatura e tipos de dados, consulte Naming conventions and data types.

  • defined_Columns: as informações das colunas predefinidas. Para usar um índice secundário em uma tabela de dados, adicione colunas predefinidas à tabela durante a criação. Colunas predefinidas são colunas não primárias definidas com tipos de dados específicos. Após adicionar uma coluna predefinida, use-a como coluna de atributo ou coluna de chave de índice de uma tabela de índice. Também é possível adicionar colunas predefinidas após a criação da tabela. Para mais informações, consulte Use predefined columns.

reserved_throughput

ReservedThroughput

Sim

O throughput de leitura ou gravação reservado da tabela de dados. O throughput reservado de leitura ou gravação de uma tabela de dados não pode exceder 100.000. Unidade: capacity unit (CU).

Chame a operação UpdateTable para alterar o throughput de leitura ou gravação reservado de uma tabela de dados.

table_options

TableOptions

Não

Os parâmetros da tabela, incluindo time_to_live e max_versions.

partitions

PartitionRange

Não

O intervalo de partição da tabela de dados.

stream_spec

StreamSpecification

Não

Define se os atributos relacionados ao Stream devem ser ativados.

sse_spec

SSESpecification

Não

As configurações de criptografia da tabela de dados.

index_metas

IndexMeta

Não

O esquema da tabela de índice.

enable_local_txn

bool

Não

Define se o recurso de transação local para a tabela de dados deve ser ativado. Valor padrão: false.

Para executar operações atômicas de leitura ou gravação em uma ou mais linhas de dados, ative o recurso de transação local para a tabela de dados.

Sintaxe da resposta

message CreateTableResponse {
}

Usar SDKs do Tablestore

Use os seguintes SDKs do Tablestore para criar uma tabela de dados com base no esquema especificado: