指定された期間内の自動 SQL 最適化イベントに関する統計 (最適化イベントの合計数や最大改善率など) をクエリします。
操作説明
この API を呼び出す前に、次の点にご注意ください。
Alibaba Cloud SDK または Database Autonomy Service (DAS) SDK を使用してこの API 操作を呼び出す場合は、最新バージョンの SDK を使用することを推奨します。
SDK を使用して DAS の API 操作を呼び出す場合は、リージョン ID を cn-shanghai に設定する必要があります。
データベースエンジンは ApsaraDB RDS for MySQL または PolarDB for MySQL です。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
hdm:GetInstanceSqlOptimizeStatistic |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceId |
string |
必須 |
データベースインスタンス ID。 説明
データベースインスタンスは、ApsaraDB RDS for MySQL インスタンスまたは PolarDB for MySQL クラスターである必要があります。 |
pc-wz90h9560rvdz**** |
| StartTime |
string |
必須 |
クエリする時間範囲の開始時刻。 このパラメーターには、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプを設定します。 |
1661308902060 |
| EndTime |
string |
必須 |
クエリする時間範囲の終了時刻。 このパラメーターには、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプを設定します。 |
1662518540764 |
| NodeId |
string |
任意 |
ノード ID。 説明
ApsaraDB RDS for MySQL クラスター版インスタンスまたは PolarDB for MySQL クラスターの場合は、ノード ID を指定する必要があります。 |
pi-bp12v7243x012**** |
| Threshold |
string |
任意 |
自動 SQL 最適化イベントの期間のしきい値。 このパラメーターを指定すると、システムは期間が指定されたしきい値を超えない自動 SQL 最適化イベントの統計を収集します。 説明
このパラメーターは予約済みパラメーターであり、有効になりません。 |
None |
| FilterEnable |
string |
任意 |
DAS Enterprise Edition が有効になっているインスタンスをフィルターするかどうかを指定します。 有効な値:
説明
このパラメーターを true に設定すると、DAS Enterprise Edition が無効になっているデータベースインスタンスのみがクエリされます。 このパラメーターを false に設定すると、すべてのデータベースインスタンスがクエリされます。 |
false |
| UseMerging |
string |
任意 |
自動 SQL 最適化イベントをマージするかどうかを指定します。 有効な値:
説明
このパラメーターは予約済みパラメーターであり、有効になりません。 |
true |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
返されたデータ。 |
||
| Code |
string |
返された HTTP ステータスコード。 |
200 |
| Message |
string |
返されたメッセージ。 説明
リクエストが成功した場合、Successful が返されます。 リクエストが失敗した場合は、エラーコードなどのエラーメッセージが返されます。 |
Successful |
| Data |
object |
自動 SQL 最適化イベントの詳細。 |
|
| count |
integer |
自動 SQL 最適化イベントの総数です。 |
16 |
| improvement |
number |
返される自動 SQL 最適化イベントの最大改善倍率です。 |
1003 |
| RequestId |
string |
リクエスト ID。 |
B6D17591-B48B-4D31-9CD6-9B9796B2**** |
| Success |
string |
リクエストが成功したかどうかを示します。有効な値は次のとおりです:
|
true |
例
成功レスポンス
JSONJSON
{
"Code": "200",
"Message": "Successful",
"Data": {
"count": 16,
"improvement": 1003
},
"RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Success": "true"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | |
| 403 | NoPermission | You are not authorized to do this action. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。