Managed Database Queries - List By Query
Obtenir des statistiques d’exécution de requête par ID de requête.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/queries/{queryId}/statistics?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/queries/{queryId}/statistics?startTime={startTime}&endTime={endTime}&interval={interval}&api-version=2021-11-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
database
|
path | True |
string |
Nom de la base de données. |
managed
|
path | True |
string |
Nom de l'instance managée. |
query
|
path | True |
string |
|
resource
|
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. |
subscription
|
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. |
end
|
query |
string |
Heure de fin de la période observée. |
|
interval
|
query |
Étape de temps à utiliser pour résumer les valeurs de métrique. |
||
start
|
query |
string |
Heure de début de la période observée. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Texte de requête récupéré avec succès. |
|
Other Status Codes |
Réponses d’erreur : ***
|
Exemples
Obtain query execution statistics |
Obtain query execution statistics. Example with all request parameters. |
Obtain query execution statistics. Minimal example with only mandatory request parameters. |
Obtain query execution statistics
Sample Request
Sample Response
{
"value": [
{
"properties": {
"databaseName": "db1",
"queryId": "35",
"startTime": "03/01/2020 18:34:58",
"endTime": "03/02/2020 18:34:58",
"intervals": [
{
"intervalStartTime": "03/02/2020 08:00:00",
"intervalType": "PT1H",
"executionCount": 160,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0,
"min": 1.507638888888889E-05,
"max": 2.5243055555555557E-05,
"avg": 1.665347222222222E-05,
"sum": 0.0026645555555555554,
"stdev": 1.4894345929850385E-06
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 0,
"min": 4373,
"max": 18490,
"avg": 5026.625,
"sum": 804260,
"stdev": 1487.3520882343225
}
]
},
{
"intervalStartTime": "03/02/2020 09:00:00",
"intervalType": "PT1H",
"executionCount": 20,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0,
"min": 2.3430555555555557E-05,
"max": 0.00014645833333333332,
"avg": 4.479774305555555E-05,
"sum": 0.0008959548611111111,
"stdev": 3.830118344204395E-05
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 0,
"min": 6813,
"max": 42289,
"avg": 12963.2,
"sum": 259264,
"stdev": 11040.140794392071
}
]
},
{
"intervalStartTime": "03/02/2020 15:00:00",
"intervalType": "PT1H",
"executionCount": 80,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0,
"min": 1.8215277777777777E-05,
"max": 2.764236111111111E-05,
"avg": 1.9315538194444445E-05,
"sum": 0.0015452430555555556,
"stdev": 1.0716305801875179E-06
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 0,
"min": 5264,
"max": 7982,
"avg": 5586.2625,
"sum": 446901,
"stdev": 310.4915757210727
}
]
},
{
"intervalStartTime": "03/02/2020 17:00:00",
"intervalType": "PT1H",
"executionCount": 80,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0,
"min": 1.7819444444444443E-05,
"max": 2.782638888888889E-05,
"avg": 1.9085373263888888E-05,
"sum": 0.0015268298611111112,
"stdev": 1.2309244108727927E-06
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 0,
"min": 5147,
"max": 8052,
"avg": 5517.2,
"sum": 441376,
"stdev": 356.8763581410226
}
]
}
]
},
"id": "35",
"type": "Microsoft.Sql/managedInstances/databases/queries/statistics"
}
]
}
Obtain query execution statistics. Example with all request parameters.
Sample Request
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/databases/database_1/queries/42/statistics?startTime=03/01/2020 16:23:09&endTime=03/11/2020 14:00:00&interval=P1D&api-version=2021-11-01
Sample Response
{
"value": [
{
"properties": {
"databaseName": "db1",
"queryId": "28",
"startTime": "03/01/2020 16:23:09",
"endTime": "03/11/2020 14:00:00",
"intervals": [
{
"intervalStartTime": "03/11/2020 00:00:00",
"intervalType": "P1D",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0,
"min": 0.0015934667245370371,
"max": 0.0015934667245370371,
"avg": 0.0015934667245370371,
"sum": 0.0015934667245370371,
"stdev": 0
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0,
"min": 4.224537037037037E-06,
"max": 4.224537037037037E-06,
"avg": 4.224537037037037E-06,
"sum": 4.224537037037037E-06,
"stdev": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0,
"min": 8336,
"max": 8336,
"avg": 8336,
"sum": 8336,
"stdev": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 0,
"min": 11091296,
"max": 11091296,
"avg": 11091296,
"sum": 11091296,
"stdev": 0
}
]
}
]
},
"id": "28",
"type": "Microsoft.Sql/managedInstances/databases/queries/statistics"
}
]
}
Obtain query execution statistics. Minimal example with only mandatory request parameters.
Sample Request
Sample Response
{
"value": [
{
"properties": {
"databaseName": "db1",
"queryId": "28",
"startTime": "03/10/2020 14:00:30",
"endTime": "03/11/2020 14:00:30",
"intervals": [
{
"intervalStartTime": "03/11/2020 11:00:00",
"intervalType": "PT1H",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0,
"min": 0.03824320138888889,
"max": 0.03824320138888889,
"avg": 0.03824320138888889,
"sum": 0.03824320138888889,
"stdev": 0
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0,
"min": 0.0001013888888888889,
"max": 0.0001013888888888889,
"avg": 0.0001013888888888889,
"sum": 0.0001013888888888889,
"stdev": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0,
"min": 0,
"max": 0,
"avg": 0,
"sum": 0,
"stdev": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0,
"min": 8336,
"max": 8336,
"avg": 8336,
"sum": 8336,
"stdev": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 0,
"min": 11091296,
"max": 11091296,
"avg": 11091296,
"sum": 11091296,
"stdev": 0
}
]
}
]
},
"id": "28",
"type": "Microsoft.Sql/managedInstances/databases/queries/statistics"
}
]
}
Définitions
Nom | Description |
---|---|
Managed |
Statistiques d’exécution pour une requête particulière |
Query |
Propriétés d’un intervalle de métriques de requête. |
Query |
Propriétés d’une métrique topquery dans un intervalle. |
Query |
Unité de la métrique. |
Query |
|
Query |
Type d’intervalle (longueur). |
ManagedInstanceQueryStatistics
Statistiques d’exécution pour une requête particulière
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien pour récupérer la page de résultats suivante. |
value |
Tableau de résultats. |
QueryMetricInterval
Propriétés d’un intervalle de métriques de requête.
Nom | Type | Description |
---|---|---|
executionCount |
integer |
Nombre d’exécutions d’une requête dans cet intervalle. |
intervalStartTime |
string |
Heure de début de l’intervalle de métrique (format ISO-8601). |
intervalType |
Type d’intervalle (longueur). |
|
metrics |
Liste des objets de métrique pour cet intervalle |
QueryMetricProperties
Propriétés d’une métrique topquery dans un intervalle.
Nom | Type | Description |
---|---|---|
avg |
number |
Valeur de métrique lorsque la fonction d’agrégation avg() est utilisée sur l’intervalle. |
displayName |
string |
Nom approprié de l’interface utilisateur pour la métrique. |
max |
number |
Valeur de métrique lorsque la fonction d’agrégation max() est utilisée sur l’intervalle. |
min |
number |
Valeur de métrique lorsque la fonction d’agrégation min() est utilisée sur l’intervalle. |
name |
string |
Informations de nom pour la métrique. |
stdev |
number |
Valeur de métrique lorsque la fonction d’agrégation stdev est utilisée sur l’intervalle. |
sum |
number |
Valeur de métrique lorsque la fonction d’agrégation sum() est utilisée sur l’intervalle. |
unit |
Unité de la métrique. |
|
value |
number |
Valeur de la métrique. |
QueryMetricUnitType
Unité de la métrique.
Nom | Type | Description |
---|---|---|
KB |
string |
|
count |
string |
|
microseconds |
string |
|
percentage |
string |
QueryStatistics
Nom | Type | Description |
---|---|---|
id |
string |
ID de la ressource |
name |
string |
Nom de la ressource. |
properties.databaseName |
string |
Nom de la base de données dans laquelle cette requête a été exécutée. |
properties.endTime |
string |
Heure de fin de la métrique (format ISO-8601). |
properties.intervals |
Liste des intervalles avec les données de métrique appropriées |
|
properties.queryId |
string |
ID de requête unique (unique au sein d’une base de données). |
properties.startTime |
string |
Heure de début de la métrique (format ISO-8601). |
type |
string |
Type de ressource. |
QueryTimeGrainType
Type d’intervalle (longueur).
Nom | Type | Description |
---|---|---|
P1D |
string |
|
PT1H |
string |