Todos os produtos
Search
Central de documentação

Database Autonomy Service:GetFullRequestSampleByInstanceId

Última atualização: Jun 28, 2026

Consulta instruções SQL de amostra nos dados do SQL Explorer de uma instância de banco de dados por ID de SQL. Você pode consultar até 20 instruções SQL de amostra.

Descrição da operação

O recurso SQL Explorer permite verificar o status de integridade das instruções SQL e solucionar problemas de desempenho. Para obter mais informações, consulte SQL Explorer.

  • Para obter mais informações sobre os mecanismos de banco de dados que suportam o SQL Explorer, consulte SQL Explorer.

  • Se você usar um SDK para chamar operações de API do DAS, deverá definir o ID da região como cn-shanghai.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hdm:GetFullRequestSampleByInstanceId

get

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

UserId

string

Não

O ID da conta Alibaba Cloud usada para criar a instância de banco de dados.

Nota

Este parâmetro é opcional. O sistema pode obter automaticamente o ID da conta com base no valor de InstanceId ao chamar esta operação.

196278346919****

InstanceId

string

Sim

O ID da instância.

rm-2ze8g2am97624****

SqlId

string

Sim

O ID da instrução SQL.

651b56fe9418d48edb8fdf0980ec****

Start

integer

Sim

O início do intervalo de tempo a ser consultado. Defina este parâmetro como um timestamp UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC.

Nota

O horário de início deve estar dentro da duração de armazenamento do recurso SQL Explorer da instância de banco de dados e pode ser de até 90 dias antes do horário atual.

1660097421000

End

integer

Sim

O fim do intervalo de tempo a ser consultado. Defina este parâmetro como um timestamp UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC.

Nota

O horário de término deve ser posterior ao horário de início. O intervalo entre o horário de início e o horário de término deve ser igual ou superior a 1 hora.

1660104621000

Role

string

Não

A função do nó do PolarDB-X 2.0. Valores válidos:

  • polarx_cn: nó de computação.

  • polarx_en: nó de dados.

polarx_cn

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

Message

string

A mensagem retornada.

Nota

Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro que contém informações como um código de erro será retornada.

Successful

RequestId

string

O ID da solicitação.

0A74B755-98B7-59DB-8724-1321B394****

Data

array<object>

Os dados retornados.

object

Timestamp

integer

O horário em que a instrução SQL foi executada. Este valor é um timestamp UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC.

1660100753556

SqlId

string

O ID da instrução SQL.

651b56fe9418d48edb8fdf0980ec****

Sql

string

A instrução SQL de amostra.

select * from testdb01 where ****

Database

string

O nome do banco de dados.

dbtest

Rt

number

A quantidade de tempo consumida para executar a instrução SQL. Unidade: segundos.

0.409789

User

string

O nome do usuário que executa a instrução SQL.

testuser

LockWaitTime

number

A duração da espera de bloqueio. Unidade: segundos.

0.0137

LogicalRead

number

O número de leituras lógicas.

165848

PhysicalSyncRead

number

O número de leituras síncronas físicas.

0

PhysicalAsyncRead

number

O número de leituras assíncronas físicas.

0

RowsExamined

integer

O número total de linhas verificadas.

Nota

Este parâmetro é retornado apenas para bancos de dados ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL e PolarDB for MySQL.

2048576

RowsReturned

integer

O número de linhas retornadas pela instrução SQL.

14

OriginHost

string

O endereço IP de origem.

172.17.XX.XX

ScanRows

integer

O número de linhas verificadas.

0

UpdateRows

integer

O número de linhas atualizadas.

0

SqlType

string

O tipo da instrução SQL. Valores válidos: SELECT, INSERT, UPDATE, DELETE, LOGIN, LOGOUT, MERGE, ALTER, CREATEINDEX, DROPINDEX, CREATE, DROP, SET, DESC, REPLACE, CALL, BEGIN, DESCRIBE, ROLLBACK, FLUSH, USE, SHOW, START, COMMIT e RENAME.

SELECT

Scnt

integer

O número de solicitações enviadas dos nós de computação do PolarDB-X 2.0 para os nós de dados.

0

Rows

integer

O número de linhas atualizadas ou retornadas nos nós de computação do PolarDB-X 2.0.

0

Frows

integer

O número de linhas buscadas pelos nós de computação do PolarDB-X 2.0.

0

Code

integer

O código de status HTTP retornado.

200

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true

  • false

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "Successful",
  "RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
  "Data": [
    {
      "Timestamp": 1660100753556,
      "SqlId": "651b56fe9418d48edb8fdf0980ec****",
      "Sql": "select * from testdb01 where ****",
      "Database": "dbtest",
      "Rt": 0.409789,
      "User": "testuser",
      "LockWaitTime": 0.0137,
      "LogicalRead": 165848,
      "PhysicalSyncRead": 0,
      "PhysicalAsyncRead": 0,
      "RowsExamined": 2048576,
      "RowsReturned": 14,
      "OriginHost": "172.17.XX.XX",
      "ScanRows": 0,
      "UpdateRows": 0,
      "SqlType": "SELECT",
      "Scnt": 0,
      "Rows": 0,
      "Frows": 0
    }
  ],
  "Code": 200,
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParams The request parameters are invalid.
403 NoPermission You are not authorized to do this action.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.