Tablestore PHP SDK: Write a single row of data - Tablestore - Centre de documentation Alibaba Cloud

Avant de commencer

Description de la méthode

public function putRow(array $request)

Description des paramètres pour $request

Nom	Type	Description
table_name (obligatoire)	string	Nom de la table.
primary_key (obligatoire)	array	Clé primaire, incluant les noms et les valeurs des colonnes. Les types de colonnes de clé primaire sont STRING, INTEGER et BINARY. Le nombre et les types de clés primaires de la ligne doivent correspondre à ceux définis pour la table. Si une colonne de clé primaire est une colonne d'incrémentation automatique, définissez sa valeur comme un espace réservé. Pour plus d'informations, consultez Colonne de clé primaire d'incrémentation automatique.
attribute_columns (facultatif)	array	Colonnes d'attribut, incluant les noms, les valeurs et les numéros de version. Les types de colonnes d'attribut sont STRING, INTEGER, BINARY, DOUBLE et BOOLEAN. Le numéro de version est un horodatage généré automatiquement par défaut. Pour spécifier manuellement un numéro de version, consultez Versions des données et cycle de vie.
condition (facultatif)	array	Condition de l'opération d'écriture. Consultez 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. Utilisez cette option pour récupérer les valeurs des clés primaires d'incrémentation automatique. ReturnTypeConst::CONST_AFTER_MODIFY : Renvoie les valeurs mises à jour des colonnes. Utilisez cette option pour les compteurs atomiques.
transaction_id (facultatif)	string	ID identifiant de manière unique une transaction locale. Consultez Transaction locale.

Exemple de code

L'exemple suivant écrit une ligne dans la table test_table avec une valeur de clé primaire 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.";
}

Ajoutez une colonne d'attribut.

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

Spécifiez un numéro de version. Attribuez un numéro de version distinct à chaque colonne d'attribut.

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

Références

Mettre à jour les données par lot