Managed Database Queries - List By Query

Obtenha estatísticas de execução de consulta por ID de consulta.

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}

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
databaseName
path True

string

O nome do banco de dados.

managedInstanceName
path True

string

O nome da instância gerenciada.

queryId
path True

string

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

endTime
query

string

Tempo de término para o período observado.

interval
query

QueryTimeGrainType

A etapa de tempo a ser usada para resumir os valores métricos.

startTime
query

string

Hora de início para o período observado.

Respostas

Name Tipo Descrição
200 OK

ManagedInstanceQueryStatistics

Operação do Azure concluída com sucesso.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

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

Pedido de amostra

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

Resposta da amostra

{
  "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.

Pedido de amostra

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

Resposta da amostra

{
  "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.

Pedido de amostra

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

Resposta da amostra

{
  "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"
      }
    }
  ]
}

Definições

Name Descrição
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ManagedInstanceQueryStatistics

Estatísticas de execução para uma consulta específica

QueryMetricInterval

Propriedades de um intervalo de métricas de consulta.

QueryMetricProperties

Propriedades de uma métrica topquery em um intervalo.

QueryMetricUnitType

A unidade da métrica.

QueryStatistics
QueryTimeGrainType

Tipo de intervalo (comprimento).

systemData

Metadados referentes à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Descrição
error

ErrorDetail

O objeto de erro.

ManagedInstanceQueryStatistics

Estatísticas de execução para uma consulta específica

Name Tipo Descrição
nextLink

string (uri)

O link para a próxima página de itens

value

QueryStatistics[]

Os itens QueryStatistics nesta página

QueryMetricInterval

Propriedades de um intervalo de métricas de consulta.

Name Tipo Descrição
executionCount

integer (int64)

Contagem de execução de uma consulta neste intervalo.

intervalStartTime

string

A hora de início para o intervalo métrico (formato ISO-8601).

intervalType

QueryTimeGrainType

Tipo de intervalo (comprimento).

metrics

QueryMetricProperties[]

Lista de objetos métricos para este intervalo

QueryMetricProperties

Propriedades de uma métrica topquery em um intervalo.

Name Tipo Descrição
avg

number (double)

Valor métrico quando a função de agregação avg() é usada no intervalo.

displayName

string

O nome apropriado da interface do usuário para a métrica.

max

number (double)

Valor métrico quando a função de agregação max() é usada ao longo do intervalo.

min

number (double)

Valor métrico quando a função de agregação min() é usada no intervalo.

name

string

As informações de nome para a métrica.

stdev

number (double)

Valor métrico quando a função de agregação stdev é usada no intervalo.

sum

number (double)

Valor métrico quando a função de agregação sum() é usada ao longo do intervalo.

unit

QueryMetricUnitType

A unidade da métrica.

value

number (double)

O valor da métrica.

QueryMetricUnitType

A unidade da métrica.

Valor Descrição
percentage

percentagem

KB

BDC

microseconds

microssegundos

count

contagem

QueryStatistics

Name Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.databaseName

string

Nome do banco de dados do banco de dados no qual essa consulta foi executada.

properties.endTime

string

A hora de término da métrica (formato ISO-8601).

properties.intervals

QueryMetricInterval[]

Lista de intervalos com dados métricos adequados

properties.queryId

string

ID de consulta exclusiva (exclusiva dentro de um banco de dados).

properties.startTime

string

A hora de início da métrica (formato ISO-8601).

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

QueryTimeGrainType

Tipo de intervalo (comprimento).

Valor Descrição
PT1H

PT1H

P1D

P1D

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Descrição
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.