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

Llame al método putRow del SDK de PHP para escribir una sola fila de datos en una tabla de Tablestore.

Antes de empezar

Descripción del método

public function putRow(array $request)

Descripción de parámetros para $request

Nombre	Tipo	Descripción
table_name (obligatorio)	string	Nombre de la tabla.
primary_key (obligatorio)	array	Clave principal, que incluye los nombres y valores de las columnas. Los tipos de columna de clave principal incluyen STRING, INTEGER y BINARY. La cantidad y los tipos de claves principales en la fila deben coincidir con los definidos para la tabla. Si una columna de clave principal es de incremento automático, establezca su valor como marcador de posición. Para obtener más información, consulte Auto-increment primary key column.
attribute_columns (opcional)	array	Columnas de atributos, que incluyen nombres, valores y números de versión. Los tipos de columna de atributos incluyen STRING, INTEGER, BINARY, DOUBLE y BOOLEAN. El número de versión es una marca de tiempo generada automáticamente de forma predeterminada. Para especificar un número de versión manualmente, consulte Data versions and lifecycle.
condition (opcional)	array	Condición para la operación de escritura. Consulte Conditional update.
return_content (opcional)	array	Datos que se devolverán. return_type (obligatorio)`array`: Tipo de retorno. ReturnTypeConst::CONST_NONE (predeterminado): No devuelve datos. ReturnTypeConst::CONST_PK: Devuelve las columnas de clave principal. Utilice esta opción para recuperar valores de clave principal de incremento automático. ReturnTypeConst::CONST_AFTER_MODIFY: Devuelve los valores de columna actualizados. Utilice esta opción para atomic counters.
transaction_id (opcional)	string	ID que identifica de forma única una transacción local. Consulte Local transaction.

Código de ejemplo

A continuación, el ejemplo escribe una fila en la tabla test_table con un valor de clave principal de row1.

$request = array (
    'table_name' => 'test_table',
    // Build the primary key
    'primary_key' => array (
        array('id', 'row1')
    )
);

try{
    // Call putRow to write the row
    $response = $client->putRow($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 "Put Row failed.";
}

Agregue una columna de atributos.

$request['attribute_columns'] = array(
    array('col1', 'val1')
);

Especifique un número de versión. Asigne un número de versión distinto a cada columna de atributos.

$request['attribute_columns'] = array(
    array('col1', 'val1', null, intval(microtime(true) * 1000))
);

Referencias

Batch update data