データベースインスタンスのパフォーマンスインサイト (新バージョン) 機能の SQL サンプルデータを照会します。
操作説明
この操作を呼び出す前に、次の点にご注意ください：
Alibaba Cloud SDK または Database Autonomy Service (DAS) SDK を使用してこの API 操作を呼び出す場合は、最新バージョンの SDK を使用することを推奨します。
SDK を使用して DAS の API 操作を呼び出す場合、リージョン ID を cn-shanghai に設定する必要があります。
ApsaraDB RDS for MySQL インスタンスまたは PolarDB for MySQL クラスターが DAS に接続されていること。
データベースインスタンスでパフォーマンスインサイト (新バージョン) 機能が有効になっていること。詳細については、「パフォーマンスインサイト (新バージョン)」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
hdm:GetPfsSqlSample |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceId |
string |
必須 |
インスタンス ID。 説明
ApsaraDB RDS for MySQL インスタンスと PolarDB for MySQL クラスターのみがサポートされています。 |
rm-2ze1jdv45i7l6**** |
| NodeId |
string |
任意 |
ノード ID。 説明
ApsaraDB RDS for MySQL クラスター版インスタンスまたは PolarDB for MySQL クラスターの場合、ノード ID を指定する必要があります。 |
r-x****-db-0 |
| SqlId |
string |
任意 |
SQL ID。 |
651b56fe9418d48edb8fdf0980ec**** |
| StartTime |
integer |
必須 |
照会する時間範囲の開始時刻。値は、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプです。 |
1676511134614 |
| EndTime |
integer |
必須 |
照会する時間範囲の終了時刻。値は、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプです。 説明
終了時刻は開始時刻より後である必要があります。過去 30 日間のうち、最大 7 日間のデータを表示できます。 |
1678074351197 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| Message |
string |
返されたメッセージ。 説明
リクエストが成功した場合、Successful が返されます。リクエストが失敗した場合、エラーコードなどのエラーメッセージが返されます。 |
Successful |
| RequestId |
string |
リクエスト ID。 |
9CB97BC4-6479-55D0-B9D0-EA925AFE**** |
| Code |
integer |
返された HTTP ステータスコード。 |
200 |
| Success |
boolean |
リクエストが成功したかどうかを示します。有効値：
|
true |
| Data |
array<object> |
SQL サンプルデータ。 |
|
|
object |
|||
| UserId |
string |
ユーザー ID。 |
196278346919**** |
| InstanceId |
string |
インスタンス ID。 |
rm-2ze1jdv45i7l6**** |
| NodeId |
string |
ノード ID。 説明
このパラメーターは、ApsaraDB RDS for MySQL クラスター版インスタンスまたは PolarDB for MySQL クラスターの場合にのみ返されます。 |
r-x****-db-0 |
| LogicId |
string |
論理データベースの ID。 |
xxxxx |
| Timestamp |
integer |
SQL 文が実行された時刻。この値は、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプです。 |
1660100753556 |
| SqlId |
string |
SQL 文 ID。 |
651b56fe9418d48edb8fdf0980ec**** |
| Sql |
string |
サンプル SQL 文。 |
select * from xxxx where **** |
| ThreadId |
integer |
スレッド ID。 |
81751940 |
| EventId |
integer |
イベント ID。 |
63735293 |
| EndEventId |
integer |
イベントの終了 ID。デフォルトでは、イベント開始時のこのパラメーターの値は NULL で、イベント終了時にイベント ID に変更されます。 |
0 |
| EventName |
string |
イベントの名前。 |
statement/sql/select |
| Latency |
number |
実行時間。単位：ミリ秒。 |
0.199 |
| LockLatency |
number |
ロック待ち時間。単位：ミリ秒。 |
0.09 |
| Errors |
integer |
SQL 文に対して返されたエラーの数。 |
0 |
| Warnings |
integer |
SQL 文に対して返された警告の数。 |
0 |
| RowsAffected |
integer |
SQL 文によって影響を受けた行数。 |
0 |
| RowsSent |
integer |
SQL 文によって返された行数。 |
0 |
| RowsExamined |
integer |
SQL 文によってスキャンされた行数。 |
2048576 |
| CreateTmpDiskTables |
integer |
SQL 文の実行時に作成された内部ディスク上の一時テーブルの数。 |
0 |
| CreateTmpTables |
integer |
SQL 文の実行時に作成された内部一時テーブルの数。 |
0 |
| SelectFullJoin |
integer |
インデックスを使用せずにテーブルスキャンを実行するために使用される結合の数。 説明
このパラメーターは、UNION クエリでインデックスが使用されないシナリオで使用されます。返された値が 0 でない場合は、テーブルのインデックスを確認してください。 |
0 |
| SelectFullRangeJoin |
integer |
参照テーブルで範囲を使用した結合の数。 |
0 |
| SelectRange |
integer |
最初のテーブルで範囲を使用した結合の数。 |
0 |
| SelectRangeCheck |
integer |
キー値を持たない結合の数。データの各行についてキーと値がチェックされました。 説明
このパラメーターは、UNION クエリでインデックスが使用されないシナリオで使用されます。返された値が 0 でない場合は、テーブルのインデックスを確認してください。 |
0 |
| SelectScan |
integer |
スキャンの数。 |
0 |
| SortMergePasses |
integer |
ソートアルゴリズムが実行する必要があるマージの数。 |
0 |
| SortRange |
integer |
範囲を使用してデータがソートされた回数。 |
0 |
| SortRows |
integer |
ソートされた行数。 |
0 |
| SortScan |
integer |
テーブルスキャンの実行中に実行されたソートの数。 |
1 |
| NoIndexUsed |
integer |
インデックスが使用されなかった場合にテーブルスキャンが実行されたかどうかを示します。有効値：
|
1 |
| NoGoodIndexUsed |
integer |
サーバーが SQL 文に使用できるインデックスを見つけられなかったかどうかを示します。有効値：
|
1 |
| Db |
string |
データベースの名前。 |
testDB |
例
成功レスポンス
JSONJSON
{
"Message": "Successful",
"RequestId": "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
"Code": 200,
"Success": true,
"Data": [
{
"UserId": "196278346919****",
"InstanceId": "rm-2ze1jdv45i7l6****",
"NodeId": "r-x****-db-0",
"LogicId": "xxxxx",
"Timestamp": 1660100753556,
"SqlId": "651b56fe9418d48edb8fdf0980ec****",
"Sql": "select * from xxxx where ****",
"ThreadId": 81751940,
"EventId": 63735293,
"EndEventId": 0,
"EventName": "statement/sql/select",
"Latency": 0.199,
"LockLatency": 0.09,
"Errors": 0,
"Warnings": 0,
"RowsAffected": 0,
"RowsSent": 0,
"RowsExamined": 2048576,
"CreateTmpDiskTables": 0,
"CreateTmpTables": 0,
"SelectFullJoin": 0,
"SelectFullRangeJoin": 0,
"SelectRange": 0,
"SelectRangeCheck": 0,
"SelectScan": 0,
"SortMergePasses": 0,
"SortRange": 0,
"SortRows": 0,
"SortScan": 1,
"NoIndexUsed": 1,
"NoGoodIndexUsed": 1,
"Db": "testDB"
}
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | |
| 403 | NoPermission | You are not authorized to do this action. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。