全部產品
Search

搜尋本產品

    AnalyticDB：DescribeTablePartitionDiagnose - 查詢分區診斷資訊

    文件中心

    AnalyticDB：DescribeTablePartitionDiagnose - 查詢分區診斷資訊

    更新時間：Feb 26, 2026

    調用DescribeTablePartitionDiagnose介面查詢分區診斷資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    adb:DescribeTablePartitionDiagnose

    get

    DBCluster

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DBClusterId

    string

    是

    叢集 ID。

    說明

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

    am-bpxxxxxxxx47
    PageSize

    integer

    否

    每頁記錄數，取值：

    • 30；

    • 50；

    • 100；

    預設值：30。

    30
    PageNumber

    integer

    否

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

    1
    Order

    string

    否

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

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

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

      • TableName：表名。

      • TotalSize：總資料量。

      • SpaceRatio：空間佔比。

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

      • Asc：升序排序。

      • Desc： 降序排序。

    說明

    若不設定參數，預設按照目標表的總資料量倒序排列。

    [{\"Field\":\"TotalSize\",\"Type\":\"Desc\"}]
    RegionId

    string

    否

    地區 ID。

    cn-hangzhou
    Lang

    string

    否

    指定請求和接收訊息的語言類型，預設為 zh。取值：

    • zh：中文

    • en：英文

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    參數列表。

    TotalCount

    integer

    總記錄數。

    1
    RequestId

    string

    請求 ID。

    1AD222E9-E606-4A42-BF6D-8A4442913CEF
    PageSize

    integer

    總頁數。

    123
    PageNumber

    integer

    頁碼。

    34
    DBClusterId

    string

    叢集 ID。

    rm-uf6wjk5xxxxxxxxxx
    SuggestMaxRecordsPerPartition

    integer

    建議每個二級分區的最大行數。

    640000000
    SuggestMinRecordsPerPartition

    integer

    建議每個二級分區的最小行數。

    64000000
    Items

    array<object>

    表統計資訊。

    object

    資訊列表。

    TableName

    string

    表名。

    user
    PartitionDetail

    string

    不合理分區。

    [20210110, 20210113,20210123]
    SchemaName

    string

    資料庫名。

    test_db
    PartitionNumber

    integer

    分區個數。

    34
    SpaceRatio

    number

    資料表空間佔比，單位：%。

    說明

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

    66.23
    TotalSize

    integer

    總資料量，單位：Byte。

    42949672960
    DetectionItems

    array<object>

    檢測項及檢測結果清單。

    object

    Name

    string

    檢測項名字。

    表分區合理性檢測
    Message

    string

    檢測結果資訊。

    檢測到表存在分區不合理的情況
    Status

    string

    檢測結果狀態。取值：

    • NORMAL

    • WARNING

    • CRITICAL

    WARNING

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalCount": 1,
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "PageSize": 123,
  "PageNumber": 34,
  "DBClusterId": "rm-uf6wjk5xxxxxxxxxx",
  "SuggestMaxRecordsPerPartition": 640000000,
  "SuggestMinRecordsPerPartition": 64000000,
  "Items": [
    {
      "TableName": "user",
      "PartitionDetail": "[20210110, 20210113,20210123]",
      "SchemaName": "test_db",
      "PartitionNumber": 34,
      "SpaceRatio": 66.23,
      "TotalSize": 42949672960
    }
  ],
  "DetectionItems": [
    {
      "Name": "表分區合理性檢測",
      "Message": "檢測到表存在分區不合理的情況",
      "Status": "WARNING"
    }
  ]
}

    錯誤碼

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

    變更歷史

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