Queries - List By Database

Serviço:

SQL Database

Versão da API:

2014-04-01

Obtém uma lista das principais consultas por base de dados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/topQueries?api-version=2014-04-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	TopQueriesListResult	OK

Exemplos

List top queries

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/sqlcrudtest/databases/db1/topQueries?api-version=2014-04-01

Resposta da amostra

Código de estado:

200

{
  "value": [
    {
      "type": "Microsoft.Sql/servers/databases/topQueries",
      "numberOfTopQueries": 1,
      "aggregationFunction": "sum",
      "executionType": "any",
      "observedMetric": "cpu",
      "observationStartTime": "2017-07-11T16:21:54.0916567Z",
      "observationEndTime": "2017-07-12T16:21:54.0916567Z",
      "intervalType": "PT1H",
      "queries": [
        {
          "queryId": "19",
          "intervals": [
            {
              "intervalStartTime": "2017-07-11T16:00:00",
              "executionCount": 12,
              "metrics": [
                {
                  "name": "cpu",
                  "displayName": "Cpu",
                  "unit": "percentage",
                  "value": 0.000763888888888889
                },
                {
                  "name": "io",
                  "displayName": "Physical Io Reads",
                  "unit": "percentage",
                  "value": 0
                },
                {
                  "name": "logIo",
                  "displayName": "Log Writes",
                  "unit": "percentage",
                  "value": 0
                },
                {
                  "name": "memory",
                  "displayName": "Memory consumption",
                  "unit": "KB",
                  "value": 0
                },
                {
                  "name": "duration",
                  "displayName": "Query duration",
                  "unit": "microseconds",
                  "value": 3308
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Definições

Name	Description
QueryAggregationFunction	A função que é utilizada para agregar as métricas de cada consulta.
QueryExecutionType	O tipo de execução que é utilizado para filtrar as instâncias de consulta devolvidas.
QueryInterval	Uma consulta de base de dados.
QueryMetric	Uma consulta de base de dados.
QueryMetricUnit	A unidade de medida
QueryObservedMetricType	O tipo de métrica a utilizar para ordenar as métricas principais.
QueryStatistic	Uma consulta de base de dados.
TopQueries	Uma consulta de base de dados.
TopQueriesListResult	Representa a resposta a um pedido de obter as principais consultas.

QueryAggregationFunction

Enumeração

A função que é utilizada para agregar as métricas de cada consulta.

Valor	Description
avg
max
min
sum

QueryExecutionType

Enumeração

O tipo de execução que é utilizado para filtrar as instâncias de consulta devolvidas.

Valor	Description
aborted
any
exception
irregular
regular

QueryInterval

Object

Uma consulta de base de dados.

Name	Tipo	Description
executionCount	number (int32)	O número de vezes que a consulta foi executada durante este intervalo.
intervalStartTime	string (date-time)	A hora de início do intervalo de medição (ISO8601 formato).
metrics	QueryMetric[]	A lista de métricas de consulta durante este intervalo.

QueryMetric

Object

Uma consulta de base de dados.

Name	Tipo	Description
displayName	string	O nome da métrica a apresentar na interface de utilizador
name	string	O nome da métrica
unit	QueryMetricUnit	A unidade de medida
value	number (double)	O valor medido

QueryMetricUnit

Enumeração

A unidade de medida

Valor	Description
KB
microseconds
percentage

QueryObservedMetricType

Enumeração

O tipo de métrica a utilizar para ordenar as métricas principais.

Valor	Description
cpu
duration
executionCount
io
logio

QueryStatistic

Object

Uma consulta de base de dados.

Name	Tipo	Description
intervals	QueryInterval[]	A lista de intervalos de consulta.
queryId	string	O ID da consulta

TopQueries

Object

Uma consulta de base de dados.

Name	Tipo	Description
aggregationFunction	QueryAggregationFunction	A função que é utilizada para agregar as métricas de cada consulta.
executionType	QueryExecutionType	O tipo de execução que é utilizado para filtrar as instâncias de consulta devolvidas.
intervalType	string	A duração do intervalo (ISO8601 formato de duração).
numberOfTopQueries	number (int32)	O número de consultas pedidas.
observationEndTime	string (date-time)	A hora de fim das consultas devolvidas (formato ISO8601)
observationStartTime	string (date-time)	A hora de início das consultas devolvidas (formato ISO8601)
observedMetric	QueryObservedMetricType	O tipo de métrica a utilizar para ordenar as métricas principais.
queries	QueryStatistic[]	A lista de consultas.

TopQueriesListResult

Object

Representa a resposta a um pedido de obter as principais consultas.

Name	Tipo	Description
value	TopQueries[]	A lista das principais consultas.