Exécute des instructions SQL.
Cette opération est disponible uniquement pour les instances gérées en mode Security Collaboration.
Débogage
Paramètres de requête
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | ExecuteScript | Nom de l’opération à effectuer. Définissez la valeur sur ExecuteScript. |
| DbId | Integer | Yes | 123 | ID de la base de données. Remarque Ce paramètre équivaut au paramètre DatabaseId des opérations SearchDatabase, ListDatabases et GetDatabase. Appelez l’une de ces opérations pour obtenir l’ID de base de données requis. Pour plus d’informations, consultez SearchDatabase, ListDatabases et GetDatabase. |
| Logic | Boolean | Yes | false | Indique si la base de données est une base de données logique. |
| Script | String | Yes | select dt from report_daily | Instructions SQL à exécuter. Les instructions DQL (Data Query Language), DDL (Data Definition Language) et DML (Data Manipulation Language) sont prises en charge. Le mode de contrôle de l’instance cible détermine si vous pouvez exécuter des instructions DDL et DML. |
| Tid | Long | No | 234 | ID du locataire. Remarque Pour obtenir l’ID du locataire, placez le pointeur de la souris sur la photo de profil située dans l’angle supérieur droit de la console Data Management (DMS). Pour plus d’informations, consultez Tenant information. |
| RegionId | String | No | cn-hangzhou | Région dans laquelle vous souhaitez appeler cette opération. |
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
|
ErrorCode |
String |
UnknownError |
Code d’erreur. |
|
ErrorMessage |
String |
UnknownError |
Message d’erreur relatif à la passerelle. |
|
RequestId |
String |
FE8EE2F1-4880-46BC-A704-5CF63EAF9A04 |
ID de la requête. |
|
Results |
Array of Result |
Résultats de l’exécution des instructions SQL, présentés sous forme de tableau. Chaque entrée du tableau correspond au résultat d’une instruction SQL. |
|
|
ColumnNames |
List |
["col1", "col2"] |
Champs interrogés après l’exécution de l’instruction SQL. |
|
Message |
String |
UnknownError |
Message d’erreur renvoyé en cas d’échec de l’exécution de l’instruction SQL (par exemple, lorsque l’instruction SQL n’est pas valide). |
|
RowCount |
Long |
1 |
Nombre total d’entrées renvoyées. |
|
Rows |
List |
[{"col1": "value1", "col2":"value2"}] |
Lignes interrogées après l’exécution de l’instruction SQL. |
|
Success |
Boolean |
true |
Indique si l’instruction SQL a été exécutée. |
|
Success |
Boolean |
true |
Indique si la requête a abouti. |
Exemples
Exemple de requête
http(s)://[Endpoint]/? Action=ExecuteScript
&DbId=123
&Logic=false
&Script=select dt from report_daily
&<Common request parameters>
Exemple de réponse en cas de succès
Format XML
<RequestId>FE8EE2F1-4880-46BC-A704-5CF63EAF9A04</RequestId>
<Results>
<Message>UnknownError</Message>
<RowCount>1</RowCount>
<Success>true</Success>
</Results>
<Results>
<ColumnNames>["col1", "col2"]</ColumnNames>
<Rows>[{"col1": "value1", "col2":"value2"}]</Rows>
</Results>
<ErrorCode>UnknownError</ErrorCode>
<ErrorMessage>UnknownError</ErrorMessage>
<Success>true</Success>
Format JSON
{"RequestId":"FE8EE2F1-4880-46BC-A704-5CF63EAF9A04","Results":[{"Message":"UnknownError","RowCount":"1","Success":"true"},{"ColumnNames":"[\"col1\", \"col2\"]","Rows":"[{\"col1\": \"value1\", \"col2\":\"value2\"}]"}],"ErrorCode":"UnknownError","ErrorMessage":"UnknownError","Success":"true"}
Codes d’erreur
Pour obtenir la liste des codes d’erreur, consultez le Centre d’erreurs de l’API.