GetFullRequestStatResultByInstanceId - Database Autonomy Service: Central de Documentação do Alibaba Cloud

Agrega de forma assíncrona os dados completos de solicitação nos resultados do SQL Explorer de uma instância de banco de dados por ID de SQL.

Descrição da operação

Nota

Após invocar a operação de forma assíncrona, os resultados completos não são retornados imediatamente. Se o parâmetro isFinish na resposta for false, aguarde 1 segundo e invoque a operação novamente até que isFinish seja true, o que indica que os resultados completos foram retornados.

O recurso SQL Explorer diagnostica o status de integridade das instruções SQL e soluciona problemas de desempenho. Para obter detalhes, consulte SQL Explorer.

Para instâncias de banco de dados compatíveis, consulte Notas de uso do DAS Enterprise Edition.
Ao usar um SDK para invocar o DAS, você deve definir a região como cn-shanghai.
A partir de 1º de setembro de 2024, devido à otimização do algoritmo de modelo SQL, o valor do parâmetro SqlId será alterado ao invocar esta operação. Para obter detalhes, consulte Aviso: Otimização do algoritmo de modelo SQL.

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:GetFullRequestStatResultByInstanceId

get

*All resources.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
UserId	string	Não	O ID da instância, que é o ID da conta Alibaba Cloud que criou a instância de banco de dados. Nota Este parâmetro é opcional. Após inserir o ID da instância de banco de dados de destino, o sistema obtém automaticamente o ID da instância ao chamar a operação de API.	196278346919****
InstanceId	string	Sim	O ID da instância.	rm-2ze8g2am97624****
NodeId	string	Não	O ID do nó. Nota Para instâncias do PolarDB for MySQL, o ID do nó é obrigatório.	pi-bp12v7243x012****
SqlId	string	Não	O ID do SQL. Nota Se você especificar um ID de SQL, os dados completos de solicitação do ID de SQL especificado serão agregados. Se você deixar este parâmetro vazio, os dados completos de solicitação de toda a instância de banco de dados serão agregados.	d71f82be1eef72bd105128204d2e****
OriginHost	string	Não	O endereço IP do cliente que executou a instrução SQL. Nota Este parâmetro é opcional. Se você especificar um endereço IP de cliente, os dados completos de solicitação do endereço IP de cliente especificado serão agregados. Se você deixar este parâmetro vazio, os dados completos de solicitação de toda a instância de banco de dados serão agregados.	172.26.XX.XXX
Keyword	string	Não	A palavra-chave da consulta.	dbtest01
Start	integer	Sim	A hora de início da consulta. O formato é um carimbo de data e hora UNIX, em milissegundos. Nota A hora de início deve estar dentro da duração de armazenamento do SQL Explorer para a instância de banco de dados e não pode ser superior a 90 dias antes da hora atual.	1645581813000
End	integer	Sim	A hora de término da consulta. A hora é um carimbo de data e hora UNIX em milissegundos. Nota A hora de término deve ser posterior à hora de início, e o intervalo entre a hora de início e a hora de término não pode exceder um dia.	1645668213000
OrderBy	string	Não	O campo pelo qual ordenar os resultados. Valor padrão: count. count: o número de execuções. avgRt: o tempo médio de execução. rtRate: a proporção do tempo de execução. rowsExamined: o número total de linhas verificadas. avgRowsExamined: o número médio de linhas verificadas. avgRowsReturned: o número médio de linhas retornadas.	count
Asc	boolean	Não	Especifica se os resultados devem ser ordenados em ordem crescente. Valor padrão: false.	False
PageNo	integer	Sim	O número da página para a consulta paginada. A paginação começa em 1. Valor padrão: 1.	1
PageSize	integer	Sim	O volume de dados por página para paginação em uma consulta paginada. Valor padrão: 20.	20
SqlType	string	Não	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. Nota Se a instância de banco de dados for uma instância ApsaraDB RDS for MySQL, PolarDB for MySQL ou PolarDB-X 2.0, você poderá agregar dados por tipo de instrução SQL.	SELECT
DbName	string	Não	O nome do banco de dados.	dbtest01
Role	string	Não	As informações do nó da instância de banco de dados PolarDB-X 2.0. Valores válidos: polarx_cn: nó de computação. polarx_dn: nó de dados.	polarx_cn

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A lista detalhada de informações retornadas.
Message	string	A mensagem retornada para a solicitação. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro, como um código de erro, será retornada.	Successful
RequestId	string	O ID da solicitação.	7172BECE-588A-5961-8126-C216E16B****
Data	object	Os dados retornados.
Result	object	Os dados completos de solicitação retornados.
List	array<object>	A lista de dados completos de solicitação.
	object	A lista de dados completos de solicitação.
SqlId	string	O ID do SQL.	d71f82be1eef72bd105128204d2e****
AvgFetchRows	integer	O número médio de linhas extraídas pelo nó de computação do nó de dados na instância de banco de dados PolarDB-X 2.0.	0
AvgLockWaitTime	number	O tempo médio de espera de bloqueio, em segundos.	0.00009589874265269765
AvgLogicalRead	number	O número médio de leituras lógicas.	654.4470327860251
AvgPhysicalAsyncRead	integer	O número médio de leituras assíncronas físicas.	0
AvgPhysicalSyncRead	integer	O número médio de leituras síncronas físicas.	0
AvgExaminedRows	number	O número médio de linhas verificadas. Nota Este campo é compatível com os seguintes bancos de dados: ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL e PolarDB for MySQL.	10000
AvgReturnedRows	number	O número médio de linhas retornadas.	10000
AvgUpdatedRows	integer	O número médio de linhas atualizadas. Nota Este campo é compatível com os seguintes bancos de dados: ApsaraDB RDS for MySQL e PolarDB-X 2.0.	10000
AvgRt	number	O tempo médio de execução.	2.499
AvgSqlCount	integer	A contagem média de SQL.	10000
Count	integer	O número total de execuções.	100000
CountRate	number	A proporção de vezes que as instruções são executadas.	0.0586
Database	string	O nome do banco de dados.	dbtest01
ErrorCount	integer	O número de erros de execução.	1
FetchRows	integer	O número de linhas extraídas pelo nó de computação do nó de dados na instância de banco de dados PolarDB-X 2.0.	0
Ip	string	O endereço de rede da instância.	rm-uf6dyi58dm6**.mysql.rds.aliy**.com
LockWaitTime	number	O tempo de espera de bloqueio, em segundos.	1089.4177720290281
LogicalRead	integer	O número de leituras lógicas.	7.434573266E9
PhysicalAsyncRead	integer	O número de leituras assíncronas físicas.	0
PhysicalSyncRead	integer	O número de leituras síncronas físicas.	0
Port	integer	O número da porta.	3306
Psql	string	O modelo SQL.	select * from dbtest01 where ****
Rows	integer	O número total de linhas atualizadas ou retornadas pelo nó de computação na instância de banco de dados PolarDB-X 2.0.	0
ExaminedRows	integer	O número total de linhas verificadas. Nota Este campo é compatível com os seguintes bancos de dados: ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL e PolarDB for MySQL.	10000
RtGreaterThanOneSecondCount	integer	O número de instruções SQL cujo tempo de execução é superior a 1 segundo.	20
RtRate	number	A proporção do tempo de execução.	2.499
SqlCount	integer	O número de instruções SQL.	200
SumUpdatedRows	integer	O número total de linhas alteradas.	100
Tables	array	O nome da tabela do banco de dados.
	string	O nome da tabela do banco de dados.	tabletest01,tabletest02
Version	integer	A versão.	1
VpcId	string	O ID da VPC.	vpc-2zentqj1sk4qmolci****
Total	integer	A quantidade total de dados.	1
Fail	boolean	Indica se a solicitação falhou. Valores válidos: true: sim. false: não.	false
IsFinish	boolean	Indica se a solicitação assíncrona foi concluída. Valores válidos: true: sim. false: não.	true
ResultId	string	O ID da solicitação.	9CB97BC4-6479-55D0-B9D0-EA925AFE****
State	string	O status de execução da solicitação assíncrona. Valores válidos: RUNNING: em execução. SUCCESS: bem-sucedido. FAIL: falhou.	SUCCESS
Timestamp	integer	A hora de execução. A hora é um carimbo de data e hora UNIX em milissegundos.	1645668213000
Code	integer	O código de status retornado.	200
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "Successful",
  "RequestId": "7172BECE-588A-5961-8126-C216E16B****",
  "Data": {
    "Result": {
      "List": [
        {
          "SqlId": "d71f82be1eef72bd105128204d2e****",
          "AvgFetchRows": 0,
          "AvgLockWaitTime": 0.00009589874265269765,
          "AvgLogicalRead": 654.4470327860251,
          "AvgPhysicalAsyncRead": 0,
          "AvgPhysicalSyncRead": 0,
          "AvgExaminedRows": 10000,
          "AvgReturnedRows": 10000,
          "AvgUpdatedRows": 10000,
          "AvgRt": 2.499,
          "AvgSqlCount": 10000,
          "Count": 100000,
          "CountRate": 0.0586,
          "Database": "dbtest01",
          "ErrorCount": 1,
          "FetchRows": 0,
          "Ip": "rm-uf6dyi58dm6****.mysql.rds.aliy****.com",
          "LockWaitTime": 1089.4177720290281,
          "LogicalRead": 7434573266,
          "PhysicalAsyncRead": 0,
          "PhysicalSyncRead": 0,
          "Port": 3306,
          "Psql": "select * from dbtest01 where ****",
          "Rows": 0,
          "ExaminedRows": 10000,
          "RtGreaterThanOneSecondCount": 20,
          "RtRate": 2.499,
          "SqlCount": 200,
          "SumUpdatedRows": 100,
          "Tables": [
            "tabletest01,tabletest02"
          ],
          "Version": 1,
          "VpcId": "vpc-2zentqj1sk4qmolci****"
        }
      ],
      "Total": 1
    },
    "Fail": false,
    "IsFinish": true,
    "ResultId": "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
    "State": "SUCCESS",
    "Timestamp": 1645668213000
  },
  "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.	Os parâmetros da solicitação são inválidos.
403	NoPermission	You are not authorized to do this action.	Você não tem permissão para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.