全部產品
Search
文件中心

AnalyticDB:DescribeAppliedAdvices - 顯示已採納的最佳化

更新時間:Mar 27, 2026

顯示已採納的最佳化建議。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

adb:DescribeAppliedAdvices

get

*DBClusterLakeVersion

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

請求參數

名稱

類型

必填

描述

樣本值

DBClusterId

string

叢集 ID。

am-uf6g8w25jacm7****

RegionId

string

地區 ID。

cn-hangzhou

StartTime

integer

查詢建議的開始日期,格式為 yyyyMMdd。

20220811

EndTime

integer

查詢建議的結束日期,格式為 yyyyMMdd。

20220824

Lang

string

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

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

  • en:英文。

  • ja:日文。

  • zh-tw:繁體中文。

zh

PageSize

integer

每頁記錄數,取值:

  • 30(預設值)

  • 50

  • 100

30

PageNumber

integer

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

1

AdviceType

string

建議的類型,取值說明:

  • INDEX:索引最佳化。

  • TIERING:冷熱資料最佳化。

INDEX

Keyword

string

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

you_table_name

SchemaTableName

string

資料庫名和表名。格式為資料庫.表

tpch.lineitem

Order

string

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

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

    • TableName:表名。

    • JobStatus:表 Build 任務狀態。

    • SubmitTime:建議下發的時間。

    • Benefit:預期最佳化收益。

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

    • Desc: 降序排序。

說明

若不設定參數,預設按照最佳化建議下發的時間降序排列。

[{\"Field\":\"AdviceType\",\"Type\":\"Desc\"}]

返回參數

名稱

類型

描述

樣本值

object

返回對象。

Items

array<object>

詳情。

object

建議列表。

AdviceId

string

建議 ID。

7417db9c-914d-43f3-a123-4d0e448f****

SubmitTime

string

建議下發的時間,格式:yyMMddHHmm(UTC 時間)。

2208131600

SubmitStatus

string

建議的下髮狀態。 取值說明:

  • SUCCEED:成功。

  • FAILED:失敗。

SUCCEED

SQL

string

應用建議的 SQL 陳述式。

alter table `schema1`.`table1` drop key col1_1_idx

RollbackSQL

string

復原建議的 SQL 陳述式。

alter table `schema1`.`table1` add key col1_1_idx(col1)

JobStatus

string

執行建議的任務的狀態。 取值說明:

  • SUCCEED:成功。

  • FAILED:失敗。

SUCCEED

Benefit

string

建議的收益。

節省0.4 GB的儲存空間

BuildSQL

string

執行 Build 任務的 SQL 陳述式。

build table `schema1`.`table1`

TotalCount

integer

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

1

PageSize

integer

每頁記錄數,取值:

  • 30(預設值)

  • 50

  • 100

30

PageNumber

integer

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

1

SchemaName

string

資料庫名。

adb_demo

TableName

string

表名。

test

IndexFields

string

索引欄位。

message

PageNumber

integer

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

1

PageSize

integer

每頁記錄數,取值:

  • 30(預設值)

  • 50

  • 100

30

RequestId

string

請求 ID。

84489769-3065-5A28-A4CB-977CD426F1C3

TotalCount

integer

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

1

SchemaTableNames

array

資料庫名和表名的字串拼接。

string

資料庫名和表名的字串拼接。

[ "tpch.lineitem", "tpch.partsupp", "tpch.orders" ]

樣本

正常返回樣本

JSON格式

{
  "Items": [
    {
      "AdviceId": "7417db9c-914d-43f3-a123-4d0e448f****",
      "SubmitTime": "2208131600",
      "SubmitStatus": "SUCCEED",
      "SQL": "alter table `schema1`.`table1` drop key col1_1_idx",
      "RollbackSQL": "alter table `schema1`.`table1` add key col1_1_idx(col1)",
      "JobStatus": "SUCCEED",
      "Benefit": "節省0.4 GB的儲存空間",
      "BuildSQL": "build table `schema1`.`table1`",
      "TotalCount": 1,
      "PageSize": 30,
      "PageNumber": 1,
      "SchemaName": "adb_demo",
      "TableName": "test",
      "IndexFields": "message"
    }
  ],
  "PageNumber": 1,
  "PageSize": 30,
  "RequestId": "84489769-3065-5A28-A4CB-977CD426F1C3",
  "TotalCount": 1,
  "SchemaTableNames": [
    "[\n  \"tpch.lineitem\",\n  \"tpch.partsupp\",\n  \"tpch.orders\"\n]"
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情