すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for OceanBase (Deprecated):DescribeOasAnomalySQLList

最終更新日:May 26, 2026

この API は、パフォーマンスの問題の可能性があるとして診断システムによってフラグ付けされた SQL ステートメントのリストを返します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

oceanbase:DescribeOasAnomalySQLList

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceId

string

必須

OceanBase インスタンスの ID。

ob317v4uif****

TenantId

string

必須

テナント ID。

t4louaeei****

StartTime

string

必須

クエリ期間の開始時刻。
時刻は UTC であり、YYYY-MM-DDTHH:mm:ssZ 形式である必要があります。

2023-04-12T04:38:38Z

EndTime

string

必須

クエリ期間の終了時刻。
時刻は UTC であり、YYYY-MM-DDTHH:mm:ssZ 形式である必要があります。

2023-04-12T05:38:38Z

DbName

string

任意

データベース名。

db_****

SearchKeyWord

string

任意

検索キーワード。

update

SearchParam

string

任意

検索対象のパフォーマンスメトリック。

cputime

SearchRule

string

任意

検索演算子。
有効な値: =>>=<、および <=

>

SearchValue

string

任意

検索値。

0.01

SqlId

string

任意

SQL ID。

8D6E84****0B8FB1823D199E2CA1****

NodeIp

string

任意

ノードの IP アドレス。

i-bp19y05uq6x*********

FilterCondition

string

任意

アットマーク (@) を使用してフィールドを参照します。利用可能なフィールドについては、SQL ステートメントのパフォーマンス統計クエリ API が返す全ての列をご参照ください。

@avgCpuTime > 20 and @executions > 100

AcceptLanguage

string

任意

レスポンスの言語。
中国本土のサービスではデフォルトで zh-CN、その他のリージョンでは en-US になります。

zh-CN

SqlTextLength

integer

任意

返される SQL テキストの最大長。

65535

Current

integer

任意

返されるページ番号。

1

PageSize

integer

任意

1 ページあたりに返すエントリ数。

  • 最小値: 1。

  • デフォルト値: 10。

10

DynamicSql

boolean

任意

SqlId で指定された SQL ステートメントが動的 SQL であるかどうかを示します。

説明


false

MergeDynamicSql

boolean

任意

動的 SQL ステートメントの結果をマージするかどうか。

説明

このオプションは、IN 句の値を除いて同一の SQL ステートメントを集約します。

false

レスポンスフィールド

フィールド

説明

object

リクエストの結果です。

Data

array<object>

疑わしい SQL 情報の一覧です。

array<object>

疑わしい SQL の情報です。

AvgCpuTime

number

疑わしい SQL の平均 CPU 時間です。

100.24

AvgElapsedTime

number

疑わしい SQL の平均応答時間です。

100.28

AvgGetPlanTime

number

疑わしい SQL の実行計画取得の平均時間です。

0

CpuTime

number

疑わしい SQL の CPU 時間です。

100.23

DbName

string

データベース名です。

db_***

DiagTypes

array

診断タイプの一覧です。

string

診断タイプです。

[ "CPU_TIME_PROPORTION_HIGH" ]

Diagnosis

string

診断の詳細です。

説明


このパラメーターは非推奨です。

-

Executions

number

疑わしい SQL の総実行回数です。

1

LastExecutedTime

string

疑わしい SQL の最終実行時刻です。

2023-04-12T04:38:38Z

RiskLevel

string

リスクレベルです。

high

SqlId

string

SQL ID です。

8D6E84****0B8FB1823D199E2CA1****

SqlTextShort

string

SQL テキストのプレフィックスです。

delete /*+ XXX PARALLEL(4) */ from

Suggestion

string

疑わしい SQL に関する推奨事項です。

review

SumElapsedTime

number

疑わしい SQL の合計応答時間です。

11452126.36

UserName

string

ユーザー名です。

test_user

DynamicSql

boolean

動的 SQL かどうかを示します。

false

SqlList

array<object>

SQL の一覧です。

object

SQL の情報です。

AvgCpuTime

number

平均 CPU 時間です。

100.24

AvgElapsedTime

number

平均応答時間です。

100.28

AvgGetPlanTime

number

実行計画取得の平均時間です。

0

CpuTime

number

合計 CPU 時間です。

100.23

DbName

string

データベース名です。

test_hsp****eway

DiagTypes

array

診断タイプの一覧です。

string

診断タイプです。

[ "CPU_TIME_PROPORTION_HIGH" ]

Diagnosis

string

診断の詳細です。

説明


このパラメーターは非推奨です。

-

Executions

number

総実行回数です。

100

LastExecutedTime

string

最終実行時刻です。

2023-04-12T04:38:38Z

RiskLevel

string

リスクレベルです。

LOW

SqlId

string

SQL ID です。

3A645****789F13DE0CF6D084FF9****

SqlTextShort

string

SQL テキストのプレフィックスです。

select * from test

Suggestion

string

疑わしい SQL に関する推奨事項です。

{'Role': 'eSG', 'Result': '100', 'Suggestion': 'TRACER_OTHER_ERR'}

SumElapsedTime

number

合計応答時間です。

11452126.36

UserName

string

ユーザー名です。

test_user

AvgDbTime

number

平均 DB 時間です。

100

SumDbTime

number

合計 DB 時間です。

100

AvgRetryCount

number

平均リトライ回数です。

4

SumRetryCount

number

合計リトライ回数です。

6

AvgLogicalReads

number

平均論理読み取り回数です。

25

FormatSqlId

string

FormatSqlId です。

AvgDbTime

number

平均 DB 時間です。

100

SumDbTime

number

合計 DB 時間です。

100

AvgRetryCount

number

平均リトライ回数です。

4

SumRetryCount

number

合計リトライ回数です。

6

AvgLogicalReads

number

平均論理読み取り回数です。

25

FormatSqlId

string

FormatSqlId です。

RequestId

string

リクエスト ID です。

473469**-AA6F-4D**-B3DB-A***********

TotalCount

integer

総数です。

9

成功レスポンス

JSONJSON

{
  "Data": [
    {
      "AvgCpuTime": 100.24,
      "AvgElapsedTime": 100.28,
      "AvgGetPlanTime": 0,
      "CpuTime": 100.23,
      "DbName": "db_***",
      "DiagTypes": [
        "[\n      \"CPU_TIME_PROPORTION_HIGH\"\n]"
      ],
      "Diagnosis": "-",
      "Executions": 1,
      "LastExecutedTime": "2023-04-12T04:38:38Z",
      "RiskLevel": "high",
      "SqlId": "8D6E84****0B8FB1823D199E2CA1****",
      "SqlTextShort": "delete /*+ XXX PARALLEL(4) */ from",
      "Suggestion": "review",
      "SumElapsedTime": 11452126.36,
      "UserName": "test_user",
      "DynamicSql": false,
      "SqlList": [
        {
          "AvgCpuTime": 100.24,
          "AvgElapsedTime": 100.28,
          "AvgGetPlanTime": 0,
          "CpuTime": 100.23,
          "DbName": "test_hsp****eway",
          "DiagTypes": [
            "[\n          \"CPU_TIME_PROPORTION_HIGH\"\n        ]"
          ],
          "Diagnosis": "-",
          "Executions": 100,
          "LastExecutedTime": "2023-04-12T04:38:38Z",
          "RiskLevel": "LOW",
          "SqlId": "3A645****789F13DE0CF6D084FF9****",
          "SqlTextShort": "select * from test",
          "Suggestion": "{'Role': 'eSG', 'Result': '100', 'Suggestion': 'TRACER_OTHER_ERR'}",
          "SumElapsedTime": 11452126.36,
          "UserName": "test_user",
          "AvgDbTime": 100,
          "SumDbTime": 100,
          "AvgRetryCount": 4,
          "SumRetryCount": 6,
          "AvgLogicalReads": 25,
          "FormatSqlId": ""
        }
      ],
      "AvgDbTime": 100,
      "SumDbTime": 100,
      "AvgRetryCount": 4,
      "SumRetryCount": 6,
      "AvgLogicalReads": 25,
      "FormatSqlId": ""
    }
  ],
  "RequestId": "473469**-AA6F-4D**-B3DB-A***********",
  "TotalCount": 9
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。