全部產品
Search
文件中心

AnalyticDB:DescribeExcessivePrimaryKeys - 檢測主鍵過多表

更新時間:Mar 17, 2026

查看叢集存在主鍵過多的表資訊。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

adb:DescribeExcessivePrimaryKeys

get

*DBClusterLakeVersion

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

請求參數

名稱

類型

必填

描述

樣本值

DBClusterId

string

湖倉版叢集 ID。

說明

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

am-bp1xxxxxxxx47

RegionId

string

地區 ID。

說明

您可通過介面 DescribeRegions 查看可用的地區 ID。

cn-hangzhou

StartTime

string

查詢開始時間。格式為yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2019-06-01T16:00:00Z

EndTime

string

查詢結束時間。格式:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2019-06-01T16:00:00Z

PageSize

integer

每頁記錄數,取值範圍如下:

  • 30(預設值)。

  • 50

  • 100

30

PageNumber

integer

頁碼。

1

Lang

string

設定下載檔案的檔案標題以及部分錯誤資訊的語言,支援如下語言:

  • zh(預設值):簡體中文。

  • en:英文。

  • ja:日文。

  • zh-tw:繁體中文。

zh

Order

string

按指定欄位排序,json 格式:JSON 數組,有序,按順序輸入排欄欄位和升降序類型:

如:

[

    {

        "Field":"Name",

        "Type":"Asc"

    }

]

其中 Field 表示需要排序的欄位名,目前僅支援對"Name" 欄位排序。 Type 表示排序類型 Desc 為降序,Asc 為升序

均不區分大小寫。

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

返回參數

名稱

類型

描述

樣本值

object

TotalCount

string

總數。

300

PageNumber

integer

頁號,和傳入的值一致。

1

PageSize

integer

每頁記錄數,取值範圍如下:

  • 30(預設值)。

  • 50

  • 100

30

RequestId

string

請求 ID。

863D51B7-5321-41D8-A0B6-A088B0******

DBClusterId

string

叢集 ID。

am-bp1ub9grke1****

Tables

array<object>

主鍵過多表列表

object

TableName

string

表名。

test

SchemaName

string

資料庫名。

adb_demo

ColumnCount

integer

總列數。

21

PrimaryKeyCount

integer

主鍵欄位個數。

2

PrimaryKeyColumns

string

主鍵欄位列表。

id,date

SpaceRatio

number

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

說明

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

23

TotalSize

integer

冷資料總量,單位:Byte。

說明

計算公式為:冷資料總量 = 表記錄資料量 + 普通索引資料量 + 主鍵索引資料量 + 其他。

4

PrimaryKeyIndexSize

integer

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

222

DetectionItems

array<object>

檢測項及檢測結果清單。

object

檢測項及檢測結果清單。

Name

string

檢測項名字。

主鍵過多檢測

Message

string

檢測結果資訊。

檢測到多個表存在主鍵過多的問題

Status

string

檢測結果狀態。

NORMAL WARNNING CRITICAL

AccessDeniedDetail

string

訪問被拒絕詳細資料。

{ "PolicyType": "AccountLevelIdentityBasedPolicy", "AuthPrincipalOwnerId": "1906102576997697", "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcNqPqHV6lwR4INiAGjIvK1ngXxN1O+6ORRB6A8YvztEOGywOk81ZmuNk0YrNy+qk7+UVDTHeXKsy8h9e/ePY/LMidj0RCmDpo/YpCumd0UGe0qEPe2U+UJAm/+UHlnEFLVg6BP3yIB5D++MCy7mgWm8Kwyhk62IeYly4hQ+5IpXjkh1GQXuDgLVVPVpxEek9n30vnCUL4KsaMgfa7dgojb+3TM8xGsD2zVK5STJNrsXclscIJEqyNXd7CBYiRJVZi1HPO6drN9WW0chLpCSTgjO8n0bNanZaxXKumW9PSwV58UoSFASeMWfZK3TLngX+oq8nGmnTwcJosVjfF4RGzAnS1IXt0Q9N2WHDnpwyLBU/nOz7Hsy8IZ+h+OVjsBTXSM9688/vOF707a5mNzpETvQeGRcua3A5livcKAM2cML0yeUs/Zyj/+BGqtVa+wektspDHC/CECh6R5lxQjRmUdPawY8VDs2onmdLuEH8DdmYt+Yv/jBFBUMWOyAluzkPYcX5nuQKouCIUJUFTSbsJsuH5CTIh7Ls5rbmkj+T1qTVz8gnDR8LxwaqoMSna+elXgVyOOxXtMkenVntsmoC3p/4G7yTPL1hu8JyWGIIvZHZGGLXGEH7FeSuMV8buKxPGFWG3arG8e9LGvDdz5dgTien4y6G5AQ0o1iQdXDos5VWdH3u7k5PrsvdEOpvMi6uSd8a42na80FsYlgGlwM5upydcWUC5Un2HCkJpT1xgk2L6shdVTrK6bidRrqE784FhW9bBQePzGaxSupPENZya0VUctRt+7uq3QwIn4y5jzjgX0E0jgmqPrgiVDjBesMQZYfGPCGysWYWYzfoh+G6V7N2VVGtNnGUwNWzM0WJBPONAgxPv+AmixFRCQ==", "AuthPrincipalType": "SubUser", "AuthPrincipalDisplayName": "202515810214480629", "NoPermissionType": "ImplicitDeny", "AuthAction": "adb:DescribeExcessivePrimaryKeys" }

樣本

正常返回樣本

JSON格式

{
  "TotalCount": "300",
  "PageNumber": 1,
  "PageSize": 30,
  "RequestId": "863D51B7-5321-41D8-A0B6-A088B0******",
  "DBClusterId": "am-bp1ub9grke1****",
  "Tables": [
    {
      "TableName": "test",
      "SchemaName": "adb_demo",
      "ColumnCount": 21,
      "PrimaryKeyCount": 2,
      "PrimaryKeyColumns": "id,date\n",
      "SpaceRatio": 23,
      "TotalSize": 4,
      "PrimaryKeyIndexSize": 222
    }
  ],
  "DetectionItems": [
    {
      "Name": "主鍵過多檢測",
      "Message": "檢測到多個表存在主鍵過多的問題",
      "Status": "NORMAL\nWARNNING\nCRITICAL"
    }
  ],
  "AccessDeniedDetail": "{\n    \"PolicyType\": \"AccountLevelIdentityBasedPolicy\",\n    \"AuthPrincipalOwnerId\": \"1906102576997697\",\n    \"EncodedDiagnosticMessage\": \"AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcNqPqHV6lwR4INiAGjIvK1ngXxN1O+6ORRB6A8YvztEOGywOk81ZmuNk0YrNy+qk7+UVDTHeXKsy8h9e/ePY/LMidj0RCmDpo/YpCumd0UGe0qEPe2U+UJAm/+UHlnEFLVg6BP3yIB5D++MCy7mgWm8Kwyhk62IeYly4hQ+5IpXjkh1GQXuDgLVVPVpxEek9n30vnCUL4KsaMgfa7dgojb+3TM8xGsD2zVK5STJNrsXclscIJEqyNXd7CBYiRJVZi1HPO6drN9WW0chLpCSTgjO8n0bNanZaxXKumW9PSwV58UoSFASeMWfZK3TLngX+oq8nGmnTwcJosVjfF4RGzAnS1IXt0Q9N2WHDnpwyLBU/nOz7Hsy8IZ+h+OVjsBTXSM9688/vOF707a5mNzpETvQeGRcua3A5livcKAM2cML0yeUs/Zyj/+BGqtVa+wektspDHC/CECh6R5lxQjRmUdPawY8VDs2onmdLuEH8DdmYt+Yv/jBFBUMWOyAluzkPYcX5nuQKouCIUJUFTSbsJsuH5CTIh7Ls5rbmkj+T1qTVz8gnDR8LxwaqoMSna+elXgVyOOxXtMkenVntsmoC3p/4G7yTPL1hu8JyWGIIvZHZGGLXGEH7FeSuMV8buKxPGFWG3arG8e9LGvDdz5dgTien4y6G5AQ0o1iQdXDos5VWdH3u7k5PrsvdEOpvMi6uSd8a42na80FsYlgGlwM5upydcWUC5Un2HCkJpT1xgk2L6shdVTrK6bidRrqE784FhW9bBQePzGaxSupPENZya0VUctRt+7uq3QwIn4y5jzjgX0E0jgmqPrgiVDjBesMQZYfGPCGysWYWYzfoh+G6V7N2VVGtNnGUwNWzM0WJBPONAgxPv+AmixFRCQ==\",\n    \"AuthPrincipalType\": \"SubUser\",\n    \"AuthPrincipalDisplayName\": \"202515810214480629\",\n    \"NoPermissionType\": \"ImplicitDeny\",\n    \"AuthAction\": \"adb:DescribeExcessivePrimaryKeys\"\n  }"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

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

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

變更歷史

更多資訊,參考變更詳情