Queries - List By Database

Service:: SQL Database

Version d'API:: 2014-04-01

Obtient la liste des principales requêtes par base de données.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Nom du serveur.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	TopQueriesListResult	D’ACCORD

Exemples

List top queries

Exemple de requête

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

Exemple de réponse

Code d’état:: 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
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Définitions

Nom	Description
QueryAggregationFunction	Fonction utilisée pour agréger les métriques de chaque requête.
QueryExecutionType	Type d’exécution utilisé pour filtrer les instances de requête retournées.
QueryInterval	Requête de base de données.
QueryMetric	Requête de base de données.
QueryMetricUnit	Unité de mesure
QueryObservedMetricType	Type de métrique à utiliser pour classer les métriques principales.
QueryStatistic	Requête de base de données.
TopQueries	Requête de base de données.
TopQueriesListResult	Représente la réponse à une requête obtenir les requêtes principales.

QueryAggregationFunction

Énumération

Fonction utilisée pour agréger les métriques de chaque requête.

Valeur	Description
min
max
avg
sum

QueryExecutionType

Énumération

Type d’exécution utilisé pour filtrer les instances de requête retournées.

Valeur	Description
any
regular
irregular
aborted
exception

QueryInterval

Objet

Requête de base de données.

Nom	Type	Description
executionCount	number (int32)	Nombre de fois où la requête a été exécutée pendant cet intervalle.
intervalStartTime	string (date-time)	Heure de début de l’intervalle de mesure (format ISO8601).
metrics	QueryMetric[]	Liste des métriques de requête pendant cet intervalle.

QueryMetric

Objet

Requête de base de données.

Nom	Type	Description
displayName	string	Nom de la métrique à afficher dans l’interface utilisateur
name	string	Nom de la métrique
unit	QueryMetricUnit	Unité de mesure
value	number (double)	Valeur mesurée

QueryMetricUnit

Énumération

Unité de mesure

Valeur	Description
percentage
KB
microseconds

QueryObservedMetricType

Énumération

Type de métrique à utiliser pour classer les métriques principales.

Valeur	Description
cpu
io
logio
duration
executionCount

QueryStatistic

Objet

Requête de base de données.

Nom	Type	Description
intervals	QueryInterval[]	Liste des intervalles de requête.
queryId	string	ID de la requête

TopQueries

Objet

Requête de base de données.

Nom	Type	Description
aggregationFunction	QueryAggregationFunction	Fonction utilisée pour agréger les métriques de chaque requête.
executionType	QueryExecutionType	Type d’exécution utilisé pour filtrer les instances de requête retournées.
intervalType	string	Durée de l’intervalle (format de durée ISO8601).
numberOfTopQueries	number (int32)	Nombre de requêtes demandées.
observationEndTime	string (date-time)	Heure de fin des requêtes retournées (format ISO8601)
observationStartTime	string (date-time)	Heure de début des requêtes retournées (format ISO8601)
observedMetric	QueryObservedMetricType	Type de métrique à utiliser pour classer les métriques principales.
queries	QueryStatistic[]	Liste des requêtes.

TopQueriesListResult

Objet

Représente la réponse à une requête obtenir les requêtes principales.

Nom	Type	Description
value	TopQueries[]	Liste des requêtes principales.