Todos os produtos
Search
Central de documentação

Tablestore:Atualizar as configurações de uma tabela

Última atualização: Jul 03, 2026

Este tópico descreve como atualizar as configurações de uma tabela com o Tablestore SDK for PHP.

Pré-requisitos

Inicialize um cliente. Para mais informações, consulte Inicializar um cliente Tablestore.

Descrição do método

public function updateTable(array $request)

Descrição do parâmetro $request

  • table_name (obrigatório) string: Nome da tabela de dados.

  • table_options (opcional) object: Informações de configuração da tabela. Inclui os seguintes parâmetros:

    Parâmetro

    Tipo

    Descrição

    time_to_live (opcional)

    int

    Tempo de vida (TTL) dos dados na tabela. Unidade: segundos.

    • Se definido como -1, os dados nunca expiram. Caso contrário, o valor mínimo é 86400 (um dia). O sistema exclui automaticamente os dados cujo período de retenção exceda o TTL.

    • Para usar recursos de índice de pesquisa ou índice secundário, defina este parâmetro como -1 ou defina allow_update como false.

    max_versions (opcional)

    int

    Número máximo de versões.

    • Para usar recursos de índice de pesquisa ou índice secundário, defina este parâmetro como 1.

    deviation_cell_version_in_sec (opcional)

    int

    Desvio máximo de versão. Unidade: segundos.

    • A diferença entre a hora atual do sistema e o timestamp dos dados gravados deve estar dentro do intervalo de desvio máximo de versão. Caso contrário, a gravação falhará.

    • O intervalo de versão válido para dados de coluna de atributo é [max(Data written time - Maximum version offset, Data written time - TTL), Data written time + Maximum version offset).

    allow_update (opcional)

    bool

    Indica se atualizações são permitidas.

    • Se definido como false, não é possível atualizar dados com o método updateRow().

  • stream_spec (opcional) object: Informações de configuração do Stream. Inclui os seguintes parâmetros:

    Parâmetro

    Tipo

    Descrição

    enable_stream (opcional)

    bool

    Indica se o Stream deve ser ativado.

    enable_stream (opcional)

    int

    Tempo de expiração do Stream. Indica a duração de retenção dos logs incrementais. Unidade: horas. O valor máximo é 168 (7 dias).

    • Se enable_stream for true, especifique expiration_time.

  • reserved_throughput (opcional) object: Throughput de leitura e gravação reservado, em CU. Defina este parâmetro com um valor diferente de zero apenas para instâncias de alto desempenho no modo CU.

Nota

Ao chamar o método updateTable(), especifique pelo menos um dos parâmetros table_options ou stream_spec.

Ao especificar table_options, defina pelo menos um dos parâmetros time_to_live, max_versions, deviation_cell_version_in_sec ou allow_update.

Código de exemplo

O exemplo a seguir mostra como modifique as configurações da tabela test_table.

$request = array (
    'table_name' => 'test_table',
    'table_options' => array (
        'time_to_live' => 86400,
        'max_versions' => 3,
        'deviation_cell_version_in_sec' => 86400,
        'allow_update' => false
    ), 
     'stream_spec' => array (
        'enable_stream' => true,
        'expiration_time' => 168
     ),
    'reserved_throughput' => array (
        'capacity_unit' => array (
            'read' => 0,
            'write' => 0
        )
    )
);

try{
    $client->updateTable( $request );
    echo "Update table succeeded.";
} catch (Exception $e) {
    echo "Update table failed.";
}