Executa instruções SQL.
Esta operação está disponível apenas para instâncias gerenciadas no modo Security Collaboration.
Depuração
Parâmetros de solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | ExecuteScript | Operação a ser executada. Defina o valor como ExecuteScript. |
| DbId | Integer | Sim | 123 | ID do banco de dados. Nota Este parâmetro equivale ao parâmetro DatabaseId nas operações SearchDatabase, ListDatabases e GetDatabase. Chame uma dessas operações para obter o ID do banco de dados necessário. Para mais informações, consulte SearchDatabase, ListDatabases e GetDatabase. |
| Logic | Boolean | Sim | false | Indica se o banco de dados é lógico. |
| Script | String | Sim | select dt from report_daily | Instruções SQL a serem executadas. Há suporte para instruções DQL (linguagem de consulta de dados), DDL (linguagem de definição de dados) e DML (linguagem de manipulação de dados). A execução de instruções DDL e DML depende do modo de controle da instância consultada. |
| Tid | Long | Não | 234 | ID do locatário. Nota Para obter o ID do locatário, passe o mouse sobre a foto de perfil no canto superior direito do console Data Management (DMS). Para mais informações, consulte Informações do locatário. |
| RegionId | String | Não | cn-hangzhou | Região onde a operação será chamada. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
ErrorCode |
String |
UnknownError |
Código de erro. |
|
ErrorMessage |
String |
UnknownError |
Mensagem de erro do gateway. |
|
RequestId |
String |
FE8EE2F1-4880-46BC-A704-5CF63EAF9A04 |
ID da solicitação. |
|
Results |
Array of Result |
Resultados das instruções SQL executadas, em formato de array. Cada entrada representa o resultado de uma instrução SQL. |
|
|
ColumnNames |
List |
["col1", "col2"] |
Campos retornados após a execução da instrução SQL. |
|
Message |
String |
UnknownError |
Mensagem de erro retornada caso a execução da instrução SQL falhe. Por exemplo, quando a instrução SQL é inválida. |
|
RowCount |
Long |
1 |
Número total de entradas retornadas. |
|
Rows |
List |
[{"col1": "value1", "col2":"value2"}] |
Linhas retornadas após a execução da instrução SQL. |
|
Success |
Boolean |
true |
Indica se a instrução SQL foi executada. |
|
Success |
Boolean |
true |
Indica se a solicitação foi bem-sucedida. |
Exemplos
Exemplos de solicitações
http(s)://[Endpoint]/? Action=ExecuteScript
&DbId=123
&Logic=false
&Script=select dt from report_daily
&<Common request parameters>
Exemplos de respostas de sucesso
Formato 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>
Formato 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"}
Códigos de erro
Para obter uma lista de códigos de erro, visite o API Error Center.