sp_db_selective_xml_index (Transact-SQL)

S’applique à :SQL Server

Active et désactive la fonctionnalité d’index XML sélectif sur une base de données SQL Server. Appelée sans paramètres, la procédure stockée retourne 1 si l'index XML sélectif est activé sur une base de données particulière.

Remarque

À compter de SQL Server 2014 (12.x), la fonctionnalité Index XML sélectif ne peut pas être désactivée. Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Dans SQL Server 2012 (11.x), afin de désactiver la fonctionnalité d’index XML sélectif à l’aide de cette procédure stockée, la base de données doit être placée dans le modèle de récupération SIMPLE à l’aide de la commande ALTER DATABASE SET Options (Transact-SQL).

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @ dbname = ] 'dbname' Nom de la base de données sur laquelle activer ou désactiver l’index XML sélectif activé. Si dbname a la valeur NULL, la base de données active est supposée. @dbname est sysname.

[ @selective_xml_index = ] 'selective_xml_index' Détermine s’il faut activer ou désactiver l’index. Valeurs autorisées : 'on', 'off', 'true', 'false'. Si une autre valeur, sauf « on », « true », « off » ou « false » est passée, une erreur est générée. @selective_xml_index est varchar(6).

Codet de retour

1 si l’index XML sélectif est activé sur une base de données particulière, 0 s’il est désactivé.

Exemples

R. Activer la fonctionnalité d'index XML sélectif

L'exemple suivant active l'index XML sélectif sur la base de données active.

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

L’exemple suivant active l’index XML sélectif sur la AdventureWorks2022 base de données.

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

B. Désactiver la fonctionnalité d'index XML sélectif

L'exemple suivant désactive l'index XML sélectif sur la base de données active.

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

L’exemple suivant désactive l’index XML sélectif sur la AdventureWorks2022 base de données.

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

C. Détecter si l'index XML sélectif est activé

L'exemple suivant détecte si l'index XML sélectif est activé. Retourne 1 si l'index XML sélectif est activé.

EXECUTE sys.sp_db_selective_xml_index;  
GO  

Voir aussi

Index XML sélectifs (SXI)