空間インデックス ストアド プロシージャ - 引数とプロパティ
適用対象: 
SQL サーバー
この記事では、空間インデックス ストアド プロシージャの引数とプロパティについて説明します。
構文
特定の空間インデックス ストアド プロシージャの構文については、次の記事を参照してください。
- 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
geometry 型の空間インデックスの X 最小境界ボックス プロパティ。 このプロパティ値は、geography 型にNULLされます。 値は float です。
Bounding_Box_ymin
geometry 型の空間インデックスの Y 最小境界ボックス プロパティ。 このプロパティ値は、geography 型にNULLされます。 値は float です。
Bounding_Box_xmax
geometry 型の空間インデックスの X-maximum 境界ボックス プロパティ。 このプロパティ値は、geography 型にNULLされます。 値は float です。
Bounding_Box_ymax
geometry 型の空間インデックスの Y-maximum 境界ボックスプロパティ。 このプロパティ値は、geography 型にNULLされます。 値は float です。
Grid_Size_Level_1
空間インデックスのレベル 1 グリッド密度:
- 16 (LOW の場合)
- MEDIUM の場合は 64。
- HIGH の場合は 256。
値は int です。
Grid_Size_Level_2
空間インデックスのレベル 2 グリッド密度:
- 16 (LOW の場合)
- MEDIUM の場合は 64。
- HIGH の場合は 256。
値は int です。
Grid_Size_Level_3
空間インデックスのレベル 3 グリッド密度:
- 16 (LOW の場合)
- MEDIUM の場合は 64。
- HIGH の場合は 256。
値は int です。
Grid_Size_Level_4
空間インデックスのレベル 4 のグリッド密度。
- 16 (LOW の場合)
- MEDIUM の場合は 64。
- HIGH の場合は 256。
値は int です。
Cells_Per_Object
オブジェクトあたりのセル数 (インデックス プロパティ)。 値は 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
代表的なクエリ サンプルが、 geometry インデックスの境界ボックスの外にあり、ルート セル (レベル 0 のセル) に含まれるかどうかを示します。 この値は、0 (レベル 0 のセル外) または 1 のいずれかです。 レベル 0 のセルにある場合、調査対象のインデックスはクエリ サンプルに適したインデックスではありません。 これはコア プロパティです。 値は bigint です。
Total_Number_Of_ObjectCells_In_Level0_In_Index
レベル 0 でテッセレーションされたインデックス付きオブジェクトのセル インスタンスの数 (ルート セル、 geometry の境界ボックスの外側)。 これはコア プロパティです。 値は bigint です。
geometry インデックスの場合、インデックスの境界ボックスがデータ ドメインよりも小さい場合に発生します。 レベル 0 のオブジェクトの数が多い場合は、クエリ ウィンドウが境界ボックスの一部外に入り、インデックスのパフォーマンスが低下した場合 (たとえば、 Total_Number_Of_ObjectCells_In_Level0_For_QuerySample は 1) にセカンダリ フィルターが必要になる場合があります。 クエリ ウィンドウが境界ボックス内にある場合、レベル 0 のオブジェクトの数が多い場合は、インデックスのパフォーマンスが実際に向上する可能性があります。
NULL インスタンスと空のインスタンスはレベル 0 でカウントされますが、パフォーマンスには影響しません。 レベル 0 には、基本テーブルの NULL と空のインスタンスの数のセルが含まれます。 geography インデックスの場合、レベル 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 です。
Note
この情報は、境界ボックスが密接に見落とされた可能性があるオブジェクトがあるかどうかを判断する場合にのみ役立ちます。
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
オブジェクトの対象となるリーフ セルを含むグリッドの合計領域 (リーフ セルの合計) の割合。
たとえば、オブジェクトは、合計で 100 個のリーフ セルに相当する領域をカバーする 4 つの異なるグリッド レベルで 10 個のセルにテッセレーションされます。 オブジェクトによって完全に覆われている 3 つの内部セルがあるとします。 3 つの内部セルで覆われた領域は、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
インデックス作成グリッド内のセルの Height プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Height_Of_Cell_In_Level2
インデックス作成グリッド内のセルの Height プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Height_Of_Cell_In_Level3
インデックス作成グリッド内のセルの Height プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Height_Of_Cell_In_Level4
インデックス作成グリッド内のセルの Height プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Area_Of_Cell_In_Level1
インデックス作成グリッド内のセルの Area プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Area_Of_Cell_In_Level2
インデックス作成グリッド内のセルの Area プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Area_Of_Cell_In_Level3
インデックス作成グリッド内のセルの Area プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの SRID に依存します。 値は float です。
Area_Of_Cell_In_Level4
インデックス作成グリッド内のセルの Area プロパティ。 測定単位はインデックスによって提供され、インデックス付きデータの 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 です。
アクセス許可
ユーザーは、 public ロールのメンバーである必要があります。 サーバーとオブジェクトに対する 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)