空間索引預存程式 - 自變數和屬性

適用於：SQL Server

本文說明空間索引預存程式的自變數和屬性。

Transact-SQL 語法慣例

Syntax

如需特定空間索引預存程式的語法，請參閱下列文章：

• sp_help_spatial_geometry_index
• sp_help_spatial_geometry_index_xml
• sp_help_spatial_geography_index
• sp_help_spatial_geography_index_xml

引數

[ @tabname = ] N'tabname'

已指定空間索引之數據表的限定或非限定名稱。

只有在指定限定數據表時，才需要引號。 如果提供完整名稱，包括資料庫名稱，資料庫名稱必須是目前資料庫的名稱。 @tabname為 nvarchar（776），沒有預設值。

[ @indexname = ] 'indexname'

指定之空間索引的名稱。 @indexname為沒有預設值的 sysname。

[ @verboseoutput = ] verboseoutput

要傳回的屬性名稱和值範圍。

• 0 = 核心屬性
• >0 = 所有屬性

@verboseoutput為 tinyint，沒有預設值。

[ @query_sample = ] 'query_sample'

一個代表性的查詢範例，可用來測試索引的實用性。 它可以是代表性對象或查詢視窗。 query_sample是沒有預設值的geometry。

[ @xml_output = ] 'xml_output'

傳回 XML 片段中結果集的輸出參數。 xml_output為 xml，沒有預設值。

屬性

設定 @verboseoutput = 0 為 傳回如下表所示的核心屬性，或 @verboseoutput > 0 傳回空間索引的所有屬性。

Base_Table_Rows

基表中的數據列數目。 值是 bigint。

Bounding_Box_xmin

幾何類型空間索引的 X 下限周框方塊屬性。 這個屬性值是 geography 類型的 NULL。 值為 float。

Bounding_Box_ymin

幾何類型空間索引的最小周框方塊屬性。 這個屬性值是 geography 類型的 NULL。 值為 float。

Bounding_Box_xmax

幾何類型空間索引的 X 上限周框方塊屬性。 這個屬性值是 geography 類型的 NULL。 值為 float。

Bounding_Box_ymax

幾何類型空間索引的 Y 上限周框方塊屬性。 這個屬性值是 geography 類型的 NULL。 值為 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 和空白實例一樣多的儲存格。 對於 地理位置 索引，層級0的儲存格數目與NULL和空白實例 +1 單元格一樣多，因為查詢範例會計算為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）

相關內容

• sp_help_spatial_geometry_index （Transact-SQL）
• 空間索引概觀
• XQuery 基本概念
• Xquery 語言參考 (SQL Server)