Share via


sp_help_spatial_geometry_index_xml (Transact-SQL)

Gilt für:SQL Server

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 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_geometry_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

Der Benutzer muss ein Mitglied der Datenbankrolle public sein. Erfordert READ ACCESS Berechtigungen auf dem Server und dem Objekt.

Hinweise

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

Beispiele

Im folgenden Beispiel wird sp_help_spatial_geometry_index_xml der räumliche Index SIndx_SpatialTable_geometry_col2 untersucht, der in der Tabelle geometry_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 ein XQuery Basics auf dem Resultset ausgeführt und gibt eine bestimmte Eigenschaft zurück.

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_indexermöglicht diese gespeicherte Prozedur einen vereinfachten programmgesteuerten Zugriff auf die Eigenschaften eines Räumlichkeitsindex und dokumentiert das Resultset in XML.