SDK PHP do Tablestore: Atualizar uma única linha de dados - Tablestore: Central de Documentação do Alibaba Cloud

Use o SDK PHP para atualizar valores de colunas de atributos, adicionar colunas de atributos, excluir uma versão específica de uma coluna de atributos ou remover uma coluna de atributos inteira em uma tabela de dados do Tablestore.

Antes de começar

Inicializar o cliente do Tablestore

Método

public function updateRow(array $request)

Descrição dos parâmetros de $request

Nome	Tipo	Descrição
table_name (obrigatório)	string	Nome da tabela de dados.
primary_key (obrigatório)	array	Chave primária da linha, incluindo nomes e valores das colunas. Tipos de dados compatíveis: STRING, INTEGER e BINARY. A quantidade e os tipos de chaves primárias devem corresponder ao esquema da tabela.
update_of_attribute_columns (obrigatório)	array	Colunas de atributos a atualizar. Operações compatíveis: PUT (adicionar ou atualizar o valor de uma coluna), DELETE (excluir uma versão específica) e DELETE_ALL (excluir uma coluna inteira).
condition (obrigatório)	array	Condição de atualização. Para mais informações, consulte atualização condicional.
return_content (opcional)	array	Dados a retornar. return_type (obrigatório)`array`: Tipo de retorno. ReturnTypeConst::CONST_NONE (padrão): Não retorna dados. ReturnTypeConst::CONST_PK: Retorna as colunas de chave primária. ReturnTypeConst::CONST_AFTER_MODIFY: Retorna os valores das colunas após a modificação. Use esta opção para contadores atômicos.
transaction_id (opcional)	string	ID da transação local. Para mais informações, consulte transações locais.

Exemplos

O exemplo a seguir atualiza a linha com valor de chave primária row1 na tabela test_table e define a coluna de atributo col1 como changed_val1.

$request = array(
    'table_name' => 'test_table',
    // Build the primary key
    'primary_key' => array(
        array('id', 'row1')
    ),
    // Specify the update condition when updating a row.
    // RowExistenceExpectationConst::CONST_IGNORE means skip row existence checking.
    'condition' => RowExistenceExpectationConst::CONST_IGNORE
);
// Attribute columns to update
$request['update_of_attribute_columns'] = array(
    'PUT' => array(
        array('col1', 'changed_val1')
    )
);

try {
    // Call the updateRow method to update the row
    $response = $client->updateRow($request);
    echo "* Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";   
} catch (Exception $e) {
    echo "Update Row failed.";
}

Você também pode usar os trechos a seguir para outras operações de atualização.

Adicionar uma coluna de atributo.

$request['update_of_attribute_columns'] = array(
    'PUT' => array(
        array('col2', 'val2')
    )
);

Definir o número de versão de uma coluna de atributo.

$request['update_of_attribute_columns'] = array(
    'PUT' => array(
        array('col2', 'val2', null, intval(microtime(true) * 1000))
    )
);

Excluir uma versão específica de uma coluna de atributo.

$request['update_of_attribute_columns'] = array(
    'DELETE' => array(
        array('col2', 1754285998447)
    )
);

Excluir todas as versões de uma coluna de atributo.

$request['update_of_attribute_columns'] = array(
    'DELETE_ALL' => array('col2')
);

Referências

Atualizar dados em lote