GetInstanceMissingIndexList - 查詢RDS SQL Server執行個體索引缺失情況 -

調用GetInstanceMissingIndexList介面，查詢RDS SQL Server執行個體所有缺失索引的詳細資料。

介面說明

本介面僅適用於 RDS SQL Server 版執行個體。
使用阿里雲或 DAS 的 SDK 時，建議使用最新版本。
在使用 SDK 調用 DAS 服務時，需要將地區指定為 cn-shanghai。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

hdm:GetInstanceMissingIndexList

list

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
InstanceId	string	是	資料庫執行個體 ID。	rm-t4nfalp2ap421****
PageNo	string	否	分頁查詢的頁碼，從 1 開始，預設為 1。	1
PageSize	string	否	每頁最大記錄數，預設值為 10。	10
ObjectName	string	否	對象名。	bas_customer
ReservedSize	string	否	表總空間篩選條件。單位為 MB。輸入格式為`運算子+分割服“\|”+表總空間大小`，例如篩選條件設定為查詢總空間大於等於 100M 的表時，輸入：`>=\|100`。	>=\|100
RowCount	string	否	表記錄數篩選條件。輸入格式為`運算子+分割服“\|”+表記錄數`，例如`>=\|100`。	>=\|100000
ReservedPages	string	否	總頁數篩選條件。輸入格式為`運算子+分割服“\|”+總頁數`，例如`>=\|100`。	>=\|100
IndexCount	string	否	索引個數（索引缺失表目前所擁有的索引個數）篩選條件。輸入格式為`運算子+分割服“\|”+索引個數`，例如`>=\|100`。	>=\|8
UniqueCompiles	string	否	編譯次數篩選條件。輸入格式為`運算子+分割服“\|”+編譯次數`，例如`>=\|100`。	>=\|10000
UserSeeks	string	否	尋找次數篩選條件。輸入格式為`運算子+分割服“\|”+尋找次數`，例如`>=\|100`。	>=\|1000
UserScans	string	否	掃描次數篩選條件。輸入格式為`運算子+分割服“\|”+掃描次數`，例如`>=\|100`。	>=\|10000
AvgTotalUserCost	string	否	平均開銷節約百分比（預測建立了缺失索引後，使用者的平均 CPU 開銷節約百分比。）篩選條件。輸入格式為`運算子+分割服“\|”+平均開銷節約百分比`，例如篩選條件設定為查詢平均開銷節約百分比小於等於 10%時，輸入：`<=\|10`。	<=\|8
AvgUserImpact	string	否	效能提升百分比（預測建立了缺失索引後，使用者的平均查詢效能提升百分比。）篩選條件。輸入格式為`運算子+分割服“\|”+效能提升百分比`，例如篩選條件設定為查詢效能提升百分比大於等於 100%時，輸入：`>=\|100`。	>\|10000
StartTime	string	否	索引最後尋找時間的開始時間。格式為 Unix 時間戳記，單位為毫秒。	1679414400000
EndTime	string	否	索引最後尋找時間的結束時間。格式為 Unix 時間戳記，單位為毫秒。	1681869544000

返回參數

名稱	類型	描述	樣本值
	object
Code	string	返回的狀態代碼。	200
Message	string	請求返回訊息。說明請求成功時該參數返回 Successful，請求失敗時會返回請求異常資訊（如錯誤碼等）。	Successful
Data	object	詳細資料列表。
List	array<object>	返回資訊列表。
	object	記錄詳情。
AvgTotalUserCost	number	預測建立了缺失索引後，使用者的平均 CPU 開銷節約百分比。	4.67
AvgUserImpact	number	預測建立了缺失索引後，使用者的平均查詢效能提升百分比。	98.3
DatabaseName	string	資料庫名稱。	testdb
EqualityColumns	string	相等列。缺失索引被使用來做等於查詢的列。	col1,col2,col3
IncludedColumns	string	包含列。缺失索引包含列。	col3,col4
IndexCount	integer	索引個數。索引缺失表目前所擁有的索引個數。	1
LastUserSeek	integer	使用者最後尋找時間。缺失索引使用者最後的尋找時間點。	1702023327000
ObjectName	string	對象名。	stu
ReservedPages	integer	總頁數。	5025
ReservedSize	number	總空間大小。	39.26
RowCount	integer	記錄數。	226945
SchemaName	string	架構名。	dbo
SystemScans	integer	掃描次數。	0
SystemSeeks	integer	尋找次數。	0
UniqueCompiles	integer	編譯次數。	2392
UserScans	integer	使用者掃描次數。索引缺失表被掃描的次數。	0
UserSeeks	integer	使用者尋找次數。索引缺失被尋找的次數。	1081
InequalityColumns	string	不等列。缺失索引被使用來做不等於查詢的列。	2392
CreateIndex	string	索引建立語句。您可以使用這個語句來建立缺失索引。	CREATE INDEX [IX_CLOUDDBA_school_dbo_stu@col1_@col2] ON [school].[dbo].[stu]([col1],[col2],[col3]) INCLUDE ([col4],[col5]) WITH (FILLFACTOR = 90, ONLINE = OFF);
PageNo	integer	頁碼。	1
PageSize	integer	每頁數量。	10
Total	integer	總記錄數。	16
RequestId	string	請求 ID。	0A74B755-98B7-59DB-8724-1321B394****
Success	string	請求是否執行成功： true：執行成功。 false：執行失敗。	true

樣本

正常返回樣本

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "Data": {
    "List": [
      {
        "AvgTotalUserCost": 4.67,
        "AvgUserImpact": 98.3,
        "DatabaseName": "testdb",
        "EqualityColumns": "col1,col2,col3",
        "IncludedColumns": "col3,col4",
        "IndexCount": 1,
        "LastUserSeek": 1702023327000,
        "ObjectName": "stu",
        "ReservedPages": 5025,
        "ReservedSize": 39.26,
        "RowCount": 226945,
        "SchemaName": "dbo",
        "SystemScans": 0,
        "SystemSeeks": 0,
        "UniqueCompiles": 2392,
        "UserScans": 0,
        "UserSeeks": 1081,
        "InequalityColumns": "2392",
        "CreateIndex": "CREATE INDEX [IX_CLOUDDBA_school_dbo_stu@col1_@col2] ON [school].[dbo].[stu]([col1],[col2],[col3]) INCLUDE ([col4],[col5]) WITH (FILLFACTOR = 90, ONLINE = OFF);"
      }
    ],
    "PageNo": 1,
    "PageSize": 10,
    "Total": 16
  },
  "RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
  "Success": "true"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidParams	The request parameters are invalid.	請求參數錯誤
403	NoPermission	You are not authorized to do this action.	沒有許可權執行該操作

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

變更歷史

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