全部產品
Search
文件中心

AnalyticDB:DescribeTableStatistics - 查詢表統計資訊

更新時間:Jan 14, 2026

查詢目標AnalyticDB MySQL叢集中的表資訊統計詳情。

介面說明

說明

更多關於表資訊統計的詳情,請參見監控資訊

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

adb:DescribeTableStatistics

get

DBCluster

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

請求參數

名稱

類型

必填

描述

樣本值

DBClusterId

string

叢集 ID。

說明

您可以調用 DescribeDBClusters 介面查看叢集 ID。

am-bp183qgrwywa6****

PageSize

integer

每頁記錄數,取值:

  • 30(預設值)

  • 50

  • 100

30

PageNumber

integer

頁碼,取值為大於 0 的正整數。預設值為 1

1

Order

string

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

  • Field表示需要排序的欄位名。支援排序的欄位包括:TableName、ColdDataSize、DataSize、PrimaryKeyIndexSize、RowCount、IndexSize、SchemaName、PartitionCount。

  • Type表示排序類型,支援如下取值(取值均不區分大小寫):
    • Desc:降序。

    • Asc:升序。

[ { "Field":"TableName", "Type":"Asc" } ]

RegionId

string

地區 ID。

說明

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

cn-beijing

Keyword

string

查詢關鍵字,支援根據表名模糊搜尋。

you_table_name

SchemaName

string

資料庫名稱。

cust_pay_instruction

返回參數

名稱

類型

描述

樣本值

object

資訊列表。

TotalCount

string

總記錄數。

1

PageSize

string

本頁記錄數。

30

RequestId

string

請求 ID。

4C4433FF-5D3A-4C3E-A19C-6D93B2******

PageNumber

string

頁數。

1

DBClusterId

string

叢集 ID。

am-****************

Items

object

TableStatisticRecords

array<object>

表統計資訊列表。

object

詳情。

SchemaName

string

資料庫名稱。

test_schema

TableName

string

表名稱。

test_table

RowCount

integer

錶行數。

3

DataSize

integer

表記錄資料量,單位:Byte。

說明

表記錄資料量,不包含普通索引、主鍵索引的資料。

15592

IndexSize

integer

普通索引資料量,單位:Byte。

3076

PrimaryKeyIndexSize

integer

主鍵索引資料量,單位:Byte。

16340

PartitionCount

integer

分區數。

1

ColdDataSize

integer

冷資料總量,單位:Byte。

說明

僅核心版本為 3.1.3.4 或以上叢集才會返回該參數。

0

SpaceRatio

number

資料表空間佔比,單位:%。

說明

計算公式為:資料表空間佔比 = 表總資料量 / 執行個體總資料量 * 100。

66.23

TotalSize

integer

總資料量,單位:Byte。

說明

總資料量的計算,以下 2 個公式都成立。計算公式 1:總資料量 = 熱資料量 + 冷資料量,計算公式 2:總資料量 = 表記錄資料量 + 普通索引資料量 + 主鍵索引資料量 + 其他。

1577

HotDataSize

integer

熱資料量,單位:Byte。

1048576

OtherSize

integer

其他,單位:Byte。

1048576

SchemaNames

string

資料庫名稱列表。

['adb_external_tpch_10gb', 'dw_bccb', 'dw_fm', 'dw_test', 'dw_yph']

樣本

正常返回樣本

JSON格式

{
  "TotalCount": "1",
  "PageSize": "30",
  "RequestId": "4C4433FF-5D3A-4C3E-A19C-6D93B2******",
  "PageNumber": "1",
  "DBClusterId": "am-****************",
  "Items": {
    "TableStatisticRecords": [
      {
        "SchemaName": "test_schema",
        "TableName": "test_table",
        "RowCount": 3,
        "DataSize": 15592,
        "IndexSize": 3076,
        "PrimaryKeyIndexSize": 16340,
        "PartitionCount": 1,
        "ColdDataSize": 0,
        "SpaceRatio": 66.23,
        "TotalSize": 1577,
        "HotDataSize": 1048576,
        "OtherSize": 1048576
      }
    ]
  },
  "SchemaNames": "['adb_external_tpch_10gb', 'dw_bccb', 'dw_fm', 'dw_test', 'dw_yph']"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情