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

Invoca a operação DescribeSqlInsightStatistic para realizar a agregação de estatísticas do SQL Explorer para uma instância especificada dentro de uma determinada janela de tempo por dimensões como modelo de SQL, origem de acesso ou usuário do banco de dados.

Descrição da operação

Antes de chamar esta operação, certifique-se de que os seguintes pré-requisitos sejam atendidos:

Ao usar o SDK do Alibaba Cloud ou o SDK do DAS, use a versão mais recente.
Ao usar um SDK para chamar o DAS, defina a região como cn-shanghai.
O recurso SQL Explorer deve estar ativado para a instância de destino. Caso contrário, a operação retornará um erro.

Notas de uso:

Esta operação é assíncrona. A primeira chamada retorna ResultId e State. Você deve consultar a operação repetidamente com exatamente os mesmos parâmetros de solicitação até que State seja SUCCESS para obter as estatísticas em Data.
StartTime e EndTime são carimbos de data/hora UNIX em nível de milissegundo. StartTime não pode ser superior a 30 dias antes da hora atual, e o intervalo de tempo entre StartTime e EndTime não pode exceder 7 dias.
Devido a atrasos na agregação de dados, EndTime é automaticamente truncado para alguns minutos antes da hora atual. Os dados dos últimos minutos podem não ser consultados.
StartTime é ajustado automaticamente para um horário não anterior ao horário em que o recurso SQL Explorer foi ativado para a instância.

Descrição da resposta:

Data.Data.List contém as estatísticas agregadas agrupadas pela dimensão especificada. Cada elemento corresponde a um tipo de modelo de SQL ou a uma chave de agregação, em vez de um registro detalhado de uma única execução.
Scnt, AvgScnt, Rows, AvgRows, Frows e AvgFrows são métricas específicas para nós de computação do PolarDB-X e são retornadas apenas quando Role é polarx_cn.
Writes, AvgWrites, MaxWrites, MinWrites, PhysicalRead, AvgPhysicalRead, MaxPhysicalRead, MinPhysicalRead, CpuTime, AvgCpuTime, MaxCpuTime e MinCpuTime são métricas específicas para instâncias do SQL Server.
Trend é retornado apenas quando o parâmetro de solicitação DoFillTrend é definido como true e a capacidade de preenchimento de tendência está ativada para a instância. O intervalo de fatia de tempo é determinado automaticamente pelo intervalo de tempo da consulta.
Os campos de dimensão de amostra de SQL, como SqlNew, Params, FirstTime e Extra, não são retornados por esta operação. Esta operação fornece estatísticas agregadas na dimensão do modelo.

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

get

*All resources.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ConsoleContext	string	Não	O parâmetro reservado.	null
InstanceId	string	Sim	O ID da instância de banco de dados. Nota Esta operação oferece suporte a instâncias do ApsaraDB RDS for MySQL, PolarDB for MySQL, PolarDB-X, ApsaraDB RDS for PostgreSQL, PolarDB for PostgreSQL, ApsaraDB RDS for SQL Server e Lindorm que tenham o recurso SQL Explorer ativado. Instâncias do MongoDB e do Redis não são suportadas. Se você invocar esta operação para instâncias não suportadas, uma falha indicando que a operação não é suportada será retornada.	rm-bp1q6f9z5xxxxxxxx
NodeId	string	Não	O ID do nó na instância. Este parâmetro é usado para restringir o escopo das estatísticas ao nó especificado. Apenas um único ID de nó é suportado. Vários IDs de nó separados por vírgulas não são suportados. Nota Este parâmetro é necessário apenas para instâncias que consistem em vários nós, como instâncias do PolarDB-X e do Lindorm. Você pode ignorar este parâmetro para instâncias de nó único.	pi-bp1xxxxxxxxxxxx
Type	string	Não	A dimensão de agregação ou filtro para estatísticas. O valor não diferencia maiúsculas de minúsculas. Se este parâmetro não for especificado, as estatísticas serão agregadas por modelo de SQL por padrão. Valores válidos: FullRequestOrigin: agrega estatísticas por endereço de origem de acesso. FullRequestUser: agrega estatísticas por usuário do banco de dados. SQL: filtra estatísticas por modelo de SQL. Você também deve especificar TemplateId como o ID do modelo de SQL. OriginHost: filtra estatísticas por origem de acesso. Você também deve especificar TemplateId como o endereço de origem. User: filtra estatísticas por usuário do banco de dados. Você também deve especificar TemplateId como o nome de usuário. Nota Se você especificar um valor diferente dos valores anteriores, um erro InvalidParams será retornado.	SQL
TemplateId	string	Não	O identificador do objeto de estatísticas. O significado varia com base no valor de Type. Valores válidos: Quando Type é definido como SQL: especifique o ID do modelo de SQL, que é o SqlId na resposta. Quando Type é definido como OriginHost: especifique o endereço de origem de acesso. Quando Type é definido como User: especifique o nome de usuário do banco de dados. Nota Este parâmetro não entra em vigor quando Type está vazio, FullRequestOrigin ou FullRequestUser. Nota Quando Type é definido como SQL, você pode especificar vários IDs de modelo separados por vírgulas. Nesse caso, Keyword não entra em vigor.	9f8e7d6c5b4a3210
Keyword	string	Não	As palavras-chave usadas para recuperar modelos de SQL por correspondência aproximada com base no conteúdo do modelo de SQL. Separe várias palavras-chave com espaços. O sistema primeiro realiza a correspondência de palavras-chave para recuperar até 1.000 modelos de SQL correspondentes e, em seguida, realiza estatísticas de agregação com base nesses modelos. Se nenhum modelo correspondente for encontrado, uma lista vazia será retornada. Nota Este parâmetro não entra em vigor quando Type é definido como SQL e TemplateId é especificado.	t_order
StartTime	integer	Sim	A hora de início da consulta. O valor é um carimbo de data/hora UNIX em milissegundos. O sistema arredonda o valor para baixo para o minuto mais próximo. Nota A hora de início não pode ser superior a 30 dias antes da hora atual. Se a hora de início especificada for anterior à hora em que o recurso SQL Explorer foi ativado para a instância, a hora de início será ajustada automaticamente para a hora de ativação.	1718000000000
EndTime	integer	Sim	A hora de término da consulta. O valor é um carimbo de data/hora UNIX em milissegundos. O sistema arredonda o valor para cima para o minuto mais próximo. Nota O intervalo de tempo entre EndTime e StartTime não pode exceder 7 dias. Se EndTime for anterior à hora em que o recurso SQL Explorer foi ativado para a instância, um erro indicando que a hora da consulta é anterior à hora disponível será retornado. Nota Devido a atrasos na agregação de dados, o valor efetivo real é truncado para alguns minutos antes da hora atual. Portanto, os dados dos últimos minutos podem não ser consultados.	1718600000000
OrderBy	string	Não	O campo pelo qual ordenar os resultados. Se este parâmetro não for especificado ou se um valor não suportado for especificado, os resultados serão ordenados por rt (tempo total de resposta). Valores válidos: Tempo de resposta: rt, avgRt, maxRt, minRt e rtRate. Execuções: count, countRate e timestamp. Linhas verificadas: rowsExamined e avgRowsExamined. Linhas retornadas: rowsReturned, totalRowsReturned, avgRowsReturned, maxRowsReturned, minRowsReturned, maxRowReturned e minRowReturned. Leituras lógicas: logicalRead, totalLogicalRead, avgLogicalRead, maxLogicalRead e minLogicalRead. Leituras físicas: physicalRead, totalPhysicalRead, avgPhysicalRead, maxPhysicalRead e minPhysicalRead. Gravações lógicas (válido apenas para instâncias do SQL Server): writes, totalWrites, avgWrites, maxWrites e minWrites. Tempo de CPU (válido apenas para instâncias do SQL Server): totalCpuTime, avgCpuTime, maxCpuTime e minCpuTime. Nós de computação do PolarDB-X (válido apenas quando Role é definido como polarx_cn): scnt, avgScnt, rows, avgRows, frows e avgFrows. Linhas afetadas (válido apenas para instâncias do Lindorm): totalAffectRows e avgAffectRows. Nota timestamp indica que os resultados são ordenados pelo carimbo de data/hora dos dados. O carimbo de data/hora é um carimbo de data/hora UNIX em milissegundos. Nota Apenas a primeira letra não diferencia maiúsculas de minúsculas. Os caracteres restantes devem corresponder exatamente aos valores anteriores. Por exemplo, AvgRt é válido, mas avgrt é inválido.	rt
Asc	boolean	Não	A ordem de classificação. Valor padrão: false (ordem decrescente). Valores válidos: true: ordem crescente. false: ordem decrescente.	false
PageNo	integer	Não	O número da página. As páginas começam na página 1. Se este parâmetro não for especificado, o valor padrão 1 será usado.	1
PageSize	integer	Não	O número de entradas estatísticas a serem retornadas em cada página. Se este parâmetro não for especificado, o valor padrão 10 será usado. O valor máximo é 2000. Nota Se o valor exceder 2000, um erro InvalidParams será retornado em vez de ser truncado. Nota Quando as estatísticas são agregadas por origem de acesso ou usuário do banco de dados (quando Type é definido como FullRequestOrigin ou FullRequestUser), um valor maior que 100 é redefinido para 10 em alguns links de armazenamento de agregação.	20
DoFillTrend	boolean	Não	Especifica se devem ser preenchidos os dados de tendência de séries temporais para cada resultado estatístico, o que corresponde ao campo Trend na resposta. Valor padrão: true. Valores válidos: true: preenche os dados de tendência. false: não preenche os dados de tendência. Nota Se este parâmetro for definido como true, o sistema consulta adicionalmente dados para cada fatia de tempo para cada resultado, o que aumenta significativamente a sobrecarga da consulta. Se a capacidade de preenchimento de tendência não estiver ativada para a instância, este parâmetro não entrará em vigor.	true
SqlType	string	Não	O tipo de instrução SQL usado para filtrar os resultados. Valores válidos: select insert update delete Nota Os valores devem estar em minúsculas. Nos links de armazenamento de agregação de algumas instâncias, você pode especificar vários valores separados por vírgulas. Em outros links, você pode especificar apenas um único valor.	select
DbName	string	Não	O nome do banco de dados usado para filtrar os resultados. Nota Nos links de armazenamento de agregação de algumas instâncias, você pode especificar vários nomes de banco de dados separados por vírgulas. Em outros links, você pode especificar apenas um único nome de banco de dados.	db_test
Role	string	Não	A função do nó da instância. O valor não diferencia maiúsculas de minúsculas. Se este parâmetro não for especificado, a função será analisada automaticamente com base em InstanceId. Valores válidos: polarx_cn: Nó de computação do PolarDB-X. polarx_dn: Nó de armazenamento do PolarDB-X. Nota Este valor afeta o escopo dos campos retornados. Por exemplo, Scnt, Rows e Frows são retornados apenas quando o valor é polarx_cn.	polarx_cn
JobId	string	Não	O ID idempotente para consultar dados do SQL Explorer. Você não precisa especificar este parâmetro para consultas comuns.	9a4f5c4494dbd6713185d87a97aa53e8
Filters	array<object>	Não	A lista de condições de filtro estruturadas. As condições são passadas como pares chave-valor. O formato POP é Filters.N.Key e Filters.N.Value. Um máximo de 100 pares pode ser especificado. Key não diferencia maiúsculas de minúsculas. Entradas com um Value vazio são ignoradas. Valores válidos de Key que entram em vigor nesta operação: keyWord: as palavras-chave. As palavras-chave são divididas em várias palavras por caracteres de espaço em branco e entram em vigor junto com o parâmetro Keyword. hostAddress: os endereços de origem de acesso. Separe vários endereços com vírgulas. Esta chave entra em vigor junto com TemplateId quando Type é definido como OriginHost. accountName: os nomes de usuário do banco de dados. Separe vários nomes de usuário com vírgulas. dbName: os nomes dos bancos de dados. Separe vários nomes com vírgulas. Esta chave entra em vigor junto com o parâmetro DbName. sqlType: os tipos de instrução SQL. Separe vários tipos com vírgulas. Esta chave entra em vigor junto com o parâmetro SqlType. sqlId: os IDs de modelo de SQL. Separe vários IDs com vírgulas. Esta chave entra em vigor junto com TemplateId quando Type é definido como SQL. insRole: a função primária/secundária. Os valores válidos são master e slave. Este valor diferencia maiúsculas de minúsculas. Nota Se você especificar uma Key diferente dos valores anteriores, a chave será ignorada. Nota Este parâmetro entra em vigor apenas nos links de armazenamento de agregação de algumas instâncias. Em outros links, este parâmetro é completamente ignorado.
	object	Não
Key	string	Não	A chave do filtro condicional. A chave não diferencia maiúsculas de minúsculas. Para valores ativos, consulte a descrição da métrica do parâmetro Filters.	sqlType
Value	string	Não	O valor da condição de filtro. Se o valor for nulo ou uma string vazia, a condição de filtro será ignorada. Separe vários valores com vírgulas. O limite superior específico depende da chave correspondente.	select

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status da resposta.	200
Data	object	O envelope para o resultado da consulta assíncrona. A primeira chamada retorna ResultId e State. Você deve consultar a API com exatamente os mesmos parâmetros de solicitação até que State seja SUCCESS e, em seguida, recuperar os detalhes estatísticos de List.
Data	object	O resultado da consulta estatística do SQL Explorer. Nota Retornado apenas quando State for SUCCESS.
Extra	any	As informações estendidas. Nota Esta operação não retorna este campo.	{}
List	array<object>	A lista de resultados estatísticos do SQL Explorer. Cada elemento é uma entrada estatística sob uma dimensão de agregação.
	array<object>
AffectRows	integer	O número de linhas afetadas para uma única instrução SQL. Para instruções SELECT, isso indica o número de linhas verificadas. Para instruções DML, isso indica o número de linhas afetadas. Nota Retornado apenas para instâncias Lindorm.	30
AggKey	string	O valor da dimensão de agregação para as estatísticas atuais. Este valor varia com base no parâmetro de solicitação Type. Valores válidos: Quando agregado por modelo SQL: o ID do modelo SQL, que é o mesmo que SqlId. Quando Type é FullRequestOrigin: o endereço de acesso de origem. Quando Type é FullRequestUser: o nome de usuário do banco de dados.	651b56fe9418d48edb8fdf0980ec****
AvgAffectRows	number	O número médio de linhas afetadas. Nota Retornado apenas para instâncias Lindorm. Para outros mecanismos, o valor é nulo.	30.2
AvgCpuTime	number	O tempo médio de CPU consumido pela execução SQL, em microssegundos. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	12.5
AvgFrows	number	O número médio de linhas buscadas pelos nós de computação do PolarDB-X a partir dos nós de dados. Nota Esta é uma métrica exclusiva para nós de computação do PolarDB-X. Para outros mecanismos, o valor é nulo ou 0.	10
AvgLockWaitTime	number	O tempo médio de espera de bloqueio por execução, em milissegundos. Nota Os dados estão disponíveis apenas quando Version for 1.	0.00009589874265269765
AvgLogicalRead	number	O número médio de leituras lógicas por execução. Nota Os dados estão disponíveis apenas quando Version for 1.	654.4470327860251
AvgPhysicalAsyncRead	number	O número médio de leituras assíncronas físicas por execução. Nota Os dados estão disponíveis apenas quando Version for 1.	0
AvgPhysicalRead	number	O número médio de leituras físicas. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	654.4
AvgPhysicalSyncRead	number	O número médio de leituras síncronas físicas por execução. Nota Os dados estão disponíveis apenas quando Version for 1.	0
AvgRows	number	O número médio de linhas atualizadas e retornadas para os nós de computação do PolarDB-X. Nota Esta é uma métrica exclusiva para nós de computação do PolarDB-X. Para outros mecanismos, o valor é nulo ou 0.	10
AvgRowsExamined	number	O número médio de linhas verificadas por execução.	53421.0
AvgRowsReturned	number	O número médio de linhas retornadas por execução.	14
AvgRowsUpdated	number	O número médio de linhas atualizadas por execução.	30.2
AvgRt	number	O tempo médio de execução por execução, em milissegundos.	2.499
AvgScanRows	number	O número médio de linhas verificadas. Nota Esta operação não retorna este campo. Para obter o número médio de linhas verificadas, use AvgRowsExamined.	53421.0
AvgScnt	number	O número médio de solicitações enviadas dos nós de computação do PolarDB-X para os nós de dados. Nota Esta é uma métrica exclusiva para nós de computação do PolarDB-X. Para outros mecanismos, o valor é nulo ou 0.	10
AvgWrites	number	O número médio de gravações lógicas. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	10
Count	integer	O número total de execuções para o modelo SQL dentro do período estatístico.	127
CountRate	number	A proporção do número de vezes que o modelo SQL nesta entrada é executado em relação ao número total de vezes que as instruções SQL são executadas na instância. Valores válidos: 0 a 1.	0.0586
CpuTime	integer	O tempo total de CPU consumido pela execução SQL, em microssegundos. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	100
Database	string	O nome do banco de dados onde a instrução SQL é executada.	dbtest01
ErrorCode	string	O código de erro retornado pela execução SQL. Nota Os códigos de erro pertencem aos detalhes de uma única instrução SQL. Esta operação retorna estatísticas agregadas no nível do modelo e não retorna este campo. Para verificar ocorrências de erro, use ErrorCount.	1146
ErrorCount	integer	O número de erros de execução para o modelo SQL dentro do período estatístico.	1
FirstTime	integer	A hora em que o modelo SQL apareceu pela primeira vez. A hora é um carimbo de data/hora UNIX em milissegundos. Nota Esta operação não retorna este campo.	1659308149000
Frows	integer	O número total de linhas buscadas pelos nós de computação do PolarDB-X a partir dos nós de dados. Nota Esta é uma métrica exclusiva para nós de computação do PolarDB-X. Para outros mecanismos, o valor é nulo ou 0.	10
Hash	string	O valor de hash do modelo SQL, retornado junto com o modelo SQL. Nota Este valor é gerado pelo kernel dos nós de computação do PolarDB-X. Para instâncias que não são nós de computação do PolarDB-X, o valor está vazio.	2e8147b5ca2dfc640dfd5e43d96a****
Ip	string	O endpoint da instância à qual os dados estatísticos pertencem. Nota Se este campo é retornado depende do link de armazenamento convergido da instância. Para alguns links, o valor é nulo.	rm-2ze1jdv45i7l6****.mysql.rds.aliyuncs.com
LockWaitTime	number	O tempo total de espera de bloqueio, em milissegundos. Nota Os dados estão disponíveis apenas quando Version for 1.	1089.4177720290281
LogicalRead	number	O número total de leituras lógicas. Nota Os dados estão disponíveis apenas quando Version for 1.	165848
MaxCpuTime	integer	O tempo máximo de CPU consumido em uma única execução, em microssegundos. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	30
MaxLogicalRead	integer	O número máximo de leituras lógicas em uma única execução. Nota Os dados estão disponíveis apenas quando Version for 1.	3186
MaxPhysicalRead	integer	O número máximo de leituras físicas em uma única execução. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	3186
MaxRowsExamined	integer	O número máximo de linhas verificadas em uma única execução. Nota Esta operação não retorna este campo. Para obter o número de linhas verificadas, use RowsExamined e AvgRowsExamined.	318613
MaxRowsReturned	integer	O número máximo de linhas retornadas em uma única execução.	20
MaxRt	number	O tempo máximo de execução em uma única execução, em milissegundos.	12.499
MaxWrites	integer	O número máximo de gravações lógicas em uma única execução. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	12
MinCpuTime	integer	O tempo mínimo de CPU consumido em uma única execução, em microssegundos. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	5
MinLogicalRead	integer	O número mínimo de leituras lógicas em uma única execução. Nota Os dados estão disponíveis apenas quando Version for 1.	12
MinPhysicalRead	integer	O número mínimo de leituras físicas em uma única execução. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	12
MinRowsReturned	integer	O número mínimo de linhas retornadas em uma única execução.	1
MinRt	number	O tempo mínimo de execução em uma única execução, em milissegundos.	0.409789
MinWrites	integer	O número mínimo de gravações lógicas em uma única execução. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	8
OriginAlias	string	O alias de exibição configurado para o endereço de acesso de origem. Nota Retornado apenas quando agregado por fonte de acesso (quando Type for FullRequestOrigin). Em outros cenários, o valor é nulo.	order-1
OriginHost	string	O endereço de origem do cliente que iniciou a instrução SQL. Nota Quando Type for FullRequestOrigin, este campo é a dimensão de agregação para as estatísticas.	172.26.XX.XXX
Params	string	O conteúdo do parâmetro da amostra SQL. Nota Esta operação retorna estatísticas agregadas no nível do modelo e não retorna este campo.	[1, "das"]
PhysicalAsyncRead	number	O número total de leituras assíncronas físicas. Nota Os dados estão disponíveis apenas quando Version for 1.	0
PhysicalRead	integer	O número total de leituras físicas. Nota Esta é uma métrica exclusiva para instâncias SQL Server. Para outros mecanismos, o valor é nulo.	165848
PhysicalSyncRead	number	O número total de leituras síncronas físicas. Nota Os dados estão disponíveis apenas quando Version for 1.	0
Port	integer	A porta de conexão da instância à qual os dados estatísticos pertencem. Nota A devolução deste campo depende do link de armazenamento convergido da instância. Para alguns links, o valor é nulo.	3306
Psql	string	O texto do modelo SQL parametrizado, que é a instrução com as constantes no SQL substituídas por placeholders.	select * from t_order where id = ?
Rows	integer	O número total de linhas atualizadas e retornadas para os nós de computação do PolarDB-X. Nota Esta é uma métrica exclusiva para nós de computação do PolarDB-X. Para outros mecanismos, o valor é nulo ou 0.	10
RowsExamined	integer	O número total de linhas escaneadas para o modelo SQL dentro do período estatístico.	2048576
RowsReturned	integer	O número total de linhas retornadas para o modelo SQL dentro do período estatístico.	14
Rt	number	O tempo total de execução do modelo SQL dentro do período estatístico, em milissegundos. Nota Para nós de computação do PolarDB-X (onde Role é polarx_cn) com uma versão de kernel anterior a 5.4.13, este valor é convertido de microssegundos para milissegundos.	0.409789
RtGreaterThanOneSecondCount	integer	O número de vezes em que a duração da execução excedeu 1 segundo. Nota A devolução deste campo depende do link de armazenamento agregado da instância. Para alguns links, o valor é nulo.	20
RtRate	number	A proporção do tempo total de execução desta estatística em relação ao tempo total de execução de todas as instruções SQL da instância. Valores válidos: 0 a 1.	0.1384
SampleType	string	O identificador de tipo dos dados de amostra. Nota Esta operação retorna estatísticas agregadas e não retorna este campo.	sql
ScanRows	integer	O número de linhas escaneadas para uma única instrução SQL. Nota Esta operação retorna estatísticas agregadas na dimensão do modelo e não retorna este campo. Use as métricas agregadas RowsExamined e AvgRowsExamined em seu lugar.	29
Scnt	integer	O número total de solicitações enviadas dos nós de computação do PolarDB-X para os nós de dados. Nota Esta é uma métrica exclusiva para nós de computação do PolarDB-X. Para outros mecanismos, o valor é nulo ou 0.	10
Sql	string	O texto SQL original. Nota Os resultados estatísticos retornam o modelo SQL (Psql) e não retornam este campo.	select * from t_order where id = 1
SqlId	string	O ID do modelo SQL, que identifica exclusivamente uma categoria de instruções SQL parametrizadas. Múltiplas execuções sob o mesmo modelo são agregadas em uma única estatística. Você pode usar este ID para associar a mesma categoria de instruções SQL em consultas multidimensionais.	651b56fe9418d48edb8fdf0980ec****
SqlNew	string	O texto SQL após o processamento unificado dos valores de parâmetro, usado em cenários de dados de amostra. Nota Esta operação não retorna este campo.	select * from t_order where id = ?
SqlTextFeature	string	O valor do recurso de texto SQL, usado em cenários de análise de SQL. Nota Esta operação não retorna este campo.	select_from_t_order
SqlType	string	O tipo de SQL. Valores válidos: select insert update delete other	select
SumRowsUpdated	number	O número total de linhas atualizadas para o modelo SQL dentro do período estatístico.	3810
Tables	array	A lista de nomes de tabelas envolvidas na instrução SQL.
	string	O nome de uma tabela envolvida na instrução SQL.	t_order
ThreadId	string	O ID da thread do banco de dados que executou a instrução SQL. Nota O ID da thread pertence aos detalhes de uma única instrução SQL. Esta operação retorna estatísticas agregadas na dimensão do modelo e não retorna este campo.	57472578
TimeRate	number	A proporção do tempo de execução. Nota Esta operação retorna a proporção do tempo de execução por meio de RtRate e não retorna este campo.	0.1384
Timestamp	integer	O carimbo de data e hora dos dados, que é um carimbo de data e hora UNIX em milissegundos. Nota Os resultados estatísticos são agregados na dimensão do modelo SQL e não retornam este campo.	1718600000000
TotalAffectRows	integer	O número total de linhas afetadas. Nota Este campo é retornado apenas para instâncias Lindorm. Para outros mecanismos, o valor é nulo.	3810
TotalRt	integer	O tempo total de execução da instrução SQL. Nota Esta operação não retorna este campo. Use Rt para o tempo total de execução.	310
TotalScanRows	integer	O número total de linhas escaneadas. Nota Esta operação não retorna este campo. Use RowsExamined para o número total de linhas escaneadas.	2048576
Trend	array<object>	A sequência de tendências de contagens de execução para o modelo SQL, dividida por fatias de tempo dentro da janela de tempo da consulta. Nota Este campo é retornado apenas quando o parâmetro de solicitação DoFillTrend é definido como true e o recurso de preenchimento de tendências está ativado para a instância. O intervalo da fatia de tempo é determinado automaticamente pelo intervalo da consulta. Fatias de tempo sem dados podem ser preenchidas com zeros.
	object
Timestamp	integer	O carimbo de data e hora do ponto de tendência, que é um carimbo de data e hora UNIX em milissegundos.	1718000000000
Value	any	O número de execuções de SQL dentro da fatia de tempo.	12
UpdateRows	integer	O número de linhas atualizadas para uma única instrução SQL. Nota Esta operação retorna estatísticas agregadas na dimensão do modelo e não retorna este campo. Use as métricas agregadas SumRowsUpdated e AvgRowsUpdated em seu lugar.	30
User	string	O nome de usuário do banco de dados que executou a instrução SQL. Nota Quando Type é FullRequestUser, este campo é a dimensão de agregação para esta estatística.	testUser
Version	integer	A versão do link de coleta de dados do SQL Explorer. Se a instância coletar dados de leitura lógica ou espera de bloqueio, o valor é 1. Caso contrário, o valor é 0. Valores válidos: 0: Link de coleta básica V0. 1: Link de coleta V1, que coleta quatro métricas adicionais com base na V0: LockWaitTime, LogicalRead, PhysicalSyncRead e PhysicalAsyncRead. Nota Quando 0 é retornado, as métricas estendidas anteriores não possuem dados.	1
VpcId	string	O ID da VPC da instância à qual os dados estatísticos pertencem. Nota A devolução deste campo depende do link de armazenamento agregado da instância. Para alguns links, o valor é nulo.	vpc-2zentqj1sk4qmolci****
Writes	integer	O número total de gravações lógicas. Nota Esta é uma métrica exclusiva para instâncias do SQL Server. Para outros mecanismos, o valor é nulo.	10
PageNo	integer	O número da página atual, que corresponde ao parâmetro de solicitação PageNo.	1
PageSize	integer	O número de entradas retornadas por página, que corresponde ao parâmetro de solicitação PageSize.	10
Total	integer	O número total de entradas estatísticas que atendem às condições da consulta, que pode ser usado para paginação.	10
ErrorCode	integer	O código de erro para a consulta assíncrona com falha. Nota Este campo é retornado apenas quando a consulta falha.	-10200020
IsFinish	boolean	Indica se a consulta assíncrona foi concluída. Valores válidos: true: State é SUCCESS ou FAIL. false: State é RUNNING.
Message	string	A descrição do erro para a consulta assíncrona com falha. Nota Este campo é retornado apenas quando a consulta falha.	startTime must be in 30 days and the interval must be within 7 day
RequestKey	string	O identificador de hash dos parâmetros de solicitação. Nota Esta operação não retorna este campo. Use ResultId para identificar a consulta assíncrona.	507044db6c4eadfa2dab9b084e80****
ResultId	string	O ID do resultado da consulta assíncrona, que está no formato de um prefixo async_ seguido por um valor de hash. Ele é calculado com base em todos os parâmetros de negócios da solicitação atual. Nota Chamadas repetidas com os mesmos parâmetros atingem o mesmo resultado de consulta. Portanto, você deve levar exatamente os mesmos parâmetros de solicitação da primeira chamada ao fazer a sondagem. Qualquer alteração de parâmetro gera um ResultId diferente e aciona uma nova consulta.	async__507044db6c4eadfa2dab9b084e80****
State	string	O estado atual da consulta assíncrona. Valores válidos: RUNNING: A consulta está em execução. Continue a sondagem. SUCCESS: A consulta foi bem-sucedida. O campo Data possui um valor. FAIL: A consulta falhou. Nota Quando a consulta falha, a operação retorna diretamente um código de erro e uma mensagem de erro, em vez de um corpo de resposta normal com State definido como FAIL.	SUCCESS
Timestamp	integer	A hora em que a consulta assíncrona foi enviada, que é um carimbo de data e hora UNIX em milissegundos. Nota Quando a consulta falha, este valor é a hora em que a falha ocorreu.	1718600000000
Message	string	A mensagem de resposta. Uma descrição de erro é retornada quando a solicitação falha.	Successful
RequestId	string	O identificador exclusivo da solicitação, que pode ser usado para solução de problemas.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou. Verifique a causa com base em Code e Message.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Data": {
    "Data": {
      "Extra": "{}",
      "List": [
        {
          "AffectRows": 30,
          "AggKey": "651b56fe9418d48edb8fdf0980ec****",
          "AvgAffectRows": 30.2,
          "AvgCpuTime": 12.5,
          "AvgFrows": 10,
          "AvgLockWaitTime": 0.00009589874265269765,
          "AvgLogicalRead": 654.4470327860251,
          "AvgPhysicalAsyncRead": 0,
          "AvgPhysicalRead": 654.4,
          "AvgPhysicalSyncRead": 0,
          "AvgRows": 10,
          "AvgRowsExamined": 53421,
          "AvgRowsReturned": 14,
          "AvgRowsUpdated": 30.2,
          "AvgRt": 2.499,
          "AvgScanRows": 53421,
          "AvgScnt": 10,
          "AvgWrites": 10,
          "Count": 127,
          "CountRate": 0.0586,
          "CpuTime": 100,
          "Database": "dbtest01",
          "ErrorCode": "1146",
          "ErrorCount": 1,
          "FirstTime": 1659308149000,
          "Frows": 10,
          "Hash": "2e8147b5ca2dfc640dfd5e43d96a****",
          "Ip": "rm-2ze1jdv45i7l6****.mysql.rds.aliyuncs.com",
          "LockWaitTime": 1089.4177720290281,
          "LogicalRead": 165848,
          "MaxCpuTime": 30,
          "MaxLogicalRead": 3186,
          "MaxPhysicalRead": 3186,
          "MaxRowsExamined": 318613,
          "MaxRowsReturned": 20,
          "MaxRt": 12.499,
          "MaxWrites": 12,
          "MinCpuTime": 5,
          "MinLogicalRead": 12,
          "MinPhysicalRead": 12,
          "MinRowsReturned": 1,
          "MinRt": 0.409789,
          "MinWrites": 8,
          "OriginAlias": "order-1",
          "OriginHost": "172.26.XX.XXX",
          "Params": "[1, \"das\"]",
          "PhysicalAsyncRead": 0,
          "PhysicalRead": 165848,
          "PhysicalSyncRead": 0,
          "Port": 3306,
          "Psql": "select * from t_order where id = ?",
          "Rows": 10,
          "RowsExamined": 2048576,
          "RowsReturned": 14,
          "Rt": 0.409789,
          "RtGreaterThanOneSecondCount": 20,
          "RtRate": 0.1384,
          "SampleType": "sql",
          "ScanRows": 29,
          "Scnt": 10,
          "Sql": "select * from t_order where id = 1",
          "SqlId": "651b56fe9418d48edb8fdf0980ec****",
          "SqlNew": "select * from t_order where id = ?",
          "SqlTextFeature": "select_from_t_order",
          "SqlType": "select",
          "SumRowsUpdated": 3810,
          "Tables": [
            "t_order"
          ],
          "ThreadId": "57472578",
          "TimeRate": 0.1384,
          "Timestamp": 1718600000000,
          "TotalAffectRows": 3810,
          "TotalRt": 310,
          "TotalScanRows": 2048576,
          "Trend": [
            {
              "Timestamp": 1718000000000,
              "Value": "12"
            }
          ],
          "UpdateRows": 30,
          "User": "testUser",
          "Version": 1,
          "VpcId": "vpc-2zentqj1sk4qmolci****",
          "Writes": 10
        }
      ],
      "PageNo": 1,
      "PageSize": 10,
      "Total": 10
    },
    "ErrorCode": -10200020,
    "IsFinish": false,
    "Message": "startTime must be in 30 days and the interval must be within 7 day",
    "RequestKey": "507044db6c4eadfa2dab9b084e80****",
    "ResultId": "async__507044db6c4eadfa2dab9b084e80****",
    "State": "SUCCESS",
    "Timestamp": 1718600000000
  },
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "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.