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. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	TopQueriesListResult	OKAY

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

Enumeration

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

Wert	Beschreibung
min
max
avg
sum

QueryExecutionType

Enumeration

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

Wert	Beschreibung
any
regular
irregular
aborted
exception

QueryInterval

Objekt

Eine Datenbankabfrage.

Name	Typ	Beschreibung
executionCount	number (int32)	Die Häufigkeit, mit der die Abfrage während dieses Intervalls ausgeführt wurde.
intervalStartTime	string (date-time)	Die Startzeit des Messintervalls (ISO8601 Format).
metrics	QueryMetric[]	Die Liste der Abfragemetriken während dieses Intervalls.

QueryMetric

Objekt

Eine Datenbankabfrage.

Name	Typ	Beschreibung
displayName	string	Der Name der Metrik für die Anzeige auf der Benutzeroberfläche
name	string	Der Name der Metrik
unit	QueryMetricUnit	Die Maßeinheit
value	number (double)	Der Gemessene Wert

QueryMetricUnit

Enumeration

Die Maßeinheit

Wert	Beschreibung
percentage
KB
microseconds

QueryObservedMetricType

Enumeration

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

Wert	Beschreibung
cpu
io
logio
duration
executionCount

QueryStatistic

Objekt

Eine Datenbankabfrage.

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

TopQueries

Objekt

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 (int32)	Die Anzahl der angeforderten Abfragen.
observationEndTime	string (date-time)	Die Endzeit für zurückgegebene Abfragen (ISO8601 Format)
observationStartTime	string (date-time)	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

Objekt

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

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