Freigeben über

sp_db_selective_xml_index (Transact-SQL)

  • Artikel

Gilt für: SQL Server

Aktiviert und deaktiviert selektive XML-Indexfunktionen (SXI) in einer SQL Server-Datenbank. Wenn die gespeicherte Prozedur ohne Parameter aufgerufen wird, wird zurückgegeben 1 , ob SXI in einer bestimmten Datenbank aktiviert ist.

Hinweis

In SQL Server 2014 (12.x) und höheren Versionen kann die SXI-Funktionalität nicht deaktiviert werden. Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden.

Transact-SQL-Syntaxkonventionen

Syntax

sp_db_selective_xml_index
    [ [ @dbname = ] N'dbname' ]
    [ , [ @selective_xml_index = ] 'selective_xml_index' ]
[ ; ]

Argumente

[ @dbname = ] N'dbname'

Der Name der Datenbank, für die selektiver XML-Index aktiviert oder deaktiviert werden soll. @dbname ist "sysname" mit der Standardeinstellung "NULL.

Wenn @dbname ist NULL, wird die aktuelle Datenbank angenommen.

[ @selective_xml_index = ] 'selective_xml_index'

Bestimmt, ob der Index aktivieren oder deaktiviert wird. @selective_xml_index ist varchar(6) mit einem Standardwert von NULL, und kann einer der folgenden Werte sein: ON, , , OFF, TRUEoder FALSE. Jeder andere Wert löst einen Fehler aus.

Rückgabecodewerte

1 wenn die SXI in einer bestimmten Datenbank aktiviert ist, 0 wenn sie deaktiviert ist.

Beispiele

A. Aktivieren der selektiven XML-Indexfunktionalität

Im folgenden Beispiel wird SXI in der aktuellen Datenbank aktiviert.

EXEC sys.sp_db_selective_xml_index
    @dbname = NULL
  , @selective_xml_index = N'on';
GO

Im folgenden Beispiel wird SXI in der AdventureWorks2022 Datenbank aktiviert.

EXECUTE sys.sp_db_selective_xml_index
    @dbname = N'AdventureWorks2022'
  , @selective_xml_index = N'true';
GO

B. Deaktivieren der selektiven XML-Indexfunktionalität

Im folgenden Beispiel wird SXI in der aktuellen Datenbank deaktiviert.

EXECUTE sys.sp_db_selective_xml_index
    @dbname = NULL
  , @selective_xml_index = N'off';
GO

Im folgenden Beispiel wird SXI in der AdventureWorks2022 Datenbank deaktiviert.

EXECUTE sys.sp_db_selective_xml_index
    @dbname = N'AdventureWorks2022'
  , @selective_xml_index = N'false';
GO

C. Erkennen, ob selektiver XML-Index aktiviert ist

Im folgenden Beispiel wird erkannt, ob SXI aktiviert ist, und gibt zurück 1 , ob SXI aktiviert ist.

EXECUTE sys.sp_db_selective_xml_index;
GO

Zugehöriger Inhalt