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 de URI

Nome	Em	Obrigató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 na API do Azure Resource Manager ou no portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID da 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

Nome	Tipo	Description
200 OK	TopQueriesListResult	OKEY

Exemplos

List top queries

Solicitação de exemplo

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 de exemplo

Código de status:: 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

Nome	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 usado para ordenar as principais métricas.
QueryStatistic	Uma consulta de banco de dados.
TopQueries	Uma consulta de banco de dados.
TopQueriesListResult	Representa a resposta a uma solicitação obter as principais consultas.

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

Objeto

Uma consulta de banco de dados.

Nome	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 medida (formato ISO8601).
metrics	QueryMetric[]	A lista de métricas de consulta durante esse intervalo.

QueryMetric

Objeto

Uma consulta de banco de dados.

Nome	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 usado para ordenar as principais métricas.

Valor	Description
cpu
io
logio
duration
executionCount

QueryStatistic

Objeto

Uma consulta de banco de dados.

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

TopQueries

Objeto

Uma consulta de banco de dados.

Nome	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 (ISO8601 formato de 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 usado para ordenar as principais métricas.
queries	QueryStatistic[]	A lista de consultas.

TopQueriesListResult

Objeto

Representa a resposta a uma solicitação obter as principais consultas.

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