Todos os produtos
Search
Central de documentação

Tablestore:TableOptions

Última atualização: Jul 03, 2026

TableOptions define configurações no nível da tabela, incluindo retenção de dados (TTL), número máximo de versões e restrições de desvio 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 de dados em segundos. O Tablestore exclui automaticamente dados que ultrapassam esse período.

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

max_versions

int32

Não

Número máximo de versões retidas por coluna de atributo. O Tablestore remove automaticamente as versões mais antigas ao exceder esse limite.

deviation_cell_version_in_sec

int64

Não

Desvio máximo de versão em segundos. A solicitação de gravação só é bem-sucedida se o número de versão (timestamp) de cada coluna estiver dentro desse desvio em relação à hora atual do sistema.

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

allow_update

bool

Não

Indica se a operação UpdateRow é permitida nesta tabela. Valor padrão: true.

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

update_full_row

bool

Não

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

Defina este parâmetro como true quando forem necessárias atualizações de dados e o recurso de TTL do índice de pesquisa ou o recurso de tabela global estiverem ativados. Mantenha allow_update com o valor padrão true.