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	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’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	Ok

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 demande get top requêtes.

QueryAggregationFunction

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

Nom	Type	Description
avg	string
max	string
min	string
sum	string

QueryExecutionType

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

Nom	Type	Description
aborted	string
any	string
exception	string
irregular	string
regular	string

QueryInterval

Requête de base de données.

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

QueryMetric

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 mesure
unit	QueryMetricUnit	Unité de mesure
value	number	Valeur mesurée

QueryMetricUnit

Unité de mesure

Nom	Type	Description
KB	string
microseconds	string
percentage	string

QueryObservedMetricType

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

Nom	Type	Description
cpu	string
duration	string
executionCount	string
io	string
logio	string

QueryStatistic

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

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 ISO8601 durée).
numberOfTopQueries	number	Nombre de requêtes demandées.
observationEndTime	string	Heure de fin des requêtes retournées (format ISO8601)
observationStartTime	string	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

Représente la réponse à une demande get top requêtes.

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