sp_help_spatial_geometry_index_xml (Transact-SQL)

[アーティクル]
05/23/2023

適用対象:SQL Server

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

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

構文

  
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 言語リファレンス