Todos os produtos
Search
Central de documentação

Tablestore:Atualizar uma única linha de dados

Última atualização: Jun 30, 2026

Use updateRow no SDK do Tablestore para Node.js para modifique valores de colunas de atributo, adicionar colunas de atributo, exclua uma versão específica ou remover uma coluna de atributo inteira.

Pré-requisitos

Inicializar um cliente do Tablestore

Método

updateRow: function updateRow(params, callback)

Parâmetros

Nome

Tipo

Descrição

tableName (Obrigatório)

string

Nome da tabela de dados.

primaryKey (Obrigatório)

Array

Nomes e valores das colunas de chave primária.

  • Os tipos de dados das colunas de chave primária podem ser STRING, INTEGER ou BINARY.

  • A quantidade e os tipos de chaves primárias devem corresponder aos da tabela de dados.

updateOfAttributeColumns (Obrigatório)

Array

Colunas de atributo a atualize e o tipo de operação.

condition (Obrigatório)

TableStore.Condition

Condição de atualização. Para mais informações, consulte Atualização condicional.

returnContent (Opcional)

object

Dados a retornar.

  • returnType (Opcional) number: Tipo de retorno.

    • TableStore.ReturnType.NONE: Valor padrão. Nenhum dado é retornado.

    • TableStore.ReturnType.Primarykey: Retorna as colunas de chave primária.

    • TableStore.ReturnType.AfterModify: Retorna os valores das colunas após a atualização. Usado 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 altera a coluna de atributo col1 para changed_val1 na linha com chave primária row1, na tabela 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);
});

Você também pode realizar as seguintes operações na linha:

  • Adicionar uma coluna de atributo.

    params.updateOfAttributeColumns = [
        { 'PUT': [{ 'col2': 'val2' }] }
    ]
  • Defina o número de versão de uma coluna de atributo.

    params.updateOfAttributeColumns = [
        { 'PUT': [{ 'col2': 'val2', 'timestamp': Date.now() }] }
    ]
  • Exclua dados de uma versão específica de uma coluna de atributo.

    params.updateOfAttributeColumns = [
        { 'DELETE': [{ 'col2': TableStore.Long.fromNumber(1496826473186) }] },
    ]
  • Exclua todos os dados de uma coluna de atributo.

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

Referências

Atualize dados em lote