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 .NET.

Requisitos previos

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

Descripción del método

public UpdateTableResponse UpdateTable(UpdateTableRequest request)

Método asíncrono:

public Task<UpdateTableResponse> UpdateTableAsync(UpdateTableRequest request)

Parámetros de UpdateTableRequest

TableName (obligatorio) string: nombre de la tabla de datos.

TableOptions (opcional) TableOptions: información de configuración de la tabla que incluye los siguientes parámetros.

Parámetro	Tipo	Descripción
TimeToLive (opcional)	int	Tiempo de vida (TTL) de los datos en la tabla, expresado en segundos. El valor predeterminado es -1. 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 usar las funciones de índice de búsqueda o índice secundario, establezca este parámetro en -1 o configure el parámetro AllowUpdate como false.
MaxVersions (opcional)	int	Número máximo de versiones. El valor predeterminado es 1. Para usar las funciones de índice de búsqueda o índice secundario, establezca este parámetro en 1.
DeviationCellVersionInSec (opcional)	long	Desviación máxima de versión en 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á con errores. El rango de versiones válido para los datos de columnas de atributos es `[max(Hora de escritura de datos - Desviación máxima de versión, Hora de escritura de datos - TTL), Hora de escritura de datos + Desviación máxima de versión)`.
AllowUpdate (opcional)	bool	Indica si se permiten actualizaciones. Si establece este parámetro en false, no podrá actualizar datos mediante el método `UpdateRow()`.

StreamSpecification (opcional) StreamSpecification: información de configuración de Stream que incluye los siguientes parámetros.

Parámetro

Tipo

Nota

EnableStream (obligatorio)

bool

Especifica si se habilita Stream.

ExpirationTime (opcional)

int

Tiempo de expiración de Stream, que representa la duración durante la cual se conservan los registros incrementales. La unidad es horas. El valor máximo es 168 (siete días).

Cuando EnableStream se establece en true, debe especificar ExpirationTime.

ReservedThroughput (opcional) CapacityUnit: reserved read and write throughput, en CU. Establezca este parámetro en un valor distinto de cero; la configuración solo surtirá efecto para tablas de datos en instancias de alto rendimiento en modo CU.

Nota

Al llamar al método UpdateTable(), especifique como mínimo uno de los siguientes elementos: TableOptions, StreamSpecification o ReservedThroughput.

Código de ejemplo

try
{
    UpdateTableRequest request = new UpdateTableRequest("test_table");

    // Table configuration information.
    TableOptions tableOptions = new TableOptions();
    // Specify the TTL in seconds.
    tableOptions.TimeToLive = 86400;
    // Specify the maximum number of versions.
    tableOptions.MaxVersions = 3;
    // Specify the maximum version offset in seconds.
    tableOptions.DeviationCellVersionInSec = 86400;
    // Specify whether updates are allowed.
    tableOptions.AllowUpdate = false;
    request.TableOptions = tableOptions;

    // Enable Stream and set the Stream validity period to seven days.
    StreamSpecification streamSpecification = new StreamSpecification(true);
    streamSpecification.ExpirationTime = 168;
    request.StreamSpecification = streamSpecification;

    // Set reserved read throughput to 0 CU and reserved write throughput to 0 CU (you can set this parameter to a non-zero value and the setting takes effect only for data tables in high-performance instances in CU mode).
    CapacityUnit reservedThroughput = new CapacityUnit(0, 0);
    request.ReservedThroughput = reservedThroughput;

    // Call the UpdateTable method to modify the table configurations.
    client.UpdateTable(request);
    Console.WriteLine("Update table succeeded.");
}
catch (Exception ex)
{
    Console.WriteLine($"Update table failed, exception:{ex.Message}");
}