Exporte des données par lots.
Syntaxe de la requête
message BulkExportRequest {
required string table_name = 1;
repeated string columns_to_get = 2;
required bytes inclusive_start_primary_key = 3;
required bytes exclusive_end_primary_key = 4;
optional bytes filter = 5;
optional DataBlockType data_block_type_hint = 6 [default = DBT_SIMPLE_ROW_MATRIX];
}|
Paramètre |
Type |
Obligatoire |
Description |
|
table_name |
string |
Oui |
Nom de la table de données. |
|
columns_to_get |
string |
Non |
Colonnes à exporter. Si vous ne spécifiez pas ce paramètre, toutes les colonnes sont exportées. |
|
inclusive_start_primary_key |
bytes |
Oui |
Clé primaire de début encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. Si la ligne existe, elle est incluse dans la réponse. |
|
exclusive_end_primary_key |
bytes |
Oui |
Clé primaire de fin encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. La ligne n'est pas incluse dans la réponse, qu'elle existe ou non. |
|
filter |
bytes |
Non |
Condition de filtre encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. |
|
data_block_type_hint |
Non |
Type de bloc de données du résultat renvoyé. |
Syntaxe de la réponse
message BulkExportResponse {
required ConsumedCapacity consumed = 1;
required bytes rows = 2;
optional bytes next_start_primary_key = 3;
optional DataBlockType data_block_type = 4;
}|
Paramètre |
Type |
Obligatoire |
Description |
|
consumed |
Oui |
Nombre d'unités de capacité (CU) consommées par l'opération. Pour plus d'informations, consultez Consommation de CU. |
|
|
rows |
bytes |
Oui |
Données de ligne exportées, incluant la clé primaire et les colonnes d'attribut. Les données de ligne sont encodées au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. |
|
next_start_primary_key |
bytes |
Non |
Clé primaire de début pour la prochaine opération de lecture. La clé primaire de début est encodée au format PlainBuffer. Pour plus d'informations, consultez PlainBuffer. Si la valeur de retour est vide, toutes les données ont été lues. |
|
data_block_type |
Non |
Type de bloc de données du résultat renvoyé. |
Utilisation des SDK Tablestore
SDK Tablestore pour Java : Lecture hors ligne des données par lots
Consommation de CU :
Si la ligne demandée n'existe pas, une unité de capacité (CU) de lecture est consommée. Consultez CU pour plus de détails.
Si la ligne demandée existe, le nombre de CU de lecture consommées est arrondi à l'entier supérieur 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 + Taille des données dans les colonnes d'attribut lues) / 4 Ko. Pour plus d'informations sur le calcul de la taille des données, consultez Utilisation du stockage.
En cas d'expiration du délai de la requête avec des résultats indéfinis, des CU peuvent ou non être consommées.
Si un code d'état HTTP 5xx est renvoyé, indiquant une erreur interne, l'opération ne consomme pas de CU. En cas d'autres erreurs, une CU de lecture est consommée.