Todos os produtos
Search
Central de documentação

:ExecuteScript

Última atualização: Jul 08, 2026

Executa instruções SQL.

Esta operação está disponível apenas para instâncias gerenciadas no modo Security Collaboration.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

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.