Supprime une ligne de données.
Syntaxe de la requête
message DeleteRowRequest {
required string table_name = 1;
required bytes primary_key = 2; // The primary key is encoded as binary data in the PlainBuffer format.
required Condition condition = 3;
optional ReturnContent return_content = 4;
optional string transaction_id = 5;
}|
Parameter |
Type |
Required |
Description |
|
table_name |
string |
Yes |
Nom de la table de données. |
|
primary_key |
bytes |
Yes |
Clé primaire de la ligne à supprimer. La clé primaire est encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. |
|
condition |
Yes |
Indique s'il faut vérifier l'existence de la ligne avant l'opération sur les données. Valeur par défaut : IGNORE. Valeurs valides :
|
|
|
return_content |
No |
Type de données à renvoyer après l'écriture réussie de la ligne. Seule la clé primaire peut être renvoyée. Ce paramètre est généralement utilisé avec la fonctionnalité de colonne de clé primaire à incrémentation automatique. |
|
|
transaction_id |
string |
No |
ID de la transaction locale. Ce paramètre est obligatoire pour utiliser une transaction locale afin de supprimer des données. |
Syntaxe de la réponse
message DeleteRowResponse {
required ConsumedCapacity consumed = 1;
optional bytes row = 2;
}|
Parameter |
Type |
Description |
|
consumed |
Nombre d'unités de capacité (CU) consommées par l'opération. Pour plus d'informations, consultez Consommation de CU. |
|
|
row |
bytes |
Données renvoyées si vous spécifiez une valeur pour return_content. Si vous ne spécifiez pas de valeur pour return_content ou si aucune valeur de retour n'existe, NULL est renvoyé. Les données renvoyées sont encodées au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. |
Utilisation des SDK Tablestore
Utilisez les SDK Tablestore suivants pour supprimer une seule ligne de données :
SDK Tablestore pour Java : Supprimer une seule ligne de données
SDK Tablestore pour Go : Supprimer une seule ligne de données
SDK Tablestore pour Python : Supprimer une seule ligne de données
SDK Tablestore pour Node.js : Supprimer une seule ligne de données
SDK Tablestore pour .NET : Supprimer une seule ligne de données
SDK Tablestore pour PHP : Supprimer une seule ligne de données
Consommation de CU
-
Si la ligne à supprimer n'existe pas, le nombre de CU consommées varie en fonction de la valeur spécifiée pour le paramètre condition.
Si la valeur du paramètre condition est IGNORE, le nombre de CU d'écriture consommées correspond à la valeur arrondie à l'entier supérieur calculée selon la formule suivante : Nombre de CU d'écriture consommées = Taille des données dans toutes les colonnes de clé primaire de la ligne / 4 Ko.
Si la valeur du paramètre condition est EXPECT_EXIST, la suppression de la ligne échoue. Une CU d'écriture et une CU de lecture sont consommées.
-
Si la ligne à supprimer existe, le nombre de CU consommées varie en fonction de la valeur spécifiée pour le paramètre condition.
Si la valeur du paramètre condition est IGNORE, le nombre de CU d'écriture consommées correspond à la valeur arrondie à l'entier supérieur calculée selon la formule suivante : Nombre de CU d'écriture consommées = Taille des données dans toutes les colonnes de clé primaire de la ligne / 4 Ko.
Si la valeur du paramètre condition est EXPECT_EXIST, des CU d'écriture et de lecture sont consommées. Le nombre de CU d'écriture consommées correspond à la valeur arrondie à l'entier supérieur calculée selon la formule suivante : Nombre de CU d'écriture consommées = Taille des données dans toutes les colonnes de clé primaire de la ligne / 4 Ko. Le nombre de CU de lecture consommées correspond à la valeur arrondie à l'entier supérieur calculée selon la formule suivante : Nombre de CU de lecture consommées = Taille des données dans toutes les colonnes de clé primaire de la ligne / 4 Ko.
Pour plus d'informations sur le calcul de la taille des données, consultez Présentation de la facturation.
Si la requête expire et que les résultats sont indéfinis, des CU peuvent ou non être consommées.
Si un code d'état HTTP 5xx est renvoyé, indiquant qu'une erreur interne s'est produite, l'opération ne consomme pas de CU. Si d'autres erreurs sont renvoyées, une CU d'écriture est consommée.