Tablestore PHP SDK: Update a single row of data - Tablestore

Utilisez le SDK PHP pour mettre à jour les valeurs des colonnes d'attribut, ajouter des colonnes d'attribut, supprimer une version spécifique d'une colonne d'attribut ou supprimer entièrement une colonne d'attribut dans une table de données Tablestore.

Avant de commencer

Initialiser le client Tablestore

Méthode

public function updateRow(array $request)

Description du paramètre $request

Nom	Type	Description
table_name (obligatoire)	string	Nom de la table de données.
primary_key (obligatoire)	array	Clé primaire de la ligne, incluant les noms et les valeurs des colonnes. Types de données pris en charge : STRING, INTEGER et BINARY. Le nombre et les types de clés primaires doivent correspondre au schéma de la table.
update_of_attribute_columns (obligatoire)	array	Colonnes d'attribut à mettre à jour. Opérations prises en charge : PUT (ajouter ou mettre à jour une valeur de colonne), DELETE (supprimer une version spécifique) et DELETE_ALL (supprimer une colonne entière).
condition (obligatoire)	array	Condition de mise à jour. Pour plus d'informations, consultez la section mise à jour conditionnelle.
return_content (facultatif)	array	Données à renvoyer. return_type (obligatoire)`array` : Type de retour. ReturnTypeConst::CONST_NONE (par défaut) : Ne renvoie aucune donnée. ReturnTypeConst::CONST_PK : Renvoie les colonnes de clé primaire. ReturnTypeConst::CONST_AFTER_MODIFY : Renvoie les valeurs des colonnes après modification. Utilisez cette option pour les compteurs atomiques.
transaction_id (facultatif)	string	ID de la transaction locale. Pour plus d'informations, consultez la section transactions locales.

Exemples

L'exemple suivant met à jour la ligne dont la valeur de clé primaire est row1 dans la table test_table, en définissant la colonne d'attribut col1 sur 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.";
}

Vous pouvez également utiliser les extraits de code suivants pour d'autres opérations de mise à jour.

Ajouter une colonne d'attribut.

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

Définir le numéro de version pour une colonne d'attribut.

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

Supprimer une version spécifique d'une colonne d'attribut.

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

Supprimer toutes les versions d'une colonne d'attribut.

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

Références

Mettre à jour les données par lot