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 @qs
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 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.