sp_help_spatial_geometry_index_xml (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

ジオメトリ空間インデックスに関する指定されたプロパティ セットの名前と値を返します。 プロパティのコア セットまたはインデックスのすべてのプロパティを返すように選択できます。

結果は、選択したプロパティの名前と値を表示する XML フラグメントで返されます。

Transact-SQL 構文表記規則

構文

  
sp_help_spatial_geometry_index [ @tabname =] 'tabname'   
     [ , [ @indexname = ] 'indexname' ]   
     [ , [ @verboseoutput = ]'{ 0 | 1 }]   
     [ , [ @query_sample = ] 'query_sample' ]   
     [ ,.[ @xml_output = ] 'xml_output' ]

引数

「空間インデックス ストアド プロシージャの引数とプロパティ」を参照してください。

プロパティ

「空間インデックス ストアド プロシージャの引数とプロパティ」を参照してください。

アクセス許可

ユーザーは パブリック ロールのメンバーである必要があります。 サーバーと オブジェクトに対する READ ACCESS 権限が必要です。

解説

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

例

次の例では、 を使用 sp_help_spatial_geometry_index_xml して 、@qs の特定のクエリ サンプルのテーブル geometry_col で定義されている空間インデックス SIndx_SpatialTable_geometry_col2を調査します。 次の使用例は、選択したプロパティの名前と値を表示する XML フラグメント内の指定したインデックスのコア プロパティを返します。

その後、 XQuery が結果セットで実行され、特定のプロパティが返されます。

DECLARE @qs geometry  
        ='POLYGON((-90.0 -180.0, -90.0 180.0, 90.0 180.0, 90.0 -180.0, -90.0 -180.0))';  
DECLARE @x xml;  
EXEC sp_help_spatial_geometry_index_xml 'geometry_col', 'SIndx_SpatialTable_geometry_col2', 0, @qs, @x output;  
SELECT @x.value('(/Primary_Filter_Efficiency/text())[1]', 'float');

sp_help_spatial_geometry_indexと同様に、このストアド プロシージャを使用すると、空間インデックスのプロパティへのプログラムによるアクセスが簡単になり、結果セットが XML で報告されます。

必要条件

参照

空間インデックス ストアド プロシージャの引数とプロパティ
空間インデックス ストアド プロシージャ
sp_help_spatial_geometry_index
空間インデックスの概要
空間データ (SQL Server)
XQuery の基礎
XQuery 言語リファレンス