Managed Database Queries - List By Query

クエリ ID でクエリ実行統計を取得します。

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}

URI パラメーター

名前 / 必須 型 説明
databaseName
path True

string

データベースの名前。

managedInstanceName
path True

string

マネージド インスタンスの名前。

queryId
path True

string

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前の大文字と小文字は区別されません。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

endTime
query

string

観察期間の終了時刻。

interval
query

QueryTimeGrainType

メトリック値の集計に使用する時間ステップ。

startTime
query

string

観察された期間の開始時刻。

応答

名前 型 説明
200 OK

ManagedInstanceQueryStatistics

Azureの運用は無事に完了しました。

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

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

要求のサンプル

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

応答のサンプル

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

要求のサンプル

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

応答のサンプル

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

要求のサンプル

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

応答のサンプル

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

定義

名前 説明
createdByType

リソースを作成した ID の種類。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

ManagedInstanceQueryStatistics

1 つの特定のクエリの実行統計

QueryMetricInterval

クエリ メトリック間隔のプロパティ。

QueryMetricProperties

1 つの間隔での topquery メトリックのプロパティ。

QueryMetricUnitType

メトリックの単位。

QueryStatistics
QueryTimeGrainType

間隔の種類 (長さ)。

systemData

リソースの作成と最後の変更に関連するメタデータ。

createdByType

リソースを作成した ID の種類。

値 説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

ManagedInstanceQueryStatistics

1 つの特定のクエリの実行統計

名前 型 説明
nextLink

string (uri)

項目の次のページへのリンク

value

QueryStatistics[]

このページのQueryStatistics項目

QueryMetricInterval

クエリ メトリック間隔のプロパティ。

名前 型 説明
executionCount

integer (int64)

この間隔でのクエリの実行数。

intervalStartTime

string

メトリック間隔の開始時刻 (ISO-8601 形式)。

intervalType

QueryTimeGrainType

間隔の種類 (長さ)。

metrics

QueryMetricProperties[]

この間隔のメトリック オブジェクトの一覧

QueryMetricProperties

1 つの間隔での topquery メトリックのプロパティ。

名前 型 説明
avg

number (double)

avg() 集計関数が間隔を通して使用される場合のメトリック値。

displayName

string

メトリックの UI の適切な名前。

max

number (double)

max() 集計関数が間隔で使用される場合のメトリック値。

min

number (double)

間隔で min() 集計関数が使用される場合のメトリック値。

name

string

メトリックの名前情報。

stdev

number (double)

stdev 集計関数が間隔を通して使用される場合のメトリック値。

sum

number (double)

sum() 集計関数が間隔を通して使用される場合のメトリック値。

unit

QueryMetricUnitType

メトリックの単位。

value

number (double)

メトリックの値。

QueryMetricUnitType

メトリックの単位。

値 説明
percentage

パーセンテージ

KB

サポート情報

microseconds

マイクロ 秒

count

数える

QueryStatistics

名前 型 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

リソースの名前

properties.databaseName

string

このクエリが実行されたデータベースのデータベース名。

properties.endTime

string

メトリックの終了時刻 (ISO-8601 形式)。

properties.intervals

QueryMetricInterval[]

適切なメトリック データを含む間隔の一覧

properties.queryId

string

一意のクエリ ID (1 つのデータベース内で一意)。

properties.startTime

string

メトリックの開始時刻 (ISO-8601 形式)。

systemData

systemData

create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。

type

string

リソースの型。 例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

QueryTimeGrainType

間隔の種類 (長さ)。

値 説明
PT1H

PT1H

P1D

P1D

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。