全部產品
Search
文件中心

AnalyticDB:DescribeSQLPlanTask - 查詢計劃任務資訊

更新時間:Feb 26, 2026

調用DescribeSQLPlanTask查詢任務資訊。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

adb:DescribeSQLPlanTask

get

DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

請求參數

名稱

類型

必填

描述

樣本值

DBClusterId

string

執行個體 ID。

am-bp1xxxxxxxx47

ProcessId

string

查詢任務 ID。

201907241445301720211111570315107****

StageId

string

任務所屬階段。

1785135913****

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

1AD222E9-E606-4A42-BF6D-8A4442913CEF

TaskList

array<object>

工作清單。

object

ScanCost

integer

帶資料來源的任務的掃描資料耗時。單位:ms。

0

OutputSize

integer

任務的輸出資料量。單位:Byte。

945

InputSize

integer

任務的輸入資料量。單位:Byte。

3763

State

string

任務最終執行狀態:

  • FINISHED:完成。

  • CANCELED:取消。

  • ABORTED:中止。

  • FAILED:失敗。

FINISHED

OperatorCost

integer

任務在某個節點的運算元總耗時,是個多線程累加值,可以用於判斷計算是否存在長尾。單位:ms。

3

OutputRows

integer

任務的輸出資料行數。

105

ScanSize

integer

帶資料來源的任務的掃描資料量。單位:Byte。

0

ElapsedTime

integer

任務從建立到結束的時間差。單位:ms。

10

ScanRows

integer

帶資料來源的任務的掃描資料行數。

0

PeakMemory

integer

任務在某個節點的峰值記憶體。單位:Byte。

898576

TaskId

integer

任務 ID。

198877623

InputRows

integer

任務的輸入資料行數。

105

樣本

正常返回樣本

JSON格式

{
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "TaskList": [
    {
      "ScanCost": 0,
      "OutputSize": 945,
      "InputSize": 3763,
      "State": "FINISHED",
      "OperatorCost": 3,
      "OutputRows": 105,
      "ScanSize": 0,
      "ElapsedTime": 10,
      "ScanRows": 0,
      "PeakMemory": 898576,
      "TaskId": 198877623,
      "InputRows": 105
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在,請確認 DBClusterId 值是否正確。

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

變更歷史

更多資訊,參考變更詳情