Queries - List By Database

Serviço:: SQL Database

Versão da API:: 2014-04-01

Obtém uma lista das principais consultas por banco 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 do banco de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

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 usada para agregar as métricas de cada consulta.
QueryExecutionType	O tipo de execução usado para filtrar as instâncias de consulta retornadas.
QueryInterval	Uma consulta de banco de dados.
QueryMetric	Uma consulta de banco de dados.
QueryMetricUnit	A unidade de medida
QueryObservedMetricType	O tipo de métrica a ser usada para ordenar as métricas principais.
QueryStatistic	Uma consulta de banco de dados.
TopQueries	Uma consulta de banco de dados.
TopQueriesListResult	Representa a resposta a uma solicitação de obter consultas superiores.

QueryAggregationFunction

Enumeração

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

Valor	Description
min
max
avg
sum

QueryExecutionType

Enumeração

O tipo de execução usado para filtrar as instâncias de consulta retornadas.

Valor	Description
any
regular
irregular
aborted
exception

QueryInterval

Object

Uma consulta de banco de dados.

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

QueryMetric

Object

Uma consulta de banco de dados.

Name	Tipo	Description
displayName	string	O nome da métrica para exibição na interface do usuário
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
percentage
KB
microseconds

QueryObservedMetricType

Enumeração

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

Valor	Description
cpu
io
logio
duration
executionCount

QueryStatistic

Object

Uma consulta de banco de dados.

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

TopQueries

Object

Uma consulta de banco de dados.

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

TopQueriesListResult

Object

Representa a resposta a uma solicitação de obter consultas superiores.

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