全部產品
Search

搜尋本產品

    ：DescribeTableAccessCount - 查詢表訪問統計資訊

    文件中心

    ：DescribeTableAccessCount - 查詢表訪問統計資訊

    更新時間：Jan 14, 2026

    查看指定日期內AnalyticDB MySQL版叢集下目標表或所有表的被訪問次數。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    adb:DescribeTableAccessCount

    get

    DBCluster

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DBClusterId

    string

    是

    叢集 ID。

    說明

    您可以調用 DescribeDBClusters 介面查看目標地區下所有 AnalyticDB MySQL 叢集的詳情，包括叢集 ID。

    am-bp1r053byu48p****
    TableName

    string

    否

    目標表名。

    說明

    若該參數留空，則會返回當前日期內目的地組群下所有表的使用頻次資料。

    CUSTOMER
    StartTime

    string

    是

    需要查詢的日期，格式為yyyy-MM-dd（UTC 時間）。

    說明

    僅支援查看 30 天內的資料。

    2021-08-30
    Order

    string

    否

    將查詢結果按指定欄位進行排序。格式為 JSON 字串，例如[{"Field":"TableSchema","Type":"Asc"}]。其中：

    • Field表示排序欄位。支援如下取值：

      • TableSchema：表所屬的資料庫名。

      • TableName：表名。

      • AccessCount：表被訪問的次數。

    • Type表示排序方式。支援如下取值：

      • Asc：升序排序。

      • Desc： 降序排序。

    說明

    若不設定參數，預設按照目標表所屬的資料庫升序排列。

    [{"Field":"TableSchema","Type":"Asc"}]
    PageNumber

    integer

    否

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

    1
    PageSize

    integer

    否

    每頁記錄數，取值為任意正整數。預設為 30。

    30
    RegionId

    string

    是

    地區 ID。

    說明

    您可以調用 DescribeRegions 介面查看 AnalyticDB MySQL 版支援的地區和可用性區域資訊，包括地區 ID。

    cn-hangzhou

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    詳情。

    RequestId

    string

    請求 ID。

    C242707A-01D1-54DA-A5F6-671557******
    PageNumber

    integer

    頁數。

    1
    PageSize

    integer

    本頁記錄數。

    30
    TotalCount

    integer

    總記錄數。

    1
    Items

    array<object>

    表使用詳情。

    object

    詳情。

    ReportDate

    string

    表使用日期。

    2021-08-30
    TableSchema

    string

    表所屬的資料庫。

    tpch
    AccessCount

    string

    表被訪問的次數。

    6
    TableName

    string

    表名。

    CUSTOMER
    InstanceName

    string

    表所屬叢集的叢集 ID。

    am-bp1r053byu48p****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "C242707A-01D1-54DA-A5F6-671557******",
  "PageNumber": 1,
  "PageSize": 30,
  "TotalCount": 1,
  "Items": [
    {
      "ReportDate": "2021-08-30",
      "TableSchema": "tpch",
      "AccessCount": "6",
      "TableName": "CUSTOMER",
      "InstanceName": "am-bp1r053byu48p****"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    503 ServiceUnavailable An error occurred while processing your request. 系統暫時不可用，請稍後重試

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

    變更歷史

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