機能説明
指定されたOB Cloudデータベースインスタンスにおける、指定された期間内の疑わしいSQLリストを照会します。このインターフェースはパフォーマンス診断に使用され、パフォーマンス上の問題が存在する可能性のあるSQL文を特定するのに役立ちます。データベース名、ノードIPアドレス、SQLキーワード、およびカスタムフィルター条件での絞り込みが可能です。
呼び出し説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法の詳細については、アクセスキーの管理をご参照ください。
リクエストパス
GET /api/v2/instances/{instanceId}/anomalySql
リクエストパラメータ
パスパラメータ
パラメータ名 |
型 |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| 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をフィルタリングするために使用されます。 | test_db |
| nodeIp | string | いいえ | ノードIPアドレス。指定したノードのSQLをフィルタリングするために使用されます。 | 192.168.1.1 |
| searchKeyWord | string | いいえ | SQLキーワード。SQLテキストのあいまい一致に使用されます。 | update |
| sqlTextLength | integer | いいえ | 戻されるSQLテキストの最大長。超過分は切り捨てられます。 | 65535 |
| filterCondition | string | いいえ | カスタムフィルター条件。フィールドは@記号で参照します。例：@avgCpuTime > 20 and @executions > 100。 |
@avgCpuTime > 20 and @executions > 100 |
| mergeDynamicSql | boolean | いいえ | 動的SQLをマージするかどうか。 | true |
| dynamicSql | boolean | いいえ | 動的SQLを照会するかどうか。 | false |
実行結果
パラメータ名 |
型 |
説明 |
|---|---|---|
| success | boolean | リクエストが成功したかどうかを示します。 |
| data | array | 疑わしいSQLのリストデータです。 |
| message | string | 返されるメッセージです。 |
| server | string | リクエストを処理したサーバーアドレスです。 |
例
リクエスト例
curl -X GET \
'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/anomalySql?requestId={requestId}&startTime=2026-02-25%2015:40:43%2B00:00&endTime=2026-02-26%2010:40:43%2B00:00&dbName=test_db&nodeIp=192.168.1.1&searchKeyWord=update&sqlTextLength=65535&filterCondition=@avgCpuTime%20%3E%2020%20and%20@executions%20%3E%20100&mergeDynamicSql=true&dynamicSql=false' \
-H 'Content-Type: application/json' \
-u '<あなたのak:sk>'
レスポンス例
{
"success": true,
"data": [
{
"sqlId": "xxxxxx",
"sqlText": "SELECT * FROM users WHERE id = ?",
"dbName": "test_db",
"nodeIp": "192.168.1.1",
"avgCpuTime": 150.5,
"executions": 1000,
"lastExecutedTime": "2026-02-26 09:30:00"
}
],
"message": "success",
"server": "xxx.xxx.x.xxx:xxxx"
}