全部產品
Search

搜尋本產品

    AnalyticDB：DescribeAuditLogRecords - 查詢SQL審計日誌

    文件中心

    AnalyticDB：DescribeAuditLogRecords - 查詢SQL審計日誌

    更新時間：Mar 27, 2026

    查詢叢集的SQL審計日誌。

    介面說明

    • 僅當 SQL 審計狀態為開啟時，才能查詢到 SQL 審計日誌，且只支援查詢 30 天內的 SQL 審計日誌。如果中途關閉了 SQL 審計，再次開啟時，僅能查詢到再次開啟後的 SQL 審計日誌。SQL 審計日誌不記錄INSERT INTO VALUES、REPLACE INTO VALUES和UPSERT INTO VALUES操作。

    • 當前服務的接入地址請參見服務存取點。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    adb:DescribeAuditLogRecords

    list

    *DBClusterLakeVersion

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DBClusterId

    string

    是

    湖倉版叢集 ID。

    說明

    您可以調用 DescribeDBClusters 介面查看目標地區下所有的叢集 ID。

    amv-t4nj8619bz2w3****
    RegionId

    string

    是

    地區 ID。

    說明

    您可以調用 DescribeRegions 介面查看叢集的地區 ID。

    cn-hangzhou
    StartTime

    string

    否

    查詢開始時間，UTC 時間，格式為：yyyy-MM-ddTHH:mmZ。

    說明

    僅當 SQL 審計狀態為開啟時，才能查詢到 SQL 審計日誌，且只支援查詢 30 天內的 SQL 審計日誌。如果中途關閉了 SQL 審計，再次開啟時，僅能查詢到再次開啟後的 SQL 審計日誌。

    2022-08-12T04:17Z
    EndTime

    string

    否

    查詢結束時間，UTC 時間，格式為：yyyy-MM-ddTHH:mmZ。

    說明

    • 查詢結束時間需晚於查詢開始時間。

    • 查詢開始時間與查詢結束時間的間隔不能超過 24 小時。

    2022-08-12T17:08Z
    DBName

    string

    否

    執行目標 SQL 的資料庫名稱。

    adb_demo
    QueryKeyword

    string

    否

    可設定一個字串類型的值，使用該值作為關鍵詞對返回結果進行搜尋。

    adb
    SqlType

    string

    否

    SQL 類型，取值：

    • DELETE

    • SELECT

    • UPDATE

    • INSERT INTO SELECT

    • ALTER

    • DROP

    • CREATE

    說明

    每次僅允許傳入一種類型查詢，若該參數為空白，預設查詢所有類型。

    SELECT
    Succeed

    string

    否

    目標 SQL 是否執行成功，取值說明：

    • true：執行成功。

    • false：執行失敗。

    true
    HostAddress

    string

    否

    執行目標 SQL 的用戶端 IP 位址和連接埠號碼。

    100.104.XX.XX:43908
    OrderType

    string

    否

    按 SQL 執行時間進行正序或倒序排序，取值說明：

    • asc：正序。

    • desc：倒序。

    asc
    User

    string

    否

    執行目標 SQL 的使用者名稱。

    test
    Order

    string

    否

    根據指定欄位進行排序，格式為 JSON，是一個有序 JSON 數組，按輸入數組的順序進行複合排序，包含Field和Type兩個欄位，例如[{"Field":"ExecutionStartTime","Type":"Desc"},{"Field":"ScanRows","Type":"Asc"}]。其中：

    • Field表示需要排序的欄位名，支援如下取值：

      • HostAddress：串連資料庫的用戶端地址。

      • UserName：使用者名稱。

      • ExecutionStartTime：目標 SQL 的執行開始時間。

      • QueryTime：目標 SQL 執行時間長度。

      • PeakMemoryUsage：執行目標 SQL 陳述式時的峰值記憶體。

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

      • ScanSize：掃描的資料量。

      • ScanTime：掃描資料總耗時。

      • PlanningTime：執行計畫產生耗時。

      • WallTime：查詢中的所有運算元在各個節點 CPU Time 的累加值。

      • ProcessID：進程 ID。

    • Type表示排序類型，支援如下取值：

      • Desc：降序。

      • Asc：升序。

    [{"Field":"ExecuteTime","Type":"Desc"},{"Field":"HostAddress","Type":"Asc"}]
    PageSize

    integer

    否

    每頁記錄數，取值：

    • 10（預設值）

    • 30

    • 50

    • 100

    10
    PageNumber

    integer

    否

    頁碼，取值為大於 0 且不超過 整數資料類型的最大值。預設值為 1。

    1
    ProxyUser

    string

    否

    預留參數。

    無

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    列表詳情。

    TotalCount

    string

    總記錄數。

    6974
    PageSize

    string

    每頁記錄數。

    10
    RequestId

    string

    請求 ID。

    8A564B7F-8C00-43C0-8EC5-919FBB70573
    PageNumber

    string

    頁碼。

    1
    DBClusterId

    string

    湖倉版叢集 ID。

    amv-t4nj8619bz2w3****
    Items

    array<object>

    列表。

    object

    SQL 記錄列表。

    HostAddress

    string

    執行目標 SQL 的用戶端 IP 位址和連接埠號碼。

    100.104.XX.XX:43908
    Succeed

    string

    目標 SQL 是否執行成功。取值說明：

    • true：執行成功。

    • false：執行失敗。

    true
    SQLText

    string

    SQL 陳述式詳情。

    SELECT * FROM adb_hdfs_import_source
    TotalTime

    string

    目標 SQL 的執行時間長度，單位：毫秒（ms）。

    216
    ConnId

    string

    通訊 ID。

    14356****
    DBName

    string

    執行目標 SQL 的資料庫名稱。

    adb_demo
    SQLType

    string

    目標 SQL 的類型。

    SELECT
    ExecuteTime

    string

    目標 SQL 的執行開始時間，本地時間，格式為：yyyy-MM-dd HH:mm:ss。

    2022-08-12 10:10:00
    ExecuteTimestamp

    integer

    目標 SQL 的執行開始時間，毫秒時間戳記。

    1774600396584
    ProcessID

    string

    任務 ID。

    202106081752021720161662490345362390
    User

    string

    執行目標 SQL 的使用者名稱。

    test
    HasDiagnosticInfo

    boolean

    是否包含診斷資訊。

    枚舉值：

    • true :

      true

    • false :

      false

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalCount": "6974",
  "PageSize": "10",
  "RequestId": "8A564B7F-8C00-43C0-8EC5-919FBB70573",
  "PageNumber": "1",
  "DBClusterId": "amv-t4nj8619bz2w3****",
  "Items": [
    {
      "HostAddress": "100.104.XX.XX:43908",
      "Succeed": "true",
      "SQLText": "SELECT * FROM adb_hdfs_import_source",
      "TotalTime": "216",
      "ConnId": "14356****",
      "DBName": "adb_demo",
      "SQLType": "SELECT",
      "ExecuteTime": "2022-08-12 10:10:00",
      "ExecuteTimestamp": 1774600396584,
      "ProcessID": "202106081752021720161662490345362390",
      "User": "test",
      "HasDiagnosticInfo": true
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

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

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

    變更歷史

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