Queries - List By Database

Dienst:

SQL Database

API-Version:

2014-04-01

Ruft eine Liste der wichtigsten Abfragen nach Datenbank ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	TopQueriesListResult	OK

Beispiele

List top queries

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
QueryAggregationFunction	Die Funktion, die zum Aggregieren der Metriken jeder Abfrage verwendet wird.
QueryExecutionType	Der Ausführungstyp, der zum Filtern der zurückgegebenen Abfrageinstanzen verwendet wird.
QueryInterval	Eine Datenbankabfrage.
QueryMetric	Eine Datenbankabfrage.
QueryMetricUnit	Die Maßeinheit
QueryObservedMetricType	Der Typ der Metrik, die zum Sortieren der wichtigsten Metriken verwendet werden soll.
QueryStatistic	Eine Datenbankabfrage.
TopQueries	Eine Datenbankabfrage.
TopQueriesListResult	Stellt die Antwort auf eine Anforderung zum Abrufen der wichtigsten Abfragen dar.

QueryAggregationFunction

Die Funktion, die zum Aggregieren der Metriken jeder Abfrage verwendet wird.

Name	Typ	Beschreibung
avg	string
max	string
min	string
sum	string

QueryExecutionType

Der Ausführungstyp, der zum Filtern der zurückgegebenen Abfrageinstanzen verwendet wird.

Name	Typ	Beschreibung
aborted	string
any	string
exception	string
irregular	string
regular	string

QueryInterval

Eine Datenbankabfrage.

Name	Typ	Beschreibung
executionCount	number	Gibt an, wie oft die Abfrage während dieses Intervalls ausgeführt wurde.
intervalStartTime	string	Die Startzeit des Messintervalls (ISO8601 Format).
metrics	QueryMetric[]	Die Liste der Abfragemetriken während dieses Intervalls.

QueryMetric

Eine Datenbankabfrage.

Name	Typ	Beschreibung
displayName	string	Der Name der Metrik für die Anzeige in der Benutzeroberfläche
name	string	Name der Metrik
unit	QueryMetricUnit	Die Maßeinheit
value	number	Der gemessene Wert

QueryMetricUnit

Die Maßeinheit

Name	Typ	Beschreibung
KB	string
microseconds	string
percentage	string

QueryObservedMetricType

Der Typ der Metrik, die zum Sortieren der wichtigsten Metriken verwendet werden soll.

Name	Typ	Beschreibung
cpu	string
duration	string
executionCount	string
io	string
logio	string

QueryStatistic

Eine Datenbankabfrage.

Name	Typ	Beschreibung
intervals	QueryInterval[]	Die Liste der Abfrageintervalle.
queryId	string	Die ID der Abfrage

TopQueries

Eine Datenbankabfrage.

Name	Typ	Beschreibung
aggregationFunction	QueryAggregationFunction	Die Funktion, die zum Aggregieren der Metriken jeder Abfrage verwendet wird.
executionType	QueryExecutionType	Der Ausführungstyp, der zum Filtern der zurückgegebenen Abfrageinstanzen verwendet wird.
intervalType	string	Die Dauer des Intervalls (ISO8601 Dauerformat).
numberOfTopQueries	number	Die Anzahl der angeforderten Abfragen.
observationEndTime	string	Die Endzeit für zurückgegebene Abfragen (ISO8601 Format)
observationStartTime	string	Die Startzeit für zurückgegebene Abfragen (ISO8601 Format)
observedMetric	QueryObservedMetricType	Der Typ der Metrik, die zum Sortieren der wichtigsten Metriken verwendet werden soll.
queries	QueryStatistic[]	Die Liste der Abfragen.

TopQueriesListResult

Stellt die Antwort auf eine Anforderung zum Abrufen der wichtigsten Abfragen dar.

Name	Typ	Beschreibung
value	TopQueries[]	Die Liste der wichtigsten Abfragen.