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 パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
database
|
path | True |
string |
データベースの名前。 |
|
managed
|
path | True |
string |
マネージド インスタンスの名前。 |
|
query
|
path | True |
string |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前の大文字と小文字は区別されません。 |
|
subscription
|
path | True |
string (uuid) |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
|
end
|
query |
string |
観察期間の終了時刻。 |
|
|
interval
|
query |
メトリック値の集計に使用する時間ステップ。 |
||
|
start
|
query |
string |
観察された期間の開始時刻。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
Azureの運用は無事に完了しました。 |
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
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"
}
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
created |
リソースを作成した ID の種類。 |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Managed |
1 つの特定のクエリの実行統計 |
|
Query |
クエリ メトリック間隔のプロパティ。 |
|
Query |
1 つの間隔での topquery メトリックのプロパティ。 |
|
Query |
メトリックの単位。 |
|
Query |
|
|
Query |
間隔の種類 (長さ)。 |
|
system |
リソースの作成と最後の変更に関連するメタデータ。 |
createdByType
リソースを作成した ID の種類。
| 値 | 説明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
ManagedInstanceQueryStatistics
1 つの特定のクエリの実行統計
| 名前 | 型 | 説明 |
|---|---|---|
| nextLink |
string (uri) |
項目の次のページへのリンク |
| value |
このページのQueryStatistics項目 |
QueryMetricInterval
クエリ メトリック間隔のプロパティ。
| 名前 | 型 | 説明 |
|---|---|---|
| executionCount |
integer (int64) |
この間隔でのクエリの実行数。 |
| intervalStartTime |
string |
メトリック間隔の開始時刻 (ISO-8601 形式)。 |
| intervalType |
間隔の種類 (長さ)。 |
|
| metrics |
この間隔のメトリック オブジェクトの一覧 |
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 |
メトリックの単位。 |
|
| 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 |
適切なメトリック データを含む間隔の一覧 |
|
| properties.queryId |
string |
一意のクエリ ID (1 つのデータベース内で一意)。 |
| properties.startTime |
string |
メトリックの開始時刻 (ISO-8601 形式)。 |
| 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 |
リソースを作成した ID の種類。 |
|
| lastModifiedAt |
string (date-time) |
リソースの最終変更のタイムスタンプ (UTC) |
| lastModifiedBy |
string |
リソースを最後に変更した ID。 |
| lastModifiedByType |
リソースを最後に変更した ID の種類。 |