全部產品
Search
文件中心

AnalyticDB:DescribeExcessivePrimaryKeys - 檢測主鍵過多表

更新時間:Feb 26, 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-bp1u8c0mgfg58****

RegionId

string

地區 ID。

說明

您可以調用 DescribeRegions 介面查看指定數倉版叢集的地區 ID。

cn-beijing

StartTime

string

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

2021-09-30T00:10Z

EndTime

string

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

2023-05-15T07:15Z

PageSize

integer

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

  • 30(預設值)。

  • 50

  • 100

20

PageNumber

integer

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

1

Lang

string

設定建議的顯示語言,取值說明:

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

  • en:英文。

  • ja:日文。

  • zh-tw:繁體中文。

zh

Order

string

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

  • Field表示排序欄位。支援如下取值:
    • TableSchema:表所屬的資料庫名。

    • TableName:表名。

    • AccessCount:表被訪問的次數。

  • Type表示排序方式。支援如下取值:
    • Asc:升序排序。

    • Desc: 降序排序。

說明

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

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

返回參數

名稱

類型

描述

樣本值

object

TotalCount

string

返回的結果總數,取值為:大於等於 0 且不超過 整數資料類型的最大值,預設值為 0。

1

PageNumber

integer

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

1

PageSize

integer

每頁記錄數,取值:

  • 30(預設值)

  • 50

  • 100

10

RequestId

string

請求 ID。

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

DBClusterId

string

叢集 ID。

說明

您可以調用 DescribeDBClusters 介面查看數倉版叢集的叢集 ID。

am-bp11q28kvl688****

Tables

array<object>

表列表。

object

檢測結果清單

TableName

string

表名。

test

SchemaName

string

資料庫名。

adb_demo

ColumnCount

integer

總列數。

26

PrimaryKeyCount

integer

主鍵欄位個數。

1

PrimaryKeyColumns

string

主鍵欄位列表。

id,date

SpaceRatio

number

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

說明

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

20

TotalSize

integer

冷資料總量,單位:Byte。

說明

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

1073741824

PrimaryKeyIndexSize

integer

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

2345

DetectionItems

array<object>

檢測項及檢測結果清單。

object

檢測項及檢測結果清單。

Name

string

檢測項名。

主鍵欄位過多

Message

string

檢測結果。

檢測到表存在主鍵過多的情況

Status

string

檢測結果狀態程度。

NORMAL WARNING 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": "1",
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "DBClusterId": "am-bp11q28kvl688****",
  "Tables": [
    {
      "TableName": "test",
      "SchemaName": "adb_demo",
      "ColumnCount": 26,
      "PrimaryKeyCount": 1,
      "PrimaryKeyColumns": "id,date",
      "SpaceRatio": 20,
      "TotalSize": 1073741824,
      "PrimaryKeyIndexSize": 2345
    }
  ],
  "DetectionItems": [
    {
      "Name": "主鍵欄位過多",
      "Message": "檢測到表存在主鍵過多的情況",
      "Status": "NORMAL\nWARNING\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.

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

變更歷史

更多資訊,參考變更詳情