空間索引預存程式 - 自變數和屬性
適用於：
SQL Server
本文說明空間索引預存程式的自變數和屬性。
Syntax
如需特定空間索引預存程式的語法，請參閱下列文章：
- sp_help_spatial_geometry_index （Transact-SQL）
- sp_help_spatial_geometry_index_xml （Transact-SQL）
- sp_help_spatial_geography_index （Transact-SQL）
- sp_help_spatial_geography_index_xml （Transact-SQL）
引數
[ @tabname = ] N'tabname'
已指定空間索引之數據表的限定或非限定名稱。
只有在指定限定數據表時，才需要引號。 如果提供完整名稱，包括資料庫名稱，資料庫名稱必須是目前資料庫的名稱。 @tabname為 nvarchar（776），沒有預設值。
[ @indexname = ] N'indexname'
指定之空間索引的名稱。 @indexname為 sysname，沒有預設值。
[ @verboseoutput = ] verboseoutput
要傳回的屬性名稱和值範圍。 @verboseoutput是 tinyint，沒有預設值，而且可以是下列其中一個值。
0= 核心屬性>0= 所有屬性
[ @query_sample = ] query_sample
一個代表性的查詢範例，可用來測試索引的實用性。 @query_sample是 geography，沒有預設值。 它可能是代表性對象或查詢視窗。
[ @xml_output = ] N'xml_output' OUTPUT
傳回 XML 片段中的結果集。 @xml_output是 xml 類型的 OUTPUT 參數。
屬性
設定 @verboseoutput = 0 為 傳回如下表所示的核心屬性，或 @verboseoutput > 0 傳回空間索引的所有屬性。
Base_Table_Rows
基表中的數據列數目。 值是 bigint。
Bounding_Box_xmin
幾何類型空間索引的 X 下限周框方塊屬性。 這個屬性值適用於 NULL geography 類型。 值為 float。
Bounding_Box_ymin
幾何類型空間索引的最小周框方塊屬性。 這個屬性值適用於 NULL geography 類型。 值為 float。
Bounding_Box_xmax
幾何類型空間索引的 X 上限周框方塊屬性。 這個屬性值適用於 NULL geography 類型。 值為 float。
Bounding_Box_ymax
幾何類型空間索引的 Y 上限周框方塊屬性。 這個屬性值適用於 NULL geography 類型。 值為 float。
Grid_Size_Level_1
空間索引的第 1 層網格線密度：
- 16 for LOW
- 64 for MEDIUM
- 256 for HIGH
值為 int。
Grid_Size_Level_2
空間索引的第 2 層網格線密度：
- 16 for LOW
- 64 for MEDIUM
- 256 for HIGH
值為 int。
Grid_Size_Level_3
空間索引的層級 3 方格密度：
- 16 for LOW
- 64 for MEDIUM
- 256 for HIGH
值為 int。
Grid_Size_Level_4
空間索引的層級 4 方格密度：
- 16 for LOW
- 64 for MEDIUM
- 256 for HIGH
值為 int。
Cells_Per_Object
每個物件的儲存格數目（index 屬性）。 值為 int。
Total_Primary_Index_Rows
索引中資料列的數目。 值是 bigint。
Total_Primary_Index_Pages
索引中的頁數。 值是 bigint。
Average_Number_Of_Index_Rows_Per_Base_Row
索引數據列/數位基表數據列的數目。 值是 bigint。
Total_Number_Of_ObjectCells_In_Level0_For_QuerySample
指出代表性查詢範例是否落在幾何索引的周框方塊之外，並放入根數據格（層級0單元格）。 這是 0 （不在層級 0 單元格中） 或 1。 如果位於層級0單元格中，調查的索引不是查詢範例的適當索引。 這是核心屬性。 值是 bigint。
Total_Number_Of_ObjectCells_In_Level0_In_Index
在層級 0 中鑲嵌的索引物件儲存格實例數目（根儲存格，幾何周框方塊外）。 這是核心屬性。 值是 bigint。
對於 幾何 索引，如果索引的周框方塊小於數據域，就會發生這種情況。 如果查詢視窗部分落在周框方塊外，並降低索引效能，則層級 0 中的大量物件可能需要次要篩選條件（例如， Total_Number_Of_ObjectCells_In_Level0_For_QuerySample 為 1）。 如果查詢視窗落在周框方塊內，層級0中的大量對象實際上可能會改善索引的效能。
NULL 和空白實例會計算在層級 0，但不會影響效能。 層級0的儲存格 NULL 數目和基表的空白實例數目一樣多。 對於 geography 索引，層級 0 具有和空白實例 +1 單元格數目相同的儲存格 NULL ，因為查詢範例會計算為 1。
Total_Number_Of_ObjectCells_In_Level1_In_Index
以層級 1 有效位數鑲嵌之索引對象的單元格實例數目。 這是核心屬性。 值是 bigint。
Total_Number_Of_ObjectCells_In_Level2_In_Index
以層級 2 有效位數鑲嵌之索引對象的單元格實例數目。 這是核心屬性。 值是 bigint。
Total_Number_Of_ObjectCells_In_Level3_In_Index
以層級 3 有效位數鑲嵌之索引對象的單元格實例數目。 這是核心屬性。 值是 bigint。
Total_Number_Of_ObjectCells_In_Level4_In_Index
以層級 4 精確度鑲嵌的索引物件單元格實例數目。 這是核心屬性。 值是 bigint。
Total_Number_Of_interior_ObjectCells_In_Level1_In_Index
在鑲嵌層級 1 物件完全覆蓋的儲存格數目，因此是對象內部。 （Cell_attributevalue為2.這是核心屬性。 值是 bigint。
Total_Number_Of_interior_ObjectCells_In_Level2_In_Index
物件在鑲嵌層級 2 完全覆蓋的儲存格數目，因此是對象內部。 （Cell_attribute值為 2。）這是核心屬性。 值是 bigint。
Total_Number_Of_interior_ObjectCells_In_Level3_In_Index
物件在鑲嵌層級 3 完全覆蓋的儲存格數目，因此位於物件內部。 （Cell_attribute值為 2。）這是核心屬性。 值是 bigint。
Total_Number_Of_interior_ObjectCells_In_Level4_In_Index
物件在鑲嵌層級 4 完全覆蓋的儲存格數目，因此位於物件內部。 （Cell_attribute值為 2。）這是核心屬性。 值是 bigint。
Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index
以鑲嵌層級 1 的物件交集的單元格數目。 （Cell_attribute值為1。這是核心屬性。 值是 bigint。
Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index
物件在鑲嵌層級 2 交集的儲存格數目。 （Cell_attribute值為1。這是核心屬性。 值是 bigint。
Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index
在鑲嵌層級 3 上，物件交集的單元格數目。 （Cell_attribute值為1。這是核心屬性。 值是 bigint。
Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index
物件在鑲嵌層級 4 交集的儲存格數目。 （Cell_attribute值為1。這是核心屬性。 值是 bigint。
Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample
指出查詢範例是否位於周框方塊外的根數據格 0 中，但碰到它。 這是核心屬性。 值是 bigint。
注意
這項資訊只適用於判斷周框方塊是否可能遺漏的物件。
Total_Number_Of_Border_ObjectCells_In_Level0_In_Index
觸及周框方塊之層級0中的物件數目。 （Cell_attribute值為 0。值是 bigint。
Total_Number_Of_Border_ObjectCells_In_Level1_In_Index
觸碰網格線單元格界限在鑲嵌層級 1 的物件儲存格數目。 （Cell_attribute值為 0。這是核心屬性。 值是 bigint。
Total_Number_Of_Border_ObjectCells_In_Level2_In_Index
在鑲嵌層級 2 觸碰網格線儲存格界限的物件儲存格數目。 （Cell_attribute值為 0。這是核心屬性。 值是 bigint。
Total_Number_Of_Border_ObjectCells_In_Level3_In_Index
在鑲嵌層級 3 觸碰網格線儲存格界限的物件儲存格數目。 （Cell_attribute值為 0。這是核心屬性。 值是 bigint。
Total_Number_Of_Border_ObjectCells_In_Level4_In_Index
在鑲嵌層級 4 觸碰網格線儲存格界限的物件儲存格數目。 （Cell_attribute值為 0。這是核心屬性。 值是 bigint。
Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
方格的總區域（總分葉單元格）百分比，其中包含對象所覆蓋的分葉單元格。
例如，物件會在四個不同的網格線層級鑲嵌成 10 個儲存格，涵蓋相當於總計 100 個分葉單元格的區域。 假設物件完全涵蓋三個內部儲存格。 三個內部儲存格所覆蓋的區域相當於42個分葉單元格。 因此，覆蓋面積的百分比為42%。 這是一個很好的量值，可測量索引中物件的切割程度。
值為 float。
Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
與 Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage相同，不同之處在於這些是部分涵蓋的單元格。 值為 float。
Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
與 Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage 相同，不同之處在於這些是框線單元格。 值為 float。
Average_Cells_Per_Object_Normalized_To_Leaf_Grid
標準化為分葉網格線的每個物件的平均儲存格。 這可讓我們指出對象的空間大小，或物件的大小。 值為 float。
Average_Objects_PerLeaf_GridCell
索引的疏鬆性。 每個分葉數據格的平均物件數目。 值為 float。
Number_Of_SRIDs_Found
索引和數據行中唯一 SRID 的數目。 值為 int。
因為數據行可以包含一個以上的 SRID，而且不同 SRID 的對象永遠不會交集，所以 SRID 的數目表示索引的選擇性。
Width_Of_Cell_In_Level1
索引方格中儲存格的 Width 屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Width_Of_Cell_In_Level2
索引方格中儲存格的 Width 屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Width_Of_Cell_In_Level3
索引方格中儲存格的 Width 屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Width_Of_Cell_In_Level4
索引方格中儲存格的 Width 屬性。 度量單位是由索引所提供，且相依於索引數據的SRID。 值為 float。
Height_Of_Cell_In_Level1
索引方格中儲存格的高度屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Height_Of_Cell_In_Level2
索引方格中儲存格的高度屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Height_Of_Cell_In_Level3
索引方格中儲存格的高度屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Height_Of_Cell_In_Level4
索引方格中儲存格的高度屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Area_Of_Cell_In_Level1
索引方格中儲存格的區域屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Area_Of_Cell_In_Level2
索引方格中儲存格的區域屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Area_Of_Cell_In_Level3
索引方格中儲存格的區域屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
Area_Of_Cell_In_Level4
索引方格中儲存格的區域屬性。 度量單位是由索引所提供，且取決於索引數據的 SRID。 值為 float。
CellArea_To_BoundingBoxArea_Percentage_In_Level1
第 1 層儲存格涵蓋周框方塊的百分比。 值為 float。
CellArea_To_BoundingBoxArea_Percentage_In_Level2
第2層儲存格涵蓋周框方塊的百分比。 值為 float。
CellArea_To_BoundingBoxArea_Percentage_In_Level3
第 3 層儲存格涵蓋周框方塊的百分比。 值為 float。
CellArea_To_BoundingBoxArea_Percentage_In_Level4
第 4 層儲存格涵蓋周框方塊的百分比。 值為 float。
Number_Of_Rows_Selected_By_Primary_Filter
主要篩選所選取的數據列數目。 這是核心屬性。 值是 bigint。
Number_Of_Rows_Selected_By_Internal_Filter
內部篩選所選取的數據列數目。 不會針對這些數據列呼叫次要篩選。 這是核心屬性。 值是 bigint。
傳回的數位只適用於 STintersects。
Number_Of_Times_Secondary_Filter_Is_Called
呼叫次要篩選的次數。 這是核心屬性。 值是 bigint。
Percentage_Of_Rows_NotSelected_By_Primary_Filter
如果基表中有 N 個數據列，且主要篩選會選取 P，這會以百分比傳回 （N-P）/N。 這是核心屬性。 值為 float。
Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter
如果主要篩選條件選取 P 數據列，而內部篩選條件選取 S 數據列，則會以百分比傳回 S/P。 百分比越高，索引越好，可避免效能成本較高的次要篩選條件。 這是核心屬性。 值為 float。
Number_Of_Rows_Output
查詢輸出的數據列數目。 這是核心屬性。 值是 bigint。
Internal_Filter_Efficiency
如果 O 是數據列輸出的數目，這會以百分比傳回 S/O。 這是核心屬性。 值為 float。
Primary_Filter_Efficiency
如果主要篩選選取 P 數據列，而 O 是數據列輸出的數目，則會以百分比傳回 O/P。 主要篩選效率越高，次要篩選條件必須處理的誤判越少。 這是核心屬性。 值為 float。
權限
用戶必須是公用角色的成員。 需要伺服器和物件的 READ ACCESS 許可權。 這適用於所有空間索引預存程式。
備註
包含 NULL 值的屬性不會包含在傳回集中。
範例
如需範例，請參閱下列文章：
- sp_help_spatial_geometry_index （Transact-SQL）
- sp_help_spatial_geometry_index_xml （Transact-SQL）
- sp_help_spatial_geography_index （Transact-SQL）
- sp_help_spatial_geography_index_xml （Transact-SQL）