• Artikel

sp_help_spatial_geometry_index_xml (Transact-SQL)

Gibt die Namen und Werte für einen angegebenen Satz von Eigenschaften über einen geometry-Räumlichkeitsindex zurück. Sie können wählen, ob ein Kernsatz von Eigenschaften oder alle Eigenschaften des Index zurückgegeben werden sollen.

Ergebnisse werden in einem XML-Fragment zurückgegeben, das den Namen und den Wert der ausgewählten Eigenschaften anzeigt.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Berechtigungen

Der Benutzer muss ein Mitglied der Datenbankrolle public sein. Erfordert die READ ACCESS-Berechtigung für den Server und das Objekt.

Hinweise

Eigenschaften, die NULL-Werte enthalten sind, sind nicht in der zurückgegebenen XML-Menge enthalten.

Beispiel

Das folgende Beispiel verwendet sp_help_spatial_geometry_index_xml, um den Räumlichkeitsindex SIndx_SpatialTable_geometry_col2 zu analysieren, der in der Tabelle geometry_col für das angegebene Abfragebeispiel in @qs definiert ist. Dieses Beispiel gibt die Kerneigenschaften des angegebenen Index in einem XML-Fragment zurück, das den Namen und den Wert der ausgewählten Eigenschaften anzeigt.

Anschließend wird eine XQuery für das Resultset ausgeführt, die eine bestimmte Eigenschaft zurückgibt.

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');

Ähnlich wie sp_help_spatial_geometry_index ermöglicht diese gespeicherte Prozedur einen vereinfachten programmgesteuerten Zugriff auf die Eigenschaften eines Räumlichkeitsindex und dokumentiert das Resultset in XML.