Todos os produtos
Search
Central de documentação

Tablestore:CreateSearchIndex

Última atualização: Jun 30, 2026

Cria um índice de pesquisa.

Nota

Para obter mais informações sobre índices de pesquisa, consulte Visão geral.

Observações de uso

Antes de criar um índice de pesquisa, verifique se o número máximo de versões da tabela de dados está definido como 1 e se o tempo de vida (TTL) da tabela atende a uma das seguintes condições:

  • O TTL da tabela de dados está definido como -1, o que indica que os dados nunca expiram.

  • O TTL da tabela de dados tem um valor diferente de -1 e as operações de atualização na tabela são proibidas.

Sintaxe da solicitação

message CreateSearchIndexRequest {
    required string table_name = 1;
    required string index_name = 2;
    optional IndexSchema schema = 3;
    optional string source_index_name = 4;
    optional int32 time_to_live = 5; // unit is seconds
}

Parâmetro

Tipo

Obrigatório

Descrição

table_name

string

Sim

Nome da tabela de dados.

index_name

string

Sim

Nome do índice de pesquisa.

schema

IndexSchema

Sim

Esquema do índice de pesquisa.

source_index_name

string

Não

Nome do índice de pesquisa de origem. Esse parâmetro é obrigatório apenas para modifique dinamicamente um esquema.

time_to_live

int32

Não

TTL do índice de pesquisa. O TTL defina o período de retenção dos dados. Valor padrão: -1. Unidade: segundos.

O Tablestore exclui automaticamente os dados expirados quando o período de retenção ultrapassa o valor do parâmetro time_to_live.

O valor mínimo do parâmetro time_to_live é 86400, equivalente a um dia. O valor -1 indica que os dados nunca expiram.

Para obter mais informações sobre o TTL de índices de pesquisa, consulte Especificar o TTL de um índice de pesquisa.

Sintaxe da resposta

message CreateSearchIndexResponse {
}
  • HTTP 200: a chamada foi bem-sucedida.

  • HTTP 400 ou 500: falha na chamada.

    A resposta inclui uma mensagem de erro. Para obter mais informações, consulte Erro.

Usar SDKs do Tablestore

Use os seguintes SDKs do Tablestore para crie um índice de pesquisa: