Todos os produtos
Search
Central de documentação

Tablestore:TableOptions

Última atualização: Sep 22, 2026

TableOptions define as configurações em nível de tabela, incluindo retenção de dados (TTL), número máximo de versões e restrições de deslocamento de versão.

Estrutura de dados

message TableOptions {
    optional int32 time_to_live = 1; 
    optional int32 max_versions = 2; 
    optional int64 deviation_cell_version_in_sec = 5; 
    optional bool allow_update = 6;
    optional bool update_full_row = 7;
}

Parâmetro

Tipo

Obrigatório

Descrição

time_to_live

int32

Não

Período de retenção dos dados, em segundos. O Tablestore exclui automaticamente os dados que excedem esse período.

Valores válidos: um inteiro maior ou igual a 86400 (um dia) ou -1 (os dados nunca expiram).

max_versions

int32

Não

Número máximo de versões que uma coluna de atributo pode reter. Quando esse limite é excedido, o Tablestore exclui automaticamente as versões mais antigas.

deviation_cell_version_in_sec

int64

Não

Deslocamento máximo de versão, em segundos. Uma solicitação de gravação só é bem-sucedida quando o número da versão (timestamp) de cada coluna está dentro desse deslocamento em relação ao horário atual do sistema.

Intervalo de timestamp válido para uma coluna de atributo: [max{write_time - max_version_offset, write_time - TTL}, write_time + max_version_offset).

allow_update

bool

Não

Indica se esta tabela permite a operação UpdateRow. Valor padrão: true.

Defina este parâmetro como false quando a tabela não exigir atualizações de dados e o recurso TTL do índice de pesquisa estiver ativado.

update_full_row

bool

Não

Indica se UpdateRow substitui a linha inteira ou apenas as colunas especificadas. Valor padrão: false (atualiza somente as colunas especificadas).

Defina este parâmetro como true quando a tabela exigir atualizações de dados e o recurso TTL do índice de pesquisa ou o recurso de tabela global estiver ativado. Mantenha allow_update com o valor padrão true.