Queries - List By Database

Servizio:

SQL Database

Versione API:

2014-04-01

Ottiene un elenco delle query principali in base al database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName	path	True	string	Il nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	TopQueriesListResult	Va bene

Esempio

List top queries

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
QueryAggregationFunction	Funzione usata per aggregare le metriche di ogni query.
QueryExecutionType	Tipo di esecuzione utilizzato per filtrare le istanze di query restituite.
QueryInterval	Query di database.
QueryMetric	Query di database.
QueryMetricUnit	Unità di misura
QueryObservedMetricType	Tipo di metrica da usare per ordinare le metriche principali.
QueryStatistic	Query di database.
TopQueries	Query di database.
TopQueriesListResult	Rappresenta la risposta a una richiesta di recupero delle query principali.

QueryAggregationFunction

Enumerazione

Funzione usata per aggregare le metriche di ogni query.

Valore	Descrizione
min
max
avg
sum

QueryExecutionType

Enumerazione

Tipo di esecuzione utilizzato per filtrare le istanze di query restituite.

Valore	Descrizione
any
regular
irregular
aborted
exception

QueryInterval

Oggetto

Query di database.

Nome	Tipo	Descrizione
executionCount	number (int32)	Numero di esecuzioni della query durante questo intervallo.
intervalStartTime	string (date-time)	Ora di inizio dell'intervallo di misurazione (formato ISO8601).
metrics	QueryMetric[]	Elenco delle metriche di query durante questo intervallo.

QueryMetric

Oggetto

Query di database.

Nome	Tipo	Descrizione
displayName	string	Nome della metrica da visualizzare nell'interfaccia utente
name	string	Nome della metrica
unit	QueryMetricUnit	Unità di misura
value	number (double)	Valore misurato

QueryMetricUnit

Enumerazione

Unità di misura

Valore	Descrizione
percentage
KB
microseconds

QueryObservedMetricType

Enumerazione

Tipo di metrica da usare per ordinare le metriche principali.

Valore	Descrizione
cpu
io
logio
duration
executionCount

QueryStatistic

Oggetto

Query di database.

Nome	Tipo	Descrizione
intervals	QueryInterval[]	Elenco di intervalli di query.
queryId	string	ID della query

TopQueries

Oggetto

Query di database.

Nome	Tipo	Descrizione
aggregationFunction	QueryAggregationFunction	Funzione usata per aggregare le metriche di ogni query.
executionType	QueryExecutionType	Tipo di esecuzione utilizzato per filtrare le istanze di query restituite.
intervalType	string	Durata dell'intervallo (formato ISO8601 durata).
numberOfTopQueries	number (int32)	Numero di query richieste.
observationEndTime	string (date-time)	Ora di fine per le query restituite (formato ISO8601)
observationStartTime	string (date-time)	Ora di inizio per le query restituite (formato ISO8601)
observedMetric	QueryObservedMetricType	Tipo di metrica da usare per ordinare le metriche principali.
queries	QueryStatistic[]	Elenco di query.

TopQueriesListResult

Oggetto

Rappresenta la risposta a una richiesta di recupero delle query principali.

Nome	Tipo	Descrizione
value	TopQueries[]	Elenco delle query principali.