DescribeOasAnomalySQLList - 查詢可疑 SQL 列表

更新時間:
Copy as MD

該介面用於查詢診斷系統判定可能存在效能問題的 SQL 列表。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

oceanbase:DescribeOasAnomalySQLList

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

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 的效能統計介面返回的所有列。

@avgCpuTime > 20 and @executions > 100

AcceptLanguage

string

返回資料的語言。
預設值:中國 CN,國外 EN。

zh-CN

SqlTextLength

integer

返回 SQL 文本的最大長度。

65535

Current

integer

當前頁。

1

PageSize

integer

分頁查詢的頁碼。

  • 起始值:1。

  • 預設值:1。

10

DynamicSql

boolean

是否動態 SQL。

說明


表示傳入的 SQL ID 是否為動態 SQL 的 ID。

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

平均資料庫時間。

100

SumDbTime

number

總資料庫時間。

100

AvgRetryCount

number

平均重試次數。

4

SumRetryCount

number

總重試次數。

6

AvgLogicalReads

number

平均邏輯讀次數。

25

FormatSqlId

string

FormatSqlId

AvgDbTime

number

平均資料庫時間。

100

SumDbTime

number

總資料庫時間

100

AvgRetryCount

number

平均重試次數。

4

SumRetryCount

number

總重試次數。

6

AvgLogicalReads

number

平均邏輯讀次數。

25

FormatSqlId

string

FormatSqlId

RequestId

string

請求 ID。

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

TotalCount

integer

總數量。

9

樣本

正常返回樣本

JSON格式

{
  "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
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情