Tablestore Node.js SDK: Write a single row of data - Tablestore: Central de Documentação do Alibaba Cloud

Use o método putRow do SDK do Tablestore para Node.js para inserir uma linha com colunas de chave primária e colunas de atributo opcionais em uma tabela de dados.

Pré-requisitos

Inicializar o cliente do Tablestore

Método

putRow: function putRow(params, callback)

Descrição dos parâmetros

Nome	Tipo	Descrição
tableName (obrigatório)	string	Nome da tabela.
primaryKey (obrigatório)	Array	Colunas de chave primária, incluindo nomes e valores. Tipos de dados compatíveis: STRING, INTEGER e BINARY. A quantidade e os tipos das colunas de chave primária devem corresponder ao esquema da tabela. Se uma coluna de chave primária for de incremento automático, defina seu valor como um espaço reservado. Para mais informações, consulte coluna de chave primária de incremento automático.
attributeColumns (opcional)	Array	Colunas de atributo, contendo nomes, valores e números de versão. Tipos de dados compatíveis: STRING, INTEGER, BINARY, DOUBLE e BOOLEAN. O número de versão é um timestamp gerado automaticamente pelo sistema por padrão, mas você também pode especificá-lo manualmente. Para mais detalhes, consulte versões de dados e ciclo de vida.
condition (obrigatório)	TableStore.Condition	Condição de gravação. Para mais informações, consulte atualização condicional.
returnContent (opcional)	object	Dados a retornar. returnType (opcional) `number`: Tipo de retorno. TableStore.ReturnType.NONE (padrão): Não retorna dados. TableStore.ReturnType.Primarykey: Retorna as colunas de chave primária. Use esta opção para colunas de chave primária de incremento automático. TableStore.ReturnType.AfterModify: Retorna os valores das colunas atualizadas. Use esta opção para contadores atômicos.
transactionId (opcional)	string	ID que identifica exclusivamente uma transação local. Para mais informações, consulte transação local.

Exemplos

O exemplo a seguir insere uma linha na tabela test_table com o valor de chave primária 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);
});

Adicione uma coluna de atributo.

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

Especifique um número de versão. Você pode atribuir um número de versão distinto a cada coluna de atributo.
```
params.attributeColumns = [{ 'col1': 'val1', 'timestamp': Date.now() }];
```

Referências

Atualizar dados em lote