sp_db_selective_xml_index (Transact-SQL)

Artikel
08/11/2023

Aktiviert und deaktiviert selektive XML-Indexfunktionen in einer SQL Server-Datenbank. Wenn diese ohne Parameter aufgerufen wird, gibt die gespeicherte Prozedur 1 zurück, wenn der selektive XML-Index in einer bestimmten Datenbank aktiviert ist.

Hinweis

Ab SQL Server 2014 (12.x) kann der selektive XML-Index 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. In SQL Server 2012 (11.x) muss die Datenbank mithilfe des Befehls ALTER DATABASE SET Options (Transact-SQL) im SIMPLE-Wiederherstellungsmodell platziert werden, um das Feature "Selektiver XML-Index" mithilfe des Befehls "Transact-SQL" zu deaktivieren.

Transact-SQL-Syntaxkonventionen

Syntax

  
      sys.sp_db_selective_xml_index[[ @dbname = ] 'dbname'],   
[[ @selective_xml_index = ] 'selective_xml_index']

Argumente

[ @ dbname = ] 'dbname' Der Name der Datenbank, für die selektiver XML-Index aktiviert oder deaktiviert werden soll. Wenn dbname NULL ist, wird die aktuelle Datenbank angenommen. @dbname ist "sysname".

[ @selective_xml_index = ] 'selective_xml_index' Bestimmt, ob der Index aktiviert oder deaktiviert werden soll. Zulässige Werte: "on", "off", "true", "false". Wenn ein anderer Wert außer "on", "true", "off" oder "false" übergeben wird, wird ein Fehler ausgelöst. @selective_xml_index ist varchar(6).

Rückgabecodewerte

1 , wenn der selektive XML-Index für eine bestimmte Datenbank aktiviert ist, 0 , wenn sie deaktiviert ist.

Beispiele

A. Aktivieren der Funktion für den selektiven XML-Index

Im folgenden Beispiel wird der selektive XML-Index in der aktuellen Datenbank aktiviert.

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

Im folgenden Beispiel wird der selektive XML-Index für die AdventureWorks2022 Datenbank aktiviert.

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

B. Deaktivieren der Funktion für den selektiven XML-Index

Im folgenden Beispiel wird der selektive XML-Index in der aktuellen Datenbank deaktiviert.

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

Im folgenden Beispiel wird der selektive XML-Index in der AdventureWorks2022 Datenbank deaktiviert.

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

C. Ermitteln, ob der selektive XML-Index aktiviert ist

Im folgenden Beispiel wird ermittelt, ob der selektive XML-Index aktiviert ist. Gibt 1 zurück, wenn der selektive XML-Index aktiviert ist.

EXECUTE sys.sp_db_selective_xml_index;  
GO

Weitere Informationen

Selektive XML-Indizes (SXI)

Share via