Écrit plusieurs lignes de données simultanément. Appelez cette opération pour insérer, modifier ou supprimer une ligne de données.
Syntaxe de la requête
message BulkImportRequest {
required string table_name = 1;
repeated RowInBulkImportRequest rows = 2;
}|
Paramètre |
Type |
Obligatoire |
Description |
|
table_name |
string |
Oui |
Nom de la table de données. |
|
rows |
repeated RowInBulkImportRequest |
Oui |
Ligne de données à gérer. |
Syntaxe de la réponse
message BulkImportResponse {
required string table_name = 1;
repeated RowInBulkImportResponse rows = 2;
}|
Paramètre |
Type |
Obligatoire |
Description |
|
table_name |
string |
Oui |
Nom de la table de données. |
|
rows |
repeated RowInBulkImportResponse |
Oui |
Indique si l'opération d'écriture a réussi, le message d'erreur et les unités de capacité (CU) consommées. Pour plus d'informations, consultez la rubrique Débit en lecture et en écriture. |
Utilisation des SDK Tablestore
SDK Tablestore pour Java : Écriture par lot de données hors ligne
Consommation d'unités de capacité (CU)
Si l'opération échoue, aucune CU n'est consommée.
En cas d'expiration du délai de la requête avec des résultats indéfinis, la consommation de CU est incertaine.
Lorsqu'une erreur interne se produit et que le code d'état HTTP 5xx est renvoyé, l'opération ne consomme pas de CU. Pour les autres types d'erreurs, une CU est consommée.
-
Dans les autres cas, RowInBulkImportRequest spécifie les opérations d'insertion, de mise à jour et de suppression. La consommation de CU est calculée indépendamment pour chaque opération effectuée. Les méthodes de calcul des CU consommées lors de l'insertion, de la mise à jour et de la suppression de lignes de données sont décrites ci-dessous.
Lors de l'insertion d'une ligne de données, le nombre de CU d'écriture consommées correspond à l'arrondi supérieur de la valeur obtenue via la formule suivante : (Taille des données dans toutes les colonnes de clé primaire de la ligne + Taille des données dans les colonnes d'attribut insérées) / 4 Ko.
Lors de la mise à jour d'une ligne de données, le nombre de CU d'écriture consommées correspond à l'arrondi supérieur de la valeur obtenue via la formule suivante : (Taille des données dans toutes les colonnes de clé primaire de la ligne + Taille des données dans les colonnes d'attribut mises à jour) / 4 Ko. Si vous souhaitez supprimer une colonne d'attribut lors de la mise à jour d'une ligne, seule la longueur du nom de la colonne est prise en compte dans la taille des données de la colonne d'attribut.
Lors de la suppression d'une ligne de données, le nombre de CU d'écriture consommées correspond à l'arrondi supérieur de la valeur obtenue via la formule suivante : 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 la rubrique Utilisation du stockage.