全部產品
Search

搜尋本產品

    Data Management：ListDBTaskSQLJobDetail - 擷取SQL任務的詳情資訊

    文件中心

    Data Management：ListDBTaskSQLJobDetail - 擷取SQL任務的詳情資訊

    更新時間：Apr 08, 2026

    擷取SQL任務的詳情資訊。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dms:ListDBTaskSQLJobDetail

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    JobId

    integer

    是

    SQL 任務 ID，可通過調用介面 ListDBTaskSQLJob 擷取該參數的值。

    1276****
    PageNumber

    integer

    否

    開始頁碼。

    1
    PageSize

    integer

    否

    每頁資料量。

    20
    Tid

    integer

    否

    租戶 ID，可通過調用介面 GetUserActiveTenant 擷取該參數的值。

    3***

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    3F044E33-FE09-58F1-8C61-A0F612EC****
    Success

    boolean

    請求是否成功，傳回值如下：

    • true：請求成功

    • false：請求失敗

    true
    ErrorMessage

    string

    錯誤資訊。

    JobId is mandatory for this action.
    ErrorCode

    string

    錯誤碼。

    MissingJobId
    DBTaskSQLJobDetailList

    array<object>

    SQL 任務詳情列表。

    object

    SQL 任務詳情列表。

    JobDetailId

    integer

    SQL 任務詳情 ID。

    24723****
    CurrentSql

    string

    當前執行的 SQL。

    update a set id = 1 where id = 1;
    ExecuteCount

    integer

    執行次數。

    1
    JobId

    integer

    SQL 任務 ID。

    1276****
    DbId

    integer

    物理庫 ID。

    1988****
    Logic

    boolean

    是否為邏輯庫，傳回值如下：

    • true：邏輯庫

    • false：物理庫

    false
    Skip

    boolean

    是否存在跳過執行 SQL 指令碼的情況，傳回值如下：

    • true：存在

    • false：不存在

    false
    SqlType

    string

    SQL 類型，例如，DELETE、UPDATE、ALTER_TABLE 等。

    CREATE_TABLE
    Status

    string

    SQL 詳情狀態，傳回值如下：

    • INIT：初始化狀態

    • PENDING：等待任務抓取

    • BE_SCHEDULED：待調度

    • FAIL：執行失敗

    • SUCCESS：執行成功

    • PAUSE：暫停

    • DELETE：刪除

    • RUNNING：正在執行

    SUCCESS
    Log

    string

    日誌詳情資訊。

    log_info
    StartTime

    string

    SQL 執行開始時間。

    2021-12-16 00:00:00
    EndTime

    string

    SQL 執行結束時間。

    2021-12-16 00:00:01
    TimeDelay

    integer

    SQL 執行耗時，單位為毫秒。

    38
    AffectRows

    integer

    SQL 執行影響行數。

    0
    SqlId

    integer

    TotalCount

    integer

    SQL 任務總數。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "3F044E33-FE09-58F1-8C61-A0F612EC****",
  "Success": true,
  "ErrorMessage": "JobId is mandatory for this action.",
  "ErrorCode": "MissingJobId",
  "DBTaskSQLJobDetailList": [
    {
      "JobDetailId": 0,
      "CurrentSql": "update a set id = 1 where id  = 1;",
      "ExecuteCount": 1,
      "JobId": 0,
      "DbId": 0,
      "Logic": false,
      "Skip": false,
      "SqlType": "CREATE_TABLE",
      "Status": "SUCCESS",
      "Log": "log_info",
      "StartTime": "2021-12-16 00:00:00",
      "EndTime": "2021-12-16 00:00:01",
      "TimeDelay": 38,
      "AffectRows": 0,
      "SqlId": 0
    }
  ],
  "TotalCount": 1
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。