全部產品
Search

搜尋本產品

    ：GetDasSQLLogHotData - 查詢DAS企業版熱儲存資料明細

    文件中心

    ：GetDasSQLLogHotData - 查詢DAS企業版熱儲存資料明細

    更新時間：Mar 12, 2026

    擷取審計日誌熱資料。

    介面說明

    使用該介面需滿足以下前提條件：

    • 使用阿里雲或 DAS 的 SDK 時，建議使用最新版本。

    • 在使用 SDK 調用 DAS 服務時，需要將地區指定為 cn-shanghai。

    • 適用於 Polar MySQL、RDS MYSQL、RDS PostgreSQL、RDS SQLServer。

    • 執行個體已開啟日誌索引。

    說明

    查詢開始時間不能早於 7 天以前，查詢開始時間和查詢結束時間的間隔不能超過 1 天，並且該 API 返回的條數最多為 1W 條。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    hdm:GetDasSQLLogHotData

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    是

    資料庫執行個體 ID。

    rm-2ze1jdv45i7l6****
    Start

    integer

    是

    查詢開始時間，格式為 Unix 時間戳記，單位為毫秒。

    說明

    只能查詢開啟 DAS 企業版後的資料，查詢開始時間最大不能早於目前時間 7 天。

    1684734297000
    End

    integer

    是

    查詢結束時間，格式為 Unix 時間戳記，單位為毫秒。

    說明

    查詢結束時間需晚於查詢開始時間，且查詢開始時間和查詢結束時間的間隔不能超過 1 天。

    1684820697000
    QueryKeyword

    string

    否

    關鍵字。

    說明

    支援模糊查詢；最多支援 10 個關鍵字組合查詢，關鍵字之間以空格分隔。例如：a1 b2 c3。

    a1 b2
    AccountName

    string

    否

    資料庫帳號。

    說明

    支援多個資料庫帳號組合查詢，資料庫帳號間以空格分隔，例如：user1 user2 user3。

    testuser
    DBName

    string

    否

    資料庫名。

    說明

    支援多個資料庫名組合查詢，資料庫名間以空格分隔，例如：DB1 DB2 DB3。

    testDB
    HostAddress

    string

    否

    用戶端 IP 位址。

    說明

    支援多個用戶端 IP 位址組合查詢，用戶端 IP 位址間以空格分隔，例如：IP1 IP2 IP3。

    47.100.XX.XX
    LogicalOperator

    string

    否

    多個關鍵字的邏輯關係。

    • or：或。

    • and：與。

    or
    MaxLatancy

    integer

    否

    最大執行耗時 ，單位為微秒。查詢執行耗時小於該參數值的 SQL 陳述式。

    100
    MaxScanRows

    integer

    否

    最大掃描行數 ，查詢掃描行數小於該參數值的 SQL 陳述式。

    10000
    MinLatancy

    integer

    否

    最小執行耗時 ，單位為微秒。查詢執行耗時大於等於該參數值的 SQL 陳述式。

    10
    MinScanRows

    integer

    否

    最小掃描行數 ，查詢掃描行數大於等於該參數值的 SQL 陳述式。

    10
    SqlType

    string

    否

    SQL 陳述式的類型。取值：

    • select

    • update

    • delete

    枚舉值：

    • select :

      查詢

    • update :

      修改

    • delete :

      刪除

    select
    State

    string

    否

    執行結果，輸入 0 時表示查詢執行成功的 SQL，您也可以輸入具體的錯誤碼，查詢對應的 SQL。

    0
    ThreadID

    string

    否

    線程 ID。

    說明

    支援多個線程 ID 組合查詢，線程 ID 間以空格分隔，例如：線程 ID1 線程 ID2 線程 ID3。

    657
    PageNumbers

    integer

    否

    分頁查詢的頁碼，從 1 開始，預設為 1。

    2
    MaxRecordsPerPage

    integer

    否

    分頁查詢每頁最大記錄數。取值範圍：5～100。

    10
    SortKey

    string

    否

    排序依據。

    • ScanRows：掃描行數。

    • UpdateRows：更新行數。

    • Consume：耗時。

    • OriginTime：執行時間。

    • ReturnRows：返回行數。

    ScanRows
    SortMethod

    string

    否

    排序方式。

    • ASC：正序。

    • DESC：倒序。

    ASC
    ChildDBInstanceIDs

    string

    否

    節點 ID。

    說明

    對於 PolarDB MySQL 版執行個體，需要提供節點 ID。

    pi-bp179lg03445l****
    Role

    string

    否

    預留參數，暫不支援。

    None
    TraceId

    string

    否

    預留參數，暫不支援。

    None
    MinRows

    integer

    否

    預留參數，暫不支援。

    None
    MaxRows

    integer

    否

    預留參數，暫不支援。

    None
    MinSpillCnt

    integer

    否

    預留參數，暫不支援。

    None
    MaxSpillCnt

    integer

    否

    預留參數，暫不支援。

    None
    TransactionId

    string

    否

    事務 ID。

    0
    Fail

    string

    否

    SQL 執行錯誤碼，您可以調用 GetAsyncErrorRequestStatByCode 擷取錯誤碼。

    1064

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Code

    string

    返回的狀態代碼。

    200
    Message

    string

    請求返回訊息。

    說明

    請求成功時該參數返回 Successful，請求失敗時會返回請求異常資訊（如錯誤碼等）。

    Successful
    RequestId

    string

    請求 ID，阿里雲為該請求產生的標識符。

    0A74B755-98B7-59DB-8724-1321B394****
    Success

    string

    請求是否執行成功：

    • true：執行成功。

    • false：執行失敗。

    true
    Data

    object

    返回資料。

    List

    array<object>

    返回資訊列表。

    object

    返回 SQL 洞察和審計資料。

    Latancy

    integer

    執行耗時，單位微秒。

    10000
    Ext

    string

    擴充資訊欄位，備用參數。

    None
    ExecuteTime

    string

    執行時間，格式為 UTC 時間：yyyy-MM-ddTHH:mm:ssZ。

    2023-05-23 T12:11:20Z
    OriginTime

    string

    執行時間，格式為 UTC 時間：yyyy-MM-ddTHH:mm:ss.SSSZ。

    2023-05-23 T12:11:20.999Z
    HostAddress

    string

    用戶端 IP 位址。

    47.100.XX.XX
    UpdateRows

    integer

    更新行數。

    30
    LogicRead

    integer

    邏輯讀。

    12
    SQLText

    string

    SQL 陳述式詳情。

    select 1
    LockTime

    integer

    鎖等待時間，單位微秒。

    1
    ScanRows

    integer

    掃描行數。

    29
    ThreadID

    integer

    線程 ID。

    657
    State

    string

    狀態。返回 0 時表示執行成功，否則返回錯誤碼。

    0
    DBName

    string

    資料庫名稱。

    testDB
    SqlType

    string

    SQL 的類型。取值：

    • select

    • update

    • delete

    select
    AccountName

    string

    資料庫帳號。

    testuser
    PhysicSyncRead

    integer

    物理同步讀。

    0
    PhysicAsyncRead

    integer

    物理非同步讀。

    0
    TransactionId

    string

    開啟的事務 ID。

    0
    ReturnRows

    integer

    返回行數。

    1
    NodeId

    string

    Total

    integer

    返回總記錄數。

    20
    PageNo

    integer

    分頁頁碼。

    2
    PageSize

    integer

    每頁數量。

    10
    Extra

    any

    備用參數。

    None

    樣本

    正常返回樣本

    JSON格式

    {
  "Code": "200",
  "Message": "Successful",
  "RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
  "Success": "true",
  "Data": {
    "List": [
      {
        "Latancy": 10000,
        "Ext": "None",
        "ExecuteTime": "2023-05-23 T12:11:20Z",
        "OriginTime": "2023-05-23 T12:11:20.999Z",
        "HostAddress": "47.100.XX.XX",
        "UpdateRows": 30,
        "LogicRead": 12,
        "SQLText": "select 1",
        "LockTime": 1,
        "ScanRows": 29,
        "ThreadID": 657,
        "State": "0",
        "DBName": "testDB",
        "SqlType": "select",
        "AccountName": "testuser",
        "PhysicSyncRead": 0,
        "PhysicAsyncRead": 0,
        "TransactionId": "0",
        "ReturnRows": 1,
        "NodeId": ""
      }
    ],
    "Total": 20,
    "PageNo": 2,
    "PageSize": 10,
    "Extra": "None"
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidParams The request parameters are invalid. 請求參數錯誤
    403 NoPermission You are not authorized to do this action. 沒有許可權執行該操作

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

    變更歷史

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