Actualizar una sola fila de datos - Tablestore - Centro de documentación de Alibaba Cloud

Llame a updateRow en el SDK de Node.js para Tablestore para modifique los valores de las columnas de atributos, agregar columnas de atributos, eliminar una versión específica o eliminar una columna de atributos completa.

Requisitos previos

Initialize a Tablestore client

Método

updateRow: function updateRow(params, callback)

Parameters

Nombre	Tipo	Descripción
tableName (obligatorio)	string	Nombre de la tabla de datos.
primaryKey (obligatorio)	Array	Nombres y valores de las columnas de clave principal. Los tipos de datos de las columnas de clave principal pueden ser STRING, INTEGER o BINARY. La cantidad y los tipos de claves principales deben coincidir con los de la tabla de datos.
updateOfAttributeColumns (obligatorio)	Array	Columnas de atributos por actualizar y tipo de operación.
condition (obligatorio)	TableStore.Condition	Condición de actualización. Para obtener más información, consulte Conditional update.
returnContent (opcional)	object	Datos que se devolverán. returnType (opcional) `number`: Tipo de retorno. TableStore.ReturnType.NONE: Valor predeterminado. No se devuelven datos. TableStore.ReturnType.Primarykey: Devuelve las columnas de clave principal. TableStore.ReturnType.AfterModify: Devuelve los valores de las columnas después de la actualización. Se utiliza para atomic counters.
transactionId (opcional)	string	ID que identifica de forma única una transacción local. Para obtener más información, consulte Local transaction.

Ejemplos

En el siguiente ejemplo se cambia la columna de atributos col1 a changed_val1 para la fila cuya clave principal es row1 en la tabla test_table.

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }],
    // An update condition is required to update a row. TableStore.RowExistenceExpectation.IGNORE means that the row existence is not checked.
    condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null)
};
params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col1': 'changed_val1' }] }
]

client.updateRow(params, function (err, data) {
    if (err) {
        console.log('Update row failed with error:', err);
        return;
    }
    console.log('RequestId: ', data.RequestId);
    console.log('Read CU Cost: ', data.consumed.capacityUnit.read);
    console.log('Write CU Cost: ', data.consumed.capacityUnit.write);
});

También puede realizar las siguientes operaciones en la fila:

Agregar una columna de atributos.

params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col2': 'val2' }] }
]

Establezca el número de versión de una columna de atributos.

params.updateOfAttributeColumns = [
    { 'PUT': [{ 'col2': 'val2', 'timestamp': Date.now() }] }
]

Eliminar datos de una versión específica de una columna de atributos.

params.updateOfAttributeColumns = [
    { 'DELETE': [{ 'col2': TableStore.Long.fromNumber(1496826473186) }] },
]

Eliminar todos los datos de una columna de atributos.

params.updateOfAttributeColumns = [
    { 'DELETE_ALL': ['col2'] }
]

Referencias

Batch update data