機能説明
指定されたOB Cloudデータベースインスタンスの指定された期間内のスローSQLリストを照会します。データベース名、ノードIP、SQLキーワードなどの条件でフィルタリングでき、カスタムフィルタ条件を使用して結果をより正確にフィルタリングできます。
呼び出し説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを持っている必要があります。AccessKey IDとAccessKey Secretの取得方法については、アクセスキーの管理をご参照ください。
リクエストパス
GET /api/v2/instances/{instanceId}/slowSql
リクエストパラメータ
パラメータ名 |
型 |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| instanceId | string | はい | OB CloudデータベースインスタンスID。 | obcluster-***** |
| requestId | string | はい | 追跡用のリクエストID。 | dc302d76-66b5-48d8-ab53-a035******** |
| startTime | string | はい | 照会開始時刻(UTC形式)。
注意
|
2026-02-25 15:40:43+00:00 |
| endTime | string | はい | 照会終了時刻(UTC形式)。
注意
|
2026-02-26 10:40:43+00:00 |
| dbName | string | いいえ | データベース名。指定したデータベースのスローSQLをフィルタリングするために使用されます。 | なし |
| nodeIp | string | いいえ | ノードIP。指定したノードのスローSQLをフィルタリングするために使用されます。 | なし |
| searchKeyWord | string | いいえ | SQLキーワード。SQLテキスト内であいまい一致を行うために使用されます。 | update |
| sqlTextLength | integer | いいえ | 戻されるSQLテキストの最大長。超過分は切り捨てられます。 | 65535 |
| filterCondition | string | いいえ | カスタムフィルタ条件。フィールドは@記号で参照します。例：@avgCpuTime > 20 and @executions > 100。 |
@avgCpuTime > 20 and @executions > 100 |
| mergeDynamicSql | boolean | いいえ | 動的SQLをマージするかどうか。 | なし |
| dynamicSql | boolean | いいえ | 動的SQLを照会するかどうか。 | なし |
実行結果
パラメータ名 |
型 |
説明 |
|---|---|---|
| data | array | スローSQLリストデータ。 |
| errorCode | string | エラーコード。 |
| message | string | エラーメッセージ。 |
| requestId | string | リクエストID。 |
| server | string | サーバーアドレス。 |
| success | boolean | リクエストが成功したかどうかを示します。 |
例
リクエスト例
curl -X GET \
'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/slowSql?requestId={requestId}&startTime=2026-02-25%2015:40:43%2B00:00&endTime=2026-02-26%2010:40:43%2B00:00&searchKeyWord=update&sqlTextLength=65535&filterCondition=%40avgCpuTime%20%3E%2020%20and%20%40executions%20%3E%20100' \
-H 'Content-Type: application/json' \
-u '<Your AK:SK>'
レスポンス例
{
"data": [
{
"sqlId": "xxxxxx",
"dbName": "test_db",
"sqlText": "UPDATE test_table SET value = ? WHERE id = ?",
"executions": 150,
"avgCpuTime": 25.5,
"nodeIp": "xxx.xxx.x.xxx"
}
],
"errorCode": "OB-0000",
"message": "success",
"requestId": "xxxxxx",
"server": "xxx.xxx.x.xxx:xxxx",
"success": true
}