Teilen über


sp_help_spatial_geography_index_xml (Transact-SQL)

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 = ] N'tabname'
    , [ @indexname = ] N'indexname'
    , [ @verboseoutput = ] verboseoutput
    , [ @query_sample = ] query_sample
    , [ @xml_output = ] N'xml_output' OUTPUT
[ ; ]

Argumente und Eigenschaften

Siehe gespeicherte Spatial Index-Prozeduren – Argumente und Eigenschaften.

Berechtigungen

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

Hinweise

Eigenschaften, die Werte enthalten NULL , sind nicht im Rückgabesatz enthalten.

Beispiele

Im folgenden Beispiel wird sp_help_spatial_geography_index_xml der räumliche Index untersucht, SIndx_SpatialTable_geography_col2 in Tabelle geography_col für das angegebene Abfragebeispiel definiert @qsist. 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.