Interroge les données à l'aide d'instructions SQL.
Syntaxe de la requête
message SQLQueryRequest {
required string query = 1;
optional SQLPayloadVersion version = 2;
optional int64 sql_version = 3;
}|
Paramètre |
Type |
Obligatoire |
Description |
|
query |
string |
Oui |
L'instruction SQL. |
|
version |
Non |
Le format d'encodage des données renvoyées. |
|
|
sql_version |
int64 |
Non |
La version du protocole SQL. Valeurs possibles :
|
Syntaxe de la réponse
message SQLQueryResponse {
repeated TableConsumedCapacity consumes = 1;
optional bytes rows = 2;
optional SQLPayloadVersion version = 3;
optional SQLStatementType type = 4;
}|
Paramètre |
Type |
Obligatoire |
Description |
|
consumes |
repeated TableConsumedCapacity |
Oui |
Nombre d'unités de capacité (CU) consommées par l'opération. Pour plus d'informations, consultez la section Consommation de CU. |
|
rows |
bytes |
Non |
Données de ligne renvoyées. La valeur est encodée selon le format spécifié. |
|
version |
Oui |
Format d'encodage des données renvoyées. |
|
|
type |
Oui |
Type d'instructions SQL. |
Utiliser les SDK Tablestore
SDK Tablestore pour Java : Requête SQL
SDK Tablestore pour Go : Requête SQL
SDK Tablestore pour Python : Requête SQL
SDK Tablestore pour Node.js : Requête SQL
SDK Tablestore pour .NET : Requête SQL
SDK Tablestore pour PHP : Requête SQL
Consommation de CU
L'utilisation de la fonctionnalité de requête SQL est gratuite. Toutefois, son utilisation engendre des frais liés aux opérations telles que l'analyse de table et les requêtes basées sur des index.
Le débit de lecture consommé lors de l'exécution d'une seule instruction SQL correspond à la somme du débit de lecture consommé par les opérations spécifiques effectuées sur la table et l'index. 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.
Si la requête expire et que les résultats sont indéfinis, la consommation de CU est incertaine.
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.