Managed Database Queries - List By Query

Obtenir les 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=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/queries/{queryId}/statistics?api-version=2025-01-01&startTime={startTime}&endTime={endTime}&interval={interval}

Paramètres URI

Nom Dans Obligatoire Type Description
databaseName
path True

string

Nom de la base de données.

managedInstanceName
path True

string

Nom de l’instance managée.

queryId
path True

string

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

endTime
query

string

Heure de fin de la période observée.

interval
query

QueryTimeGrainType

Étape de temps à utiliser pour résumer les valeurs de métriques.

startTime
query

string

Heure de début de la période observée.

Réponses

Nom Type Description
200 OK

ManagedInstanceQueryStatistics

Opération Azure terminée avec succès.

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

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

Exemple de requête

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?api-version=2025-01-01

Exemple de réponse

{
  "value": [
    {
      "type": "Microsoft.Sql/managedInstances/databases/queries/statistics",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/databases/database_1/queries/42/statistics/35",
      "properties": {
        "databaseName": "db1",
        "endTime": "03/02/2020 18:34:58",
        "intervals": [
          {
            "executionCount": 160,
            "intervalStartTime": "03/02/2020 08:00:00",
            "intervalType": "PT1H",
            "metrics": [
              {
                "name": "cpu",
                "avg": 1.665347222222222E-05,
                "displayName": "Cpu",
                "max": 2.5243055555555557E-05,
                "min": 1.507638888888889E-05,
                "stdev": 1.4894345929850385E-06,
                "sum": 0.0026645555555555554,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "io",
                "avg": 0,
                "displayName": "Physical Io Reads",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "logIo",
                "avg": 0,
                "displayName": "Log Writes",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "memory",
                "avg": 0,
                "displayName": "Memory consumption",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "KB",
                "value": 0
              },
              {
                "name": "duration",
                "avg": 5026.625,
                "displayName": "Query duration",
                "max": 18490,
                "min": 4373,
                "stdev": 1487.3520882343225,
                "sum": 804260,
                "unit": "microseconds",
                "value": 0
              }
            ]
          },
          {
            "executionCount": 20,
            "intervalStartTime": "03/02/2020 09:00:00",
            "intervalType": "PT1H",
            "metrics": [
              {
                "name": "cpu",
                "avg": 4.479774305555555E-05,
                "displayName": "Cpu",
                "max": 0.00014645833333333332,
                "min": 2.3430555555555557E-05,
                "stdev": 3.830118344204395E-05,
                "sum": 0.0008959548611111111,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "io",
                "avg": 0,
                "displayName": "Physical Io Reads",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "logIo",
                "avg": 0,
                "displayName": "Log Writes",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "memory",
                "avg": 0,
                "displayName": "Memory consumption",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "KB",
                "value": 0
              },
              {
                "name": "duration",
                "avg": 12963.2,
                "displayName": "Query duration",
                "max": 42289,
                "min": 6813,
                "stdev": 11040.140794392071,
                "sum": 259264,
                "unit": "microseconds",
                "value": 0
              }
            ]
          },
          {
            "executionCount": 80,
            "intervalStartTime": "03/02/2020 15:00:00",
            "intervalType": "PT1H",
            "metrics": [
              {
                "name": "cpu",
                "avg": 1.9315538194444445E-05,
                "displayName": "Cpu",
                "max": 2.764236111111111E-05,
                "min": 1.8215277777777777E-05,
                "stdev": 1.0716305801875179E-06,
                "sum": 0.0015452430555555556,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "io",
                "avg": 0,
                "displayName": "Physical Io Reads",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "logIo",
                "avg": 0,
                "displayName": "Log Writes",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "memory",
                "avg": 0,
                "displayName": "Memory consumption",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "KB",
                "value": 0
              },
              {
                "name": "duration",
                "avg": 5586.2625,
                "displayName": "Query duration",
                "max": 7982,
                "min": 5264,
                "stdev": 310.4915757210727,
                "sum": 446901,
                "unit": "microseconds",
                "value": 0
              }
            ]
          },
          {
            "executionCount": 80,
            "intervalStartTime": "03/02/2020 17:00:00",
            "intervalType": "PT1H",
            "metrics": [
              {
                "name": "cpu",
                "avg": 1.9085373263888888E-05,
                "displayName": "Cpu",
                "max": 2.782638888888889E-05,
                "min": 1.7819444444444443E-05,
                "stdev": 1.2309244108727927E-06,
                "sum": 0.0015268298611111112,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "io",
                "avg": 0,
                "displayName": "Physical Io Reads",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "logIo",
                "avg": 0,
                "displayName": "Log Writes",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "memory",
                "avg": 0,
                "displayName": "Memory consumption",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "KB",
                "value": 0
              },
              {
                "name": "duration",
                "avg": 5517.2,
                "displayName": "Query duration",
                "max": 8052,
                "min": 5147,
                "stdev": 356.8763581410226,
                "sum": 441376,
                "unit": "microseconds",
                "value": 0
              }
            ]
          }
        ],
        "queryId": "35",
        "startTime": "03/01/2020 18:34:58"
      }
    }
  ]
}

Obtain query execution statistics. Example with all request parameters.

Exemple de requête

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?api-version=2025-01-01&startTime=03/01/2020 16:23:09&endTime=03/11/2020 14:00:00&interval=P1D

Exemple de réponse

{
  "value": [
    {
      "type": "Microsoft.Sql/managedInstances/databases/queries/statistics",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/databases/database_1/queries/42/statistics/28",
      "properties": {
        "databaseName": "db1",
        "endTime": "03/11/2020 14:00:00",
        "intervals": [
          {
            "executionCount": 1,
            "intervalStartTime": "03/11/2020 00:00:00",
            "intervalType": "P1D",
            "metrics": [
              {
                "name": "cpu",
                "avg": 0.0015934667245370371,
                "displayName": "Cpu",
                "max": 0.0015934667245370371,
                "min": 0.0015934667245370371,
                "stdev": 0,
                "sum": 0.0015934667245370371,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "io",
                "avg": 4.224537037037037E-06,
                "displayName": "Physical Io Reads",
                "max": 4.224537037037037E-06,
                "min": 4.224537037037037E-06,
                "stdev": 0,
                "sum": 4.224537037037037E-06,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "logIo",
                "avg": 0,
                "displayName": "Log Writes",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "memory",
                "avg": 8336,
                "displayName": "Memory consumption",
                "max": 8336,
                "min": 8336,
                "stdev": 0,
                "sum": 8336,
                "unit": "KB",
                "value": 0
              },
              {
                "name": "duration",
                "avg": 11091296,
                "displayName": "Query duration",
                "max": 11091296,
                "min": 11091296,
                "stdev": 0,
                "sum": 11091296,
                "unit": "microseconds",
                "value": 0
              }
            ]
          }
        ],
        "queryId": "28",
        "startTime": "03/01/2020 16:23:09"
      }
    }
  ]
}

Obtain query execution statistics. Minimal example with only mandatory request parameters.

Exemple de requête

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?api-version=2025-01-01&interval=PT1H

Exemple de réponse

{
  "value": [
    {
      "type": "Microsoft.Sql/managedInstances/databases/queries/statistics",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/databases/database_1/queries/42/statistics/28",
      "properties": {
        "databaseName": "db1",
        "endTime": "03/11/2020 14:00:30",
        "intervals": [
          {
            "executionCount": 1,
            "intervalStartTime": "03/11/2020 11:00:00",
            "intervalType": "PT1H",
            "metrics": [
              {
                "name": "cpu",
                "avg": 0.03824320138888889,
                "displayName": "Cpu",
                "max": 0.03824320138888889,
                "min": 0.03824320138888889,
                "stdev": 0,
                "sum": 0.03824320138888889,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "io",
                "avg": 0.0001013888888888889,
                "displayName": "Physical Io Reads",
                "max": 0.0001013888888888889,
                "min": 0.0001013888888888889,
                "stdev": 0,
                "sum": 0.0001013888888888889,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "logIo",
                "avg": 0,
                "displayName": "Log Writes",
                "max": 0,
                "min": 0,
                "stdev": 0,
                "sum": 0,
                "unit": "percentage",
                "value": 0
              },
              {
                "name": "memory",
                "avg": 8336,
                "displayName": "Memory consumption",
                "max": 8336,
                "min": 8336,
                "stdev": 0,
                "sum": 8336,
                "unit": "KB",
                "value": 0
              },
              {
                "name": "duration",
                "avg": 11091296,
                "displayName": "Query duration",
                "max": 11091296,
                "min": 11091296,
                "stdev": 0,
                "sum": 11091296,
                "unit": "microseconds",
                "value": 0
              }
            ]
          }
        ],
        "queryId": "28",
        "startTime": "03/10/2020 14:00:30"
      }
    }
  ]
}

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ManagedInstanceQueryStatistics

Statistiques d’exécution pour une requête particulière

QueryMetricInterval

Propriétés d’un intervalle de métriques de requête.

QueryMetricProperties

Propriétés d’une métrique topquery dans un intervalle.

QueryMetricUnitType

Unité de la métrique.

QueryStatistics
QueryTimeGrainType

Type d’intervalle (longueur).

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ManagedInstanceQueryStatistics

Statistiques d’exécution pour une requête particulière

Nom Type Description
nextLink

string (uri)

Lien vers la page suivante des éléments

value

QueryStatistics[]

Les éléments QueryStatistics sur cette page

QueryMetricInterval

Propriétés d’un intervalle de métriques de requête.

Nom Type Description
executionCount

integer (int64)

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

QueryTimeGrainType

Type d’intervalle (longueur).

metrics

QueryMetricProperties[]

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 (double)

Valeur de métrique lorsque la fonction d’agrégation avg() est utilisée au cours de l’intervalle.

displayName

string

Nom approprié de l’interface utilisateur pour la métrique.

max

number (double)

Valeur de métrique lorsque la fonction d’agrégation max() est utilisée au cours de l’intervalle.

min

number (double)

Valeur de métrique lorsque la fonction d’agrégation min() est utilisée au cours de l’intervalle.

name

string

Informations de nom pour la métrique.

stdev

number (double)

Valeur de métrique lorsque la fonction d’agrégation stdev est utilisée au cours de l’intervalle.

sum

number (double)

Valeur de métrique lorsque la fonction d’agrégation sum() est utilisée sur l’intervalle.

unit

QueryMetricUnitType

Unité de la métrique.

value

number (double)

Valeur de la métrique.

QueryMetricUnitType

Unité de la métrique.

Valeur Description
percentage

pourcentage

KB

Ko

microseconds

Microsecondes

count

count

QueryStatistics

Nom Type Description
id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

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

QueryMetricInterval[]

Liste des intervalles avec les données de métrique appropriées

properties.queryId

string

ID de requête unique (unique dans une base de données).

properties.startTime

string

Heure de début de la métrique (format ISO-8601).

systemData

systemData

Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy.

type

string

Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts"

QueryTimeGrainType

Type d’intervalle (longueur).

Valeur Description
PT1H

PT1H

P1D

P1D

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.