空間インデックス ストアド プロシージャ - 引数とプロパティ

  • [アーティクル]

適用対象:SQL Server

この記事では、空間インデックス ストアド プロシージャの引数とプロパティについて説明します。

Transact-SQL 構文表記規則

構文

特定の空間インデックス ストアド プロシージャの構文については、次の記事を参照してください。

引数

[ @tabname = ] N'tabname'

空間インデックスが指定されているテーブルの修飾名または非修飾名。

引用符は、修飾テーブルが指定されている場合にのみ必要です。 データベース名を含む完全修飾名を指定する場合、データベース名は現在のデータベースの名前である必要があります。 @tabname は nvarchar(776)で、既定値はありません。

[ @indexname = ] 'indexname'

指定された空間インデックスの名前。 @indexname は sysname で、既定値はありません。

[ @verboseoutput = ] verboseoutput

返されるプロパティ名と値の範囲。

  • 0 = コア プロパティ
  • >0 = すべてのプロパティ

@verboseoutput は tinyint で、既定値はありません。

[ @query_sample = ] 'query_sample'

インデックスの有用性をテストするために使用できる代表的なクエリ サンプル。 代表的なオブジェクトまたはクエリ ウィンドウを指定できます。 query_sample は ジオメトリ であり、既定値はありません。

[ @xml_output = ] 'xml_output'

XML フラグメント内の結果セットを返す出力パラメーター。 xml_output は xml で、既定値はありません。

プロパティ

次の表に示すようにコア プロパティを返すか@verboseoutput > 0、空間インデックスのすべてのプロパティを返す場合は を設定@verboseoutput = 0します。

Base_Table_Rows

ベース テーブル内の行数。 値は bigint です。

Bounding_Box_xmin

geometry 型の空間インデックスの X 最小境界ボックス プロパティ。 このプロパティ値は、 geography 型の場合は NULL です。 値は float です。

Bounding_Box_ymin

ジオメトリ タイプの空間インデックスの Y 最小境界ボックス プロパティ。 このプロパティ値は、 geography 型の場合は NULL です。 値は float です。

Bounding_Box_xmax

geometry 型の空間インデックスの X-maximum 境界ボックス プロパティ。 このプロパティ値は、 geography 型の場合は NULL です。 値は float です。

Bounding_Box_ymax

ジオメトリ タイプの空間インデックスの Y-maximum 境界ボックス プロパティ。 このプロパティ値は、 geography 型の場合は NULL です。 値は float です。

Grid_Size_Level_1

空間インデックスのレベル 1 グリッド密度:

  • LOW の場合は 16
  • MEDIUM の場合は 64。
  • HIGH の場合は 256。

値は int です。

Grid_Size_Level_2

空間インデックスのレベル 2 グリッド密度:

  • LOW の場合は 16
  • MEDIUM の場合は 64。
  • HIGH の場合は 256。

値は int です。

Grid_Size_Level_3

空間インデックスのレベル 3 グリッド密度:

  • LOW の場合は 16
  • MEDIUM の場合は 64。
  • HIGH の場合は 256。

値は int です。

Grid_Size_Level_4

空間インデックスのレベル 4 のグリッド密度。

  • LOW の場合は 16
  • 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 でテセレーションされるインデックス付きオブジェクトのセル インスタンスの数 ( ジオメトリの境界ボックスの外側にあるルート セル)。 これはコア プロパティです。 値は bigint です。

ジオメトリ インデックスの場合、インデックスの境界ボックスがデータ ドメインよりも小さい場合に発生します。 レベル 0 のオブジェクトの数が多い場合は、クエリ ウィンドウが境界ボックスの一部を外れ、インデックスのパフォーマンスが低下した場合に、セカンダリ フィルターが必要になることがあります ( たとえば、Total_Number_Of_ObjectCells_In_Level0_For_QuerySample は 1 です)。 クエリ ウィンドウが境界ボックス内にある場合、レベル 0 のオブジェクトの数が多くなると、実際にはインデックスのパフォーマンスが向上する可能性があります。

NULL インスタンスと空のインスタンスはレベル 0 でカウントされますが、パフォーマンスには影響しません。 レベル 0 には、NULL インスタンスと空のインスタンスと同じ数のセルがベース テーブルにあります。 geography インデックスの場合、クエリ サンプルは 1 としてカウントされるため、レベル 0 には 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 です。

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 です。

アクセス許可

ユーザーは パブリック ロールのメンバーである必要があります。 サーバーと オブジェクトに対する READ ACCESS 権限が必要です。 これは、すべての空間インデックス ストアド プロシージャに適用されます。

解説

NULL 値を含むプロパティは、戻り値セットには含まれません。

例

たとえば、次の記事を参照してください。

関連項目