Todos los productos
Search

Este producto

    Tablestore:UpdateTable

    Centro de documentos

    Tablestore:UpdateTable

    Última actualización: Sep 03, 2026

    Puede llamar a la operación UpdateTable para modificar la información de configuración especificada por el parámetro table_options y las configuraciones de Stream especificadas por el parámetro StreamSpecification de una tabla de datos. Si una tabla de datos se encuentra en una instancia de alto rendimiento en modo CU (anteriormente modo de pago por uso), también puede modificar el throughput reservado de lectura o escritura especificado por el parámetro reserved_throughput de dicha tabla. El nuevo throughput reservado de lectura o escritura entra en vigor en un plazo de 1 minuto después de una actualización exitosa.

    Modo CU (anteriormente modo de pago por uso)

    Sintaxis de la solicitud

    message UpdateTableRequest {
    required string table_name = 1;
    optional ReservedThroughput reserved_throughput = 2;
    optional TableOptions table_options = 3;
    optional StreamSpecification stream_spec = 4;
}

    Parámetro

    Tipo

    Obligatorio

    Descripción

    table_name

    string

    Sí

    Nombre de la tabla de datos cuyo throughput reservado de lectura o escritura desea modificar.

    reserved_throughput

    ReservedThroughput

    No

    Nuevo throughput reservado de lectura o escritura de la tabla de datos. Este valor entra en vigor en un plazo de 1 minuto después de una actualización exitosa.

    Debe especificar un valor no nulo para el throughput reservado de lectura o escritura mediante el parámetro capacity_unit. De lo contrario, la solicitud fallará y se devolverá un error.

    table_options

    TableOptions

    No

    Configuración del tiempo de vida (TTL) y el número máximo de versiones.

    StreamSpecification

    StreamSpecification

    No

    Información de Stream sobre la tabla de datos, que incluye si la función Stream está habilitada y el periodo de validez de los registros.

    Sintaxis de la respuesta

    message UpdateTableResponse {
    required ReservedThroughputDetails reserved_throughput_details = 1;
    required TableOptions table_options = 2;
    optional StreamDetails stream_details = 3;
}

    Parámetro

    Tipo

    Descripción

    capacity_unit_details

    ReservedThroughputDetails

    Configuración del throughput reservado de lectura o escritura de la tabla de datos tras una actualización exitosa. Incluye el valor más reciente del throughput reservado, la hora de la última actualización y el número de reducciones realizadas durante el día actual.

    Nota

    • El intervalo mínimo para actualizar el throughput reservado de lectura o escritura de una tabla de datos es de 2 minutos. Si llama nuevamente a la operación UpdateTable antes de que transcurran 2 minutos desde la llamada anterior, la operación fallará.

    • El throughput reservado de lectura o escritura de una tabla de datos puede aumentarse o reducirse un número ilimitado de veces dentro de un mismo día (de 00:00:00 a 00:00:00 del día siguiente, en hora UTC).

    table_options

    TableOptions

    Valor más reciente del parámetro table_options después de la actualización.

    stream_details

    StreamDetails

    Información de Stream sobre la tabla de datos, que incluye si la función Stream está habilitada, el periodo de validez de los registros y la última vez que se habilitó dicha función.

    Uso de los SDK de Tablestore

    Puede utilizar los siguientes SDK de Tablestore para actualizar una tabla de datos: