Actualización de configuraciones de tabla - Tablestore SDK for Go - Tablestore

Utilice el Tablestore SDK for Go para actualizar el TTL, el número máximo de versiones, el desplazamiento máximo de versión, los permisos de actualización, la configuración de Stream y el rendimiento reservado de una tabla.

Requisitos previos

Instale el Tablestore SDK for Go e inicialice el cliente.

Descripción

Llame a UpdateTable para actualizar las propiedades de la tabla, la configuración de Stream o el rendimiento reservado de una tabla. Cada solicitud debe especificar como mínimo un tipo de configuración.

func (tableStoreClient *TableStoreClient) UpdateTable(request *UpdateTableRequest) (*UpdateTableResponse, error)

El siguiente ejemplo actualiza el TTL, el número máximo de versiones, el desplazamiento máximo de versión y los permisos de actualización de la tabla example_table.

request := &tablestore.UpdateTableRequest{
    TableName: "example_table",
    TableOption: &tablestore.TableOption{
        TimeToAlive:               86400,
        MaxVersion:                3,
        DeviationCellVersionInSec: 86400,
        AllowUpdate:               proto.Bool(false),
    },
}

_, err := client.UpdateTable(request)
if err != nil {
    log.Fatal(err)
}

Parámetros

UpdateTableRequest contiene los siguientes parámetros.

Nombre	Tipo	Descripción
TableName (obligatorio)	`string`	El nombre de la tabla.
TableOption (opcional)	`*TableOption`	Las propiedades de la tabla que se actualizarán.
StreamSpec (opcional)	`*StreamSpecification`	La configuración de Stream.
ReservedThroughput (opcional)	`*ReservedThroughput`	El throughput de lectura/escritura reservado. Los valores distintos de cero solo se aplican a instancias de alto rendimiento en modo CU.

Se requiere especificar como mínimo uno de los siguientes: TableOption, StreamSpec o ReservedThroughput.

Opciones de tabla

TableOption contiene los siguientes parámetros.

Nombre	Tipo	Descripción
TimeToAlive (opcional)	`int`	El tiempo de vida (TTL), en segundos. Un valor de `-1` indica que los datos nunca expiran. Para otros valores, el mínimo es `86400` (un día). Los datos expirados se eliminan automáticamente. Para utilizar un índice de búsqueda o un índice secundario, establezca este parámetro en `-1` o configure `AllowUpdate` en `false`.
MaxVersion (opcional)	`int`	El número máximo de versiones que se conservan para cada columna de atributo. Para utilizar un índice de búsqueda o un índice secundario, establezca este parámetro en `1`.
DeviationCellVersionInSec (opcional)	`int64`	El desplazamiento máximo de versión, en segundos. La diferencia entre la marca de tiempo de los datos escritos y la hora actual del sistema debe estar dentro de este intervalo. Las versiones válidas se encuentran en `[max(write time - maximum version offset, write time - TTL), write time + maximum version offset)`.
AllowUpdate (opcional)	`*bool`	Indica si los datos pueden actualizarse al llamar a `UpdateRow`. Si este parámetro se establece en `false`, no se podrán actualizar los datos.

Importante

UpdateFullRow solo puede configurarse al crear una tabla. No puede modificarse llamando a UpdateTable.

Configuración de Stream

StreamSpec es del tipo StreamSpecification y contiene los siguientes parámetros.

Nombre	Tipo	Descripción
EnableStream (obligatorio)	`bool`	Indica si se debe habilitar Stream.
ExpirationTime (opcional)	`int32`	El período de retención de los registros incrementales, en horas. Valor máximo: `168` (siete días). Este parámetro es obligatorio cuando `EnableStream` se establece en `true`. Importante Al modificar el parámetro `ExpirationTime`, también debe establecer `EnableStream` en `true`. De lo contrario, el canal de datos existente dejará de estar available y afectará la sincronización de datos del índice de búsqueda de la tabla.

Rendimiento reservado

ReservedThroughput contiene los siguientes parámetros.

Nombre	Tipo	Descripción
Readcap (opcional)	`int`	El throughput de lectura reservado, en CU. Valor predeterminado: `0`.
Writecap (opcional)	`int`	El throughput de escritura reservado, en CU. Valor predeterminado: `0`.

Ejemplos

Actualización de la configuración de Stream

El siguiente ejemplo habilita Stream para la tabla example_table y establece el período de retención de los registros incrementales en 168 horas.

request := &tablestore.UpdateTableRequest{
    TableName: "example_table",
    StreamSpec: &tablestore.StreamSpecification{
        EnableStream:   true,
        ExpirationTime: 168,
    },
}

_, err := client.UpdateTable(request)
if err != nil {
    log.Fatal(err)
}