Actualización de la configuración de una tabla - Tablestore - Centro de documentación de Alibaba Cloud

Este tema describe cómo actualizar la configuración de una tabla mediante el SDK de Tablestore para PHP.

Requisitos previos

Se requiere un cliente inicializado. Para obtener más información, consulte Initialize a Tablestore client.

Descripción del método

public function updateTable(array $request)

Descripción del parámetro $request

table_name (obligatorio) string: Nombre de la tabla de datos.

table_options (opcional) object: Información de configuración de la tabla, que incluye los siguientes parámetros.

Parámetro	Tipo	Descripción
time_to_live (opcional)	int	Tiempo de vida (TTL) de los datos en la tabla de datos. Unidad: segundos. Si establece este parámetro en -1, los datos nunca caducan. De lo contrario, el valor mínimo es 86400 (un día). Los datos cuyo periodo de retención exceda el TTL se eliminarán automáticamente. Para utilizar las funciones de índice de búsqueda o índice secundario, debe establecer este parámetro en -1 o configurar el parámetro allow_update como false.
max_versions (opcional)	int	Número máximo de versiones. Para utilizar las funciones de índice de búsqueda o índice secundario, debe establecer este parámetro en 1.
deviation_cell_version_in_sec (opcional)	int	Desviación máxima de versión. Unidad: segundos. La diferencia entre la hora actual del sistema y la marca de tiempo de los datos escritos debe encontrarse dentro del rango de desviación máxima de versión. De lo contrario, la escritura de datos fallará. El rango de versiones válido para los datos de columnas de atributos es `[max(Data written time - Maximum version offset, Data written time - TTL), Data written time + Maximum version offset)`.
allow_update (opcional)	bool	Especifica si se permiten actualizaciones. Si establece este parámetro en false, no podrá actualizar datos mediante el método `updateRow()`.

stream_spec (opcional) object: Información de configuración de Stream, que incluye los siguientes parámetros.

Parámetro

Tipo

Descripción

enable_stream (opcional)

bool

Especifica si se debe habilitar Stream.

enable_stream (opcional)

int

Tiempo de caducidad de Stream, que indica la duración durante la cual se conservan los registros incrementales. Unidad: horas. El valor máximo es 168 (7 días).

Si establece enable_stream en true, debe especificar expiration_time.

reserved_throughput (opcional) object: reserved read and write throughput, en CU. Solo puede establecer este parámetro en un valor distinto de cero para instancias de alto rendimiento en modo CU.

Nota

Al llamar al método updateTable(), debe especificar como mínimo uno de los parámetros table_options o stream_spec.

Cuando especifique table_options, debe indicar como mínimo uno de los parámetros time_to_live, max_versions, deviation_cell_version_in_sec o allow_update.

Código de ejemplo

A continuación se muestra un código de ejemplo que demuestra cómo modificar la información de configuración de la tabla 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.";
}