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

Llame al método putRow del SDK de Node.js para Tablestore. Este método inserta una fila con columnas de clave principal y columnas de atributo opcionales en una tabla de datos.

Requisitos previos

Initialize the Tablestore client

Método

putRow: function putRow(params, callback)

Descripción de los parámetros

Nombre	Tipo	Descripción
tableName (obligatorio)	string	El nombre de la tabla.
primaryKey (obligatorio)	Array	Las columnas de clave principal, incluidos sus nombres y valores. Tipos de datos compatibles: STRING, INTEGER y BINARY. La cantidad y los tipos de las columnas de clave principal deben coincidir con el esquema de la tabla. Si una columna de clave principal es de incremento automático, establezca su valor como un marcador de posición. Para obtener más información, consulte auto-increment primary key column.
attributeColumns (opcional)	Array	Las columnas de atributo, incluidos sus nombres, valores y números de versión. Tipos de datos compatibles: STRING, INTEGER, BINARY, DOUBLE y BOOLEAN. El número de versión es una marca de tiempo que el sistema genera automáticamente de forma predeterminada. También puede especificarlo de manera manual. Para obtener más información, consulte data versions and lifecycle.
condition (obligatorio)	TableStore.Condition	La condición de escritura. Para obtener más información, consulte conditional update.
returnContent (opcional)	object	Los datos que se devuelven. returnType (opcional) `number`: el tipo de retorno. TableStore.ReturnType.NONE (predeterminado): no devuelve ningún dato. TableStore.ReturnType.Primarykey: devuelve las columnas de clave principal. Utilice esta opción para las columnas de clave principal de incremento automático. TableStore.ReturnType.AfterModify: devuelve los valores actualizados de las columnas. Utilice esta opción para atomic counters.
transactionId (opcional)	string	El identificador que distingue de forma única a una transacción local. Para obtener más información, consulte local transaction.

Ejemplos

A continuación se muestra un ejemplo que inserta una fila en la tabla test_table con el valor de clave principal row1.

var params = {
    tableName: 'test_table',
    primaryKey: [{ 'id': 'row1' }],
    // Specify a write condition when writing data. TableStore.RowExistenceExpectation.IGNORE means that the system does not check whether the row exists.
    condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null)
};

client.putRow(params, function (err, data) {
    if (err) {
        console.log('Put 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);
});

Agregue una columna de atributo.

params.attributeColumns = [{ 'col1': 'val1' }];

Especifique un número de versión. Puede asignar un número de versión distinto a cada columna de atributo.
```
params.attributeColumns = [{ 'col1': 'val1', 'timestamp': Date.now() }];
```

Referencias

Batch update data