sp_db_selective_xml_index (Transact-SQL)

  • Article

S'applique à : SQL Server

Active et désactive la fonctionnalité d’index XML sélectif (SXI) sur une base de données SQL Server. Si elle est appelée sans paramètre, la procédure stockée retourne 1 si SXI est activé sur une base de données particulière.

Remarque

Dans SQL Server 2014 (12.x) et versions ultérieures, la fonctionnalité SXI 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é.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @dbname = ] N’dbname'

Nom de la base de données sur laquelle activer ou désactiver un index XML sélectif. @dbname est sysname, avec la valeur par défaut NULL.

Si @dbname est NULL, la base de données active est supposée.

[ @selective_xml_index = ] 'selective_xml_index'

Détermine s'il faut activer ou désactiver l'index. @selective_xml_index est varchar(6), avec une valeur par défaut NULL, et peut être l’une des valeurs suivantes : ON, , OFFTRUE, ou FALSE. Toute autre valeur génère une erreur.

Valeurs des codes de retour

1 si le SXI 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élective

L’exemple suivant active SXI sur la base de données active.

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

L’exemple suivant active SXI 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élective

L’exemple suivant désactive SXI 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 SXI 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 SXI est activé et retourne 1 si SXI est activé.

EXECUTE sys.sp_db_selective_xml_index;
GO

Contenu connexe