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

Use el SDK de PHP para actualizar los valores de las columnas de atributos, agregar columnas de atributos, eliminar una versión específica de una columna de atributos o eliminar por completo una columna de atributos en una tabla de datos de Tablestore.

Antes de empezar

Initialize the Tablestore client

Método

public function updateRow(array $request)

Descripción del parámetro $request

Nombre	Tipo	Descripción
table_name (obligatorio)	string	El nombre de la tabla de datos.
primary_key (obligatorio)	array	La clave principal de la fila, que incluye los nombres y los valores de las columnas. Tipos de datos compatibles: STRING, INTEGER y BINARY. La cantidad y los tipos de claves principales deben coincidir con el esquema de la tabla.
update_of_attribute_columns (obligatorio)	array	Las columnas de atributos por actualizar. Operaciones compatibles: PUT (agregar o actualizar el valor de una columna), DELETE (eliminar una versión específica) y DELETE_ALL (eliminar una columna completa).
condition (obligatorio)	array	La condición de actualización. Para obtener más información, consulte conditional update.
return_content (opcional)	array	Los datos que se devuelven. return_type (obligatorio)`array`: el tipo de retorno. ReturnTypeConst::CONST_NONE (predeterminado): no devuelve datos. ReturnTypeConst::CONST_PK: devuelve las columnas de la clave principal. ReturnTypeConst::CONST_AFTER_MODIFY: devuelve los valores de las columnas después de la modificación. Use esta opción para atomic counters.
transaction_id (opcional)	string	El identificador de la transacción local. Para obtener más información, consulte local transactions.

Ejemplos

A continuación se muestra un ejemplo que actualiza la fila cuyo valor de clave principal es row1 en la tabla test_table. En este caso, se establece la columna de atributos col1 con el valor 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.";
}

También puede usar los siguientes fragmentos de código para otras operaciones de actualización.

Agregue una columna de atributos.

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

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

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

Elimine una versión específica de una columna de atributos.

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

Elimine todas las versiones de una columna de atributos.

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

Referencias

Batch update data