sp_help_spatial_geography_index_xml (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Gibt den Namen und den Wert für einen angegebenen Eigenschaftssatz über einen räumlichen geography -Index zurück. Sie können wählen, ob ein Kernsatz von Eigenschaften oder alle Eigenschaften des Indexes zurückgegeben werden sollen.

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

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_help_spatial_geography_index_xml [ @tabname =] 'tabname'   
     [ , [ @indexname = ] 'indexname' ]   
     [ , [ @verboseoutput = ] 'verboseoutput' ]   
     [ , [ @query_sample = ] 'query_sample' ]   
     [ ,.[ @xml_output = ] 'xml_output' ]

Argumente

Siehe Arguments and Properties of Spatial Index Stored Procedures.

Eigenschaften

Siehe Arguments and Properties of Spatial Index Stored Procedures.

Berechtigungen

Dem Benutzer muss eine PUBLIC-Rolle zugewiesen werden, um auf die Prozedur zuzugreifen. Erfordert die READ ACCESS-Berechtigung für den Server und das Objekt.

Bemerkungen

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

Beispiel

Das folgende Beispiel verwendet sp_help_spatial_geography_index_xml , um den Räumlichkeitsindex SIndx_SpatialTable_geography_col2 zu analysieren, der in der Tabelle geography_col für das angegebene Abfragebeispiel in @qsdefiniert 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 geography  
        ='POLYGON((-90.0 -180, -90 180.0, 90 180.0, 90 -180, -90 -180.0))';  
declare @x xml;  
exec sp_help_spatial_geography_index_xml 'geography_col', 'SIndx_SpatialTable_geography_col2', 0, @qs, @x output;  
select @x.value('(/Primary_Filter_Efficiency/text())[1]', 'float');

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

Das umgebende Feld einer geography ist die gesamte Erde.

Requirements (Anforderungen)

Weitere Informationen

Gespeicherte Prozeduren für Räumlichkeitsindizes
sp_help_spatial_geography_index
Übersicht über räumliche Indizes
Räumliche Daten (SQL Server)
XQuery-Grundlagen
XQuery-Sprachreferenz