sp_db_selective_xml_index (Transact-SQL)

Gäller för:SQL Server

Aktiverar och inaktiverar selektiv XML-indexfunktionalitet (SXI) på en SQL Server-databas. Om den anropas utan några parametrar returnerar 1 den lagrade proceduren om SXI är aktiverat på en viss databas.

Anmärkning

I SQL Server 2014 (12.x) och senare versioner kan SXI-funktionaliteten inte inaktiveras. Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @dbname = ] N'dbname'

Namnet på databasen där man ska aktivera eller inaktivera selektivt XML-index. @dbname är sysname, med standardvärdet NULL.

Om @dbname är NULL, antas den aktuella databasen.

[ @selective_xml_index = ] 'selective_xml_index'

Avgör om indexet ska aktiveras eller inaktiveras. @selective_xml_index är varchar(6), med standardvärdet , NULLoch kan vara ett av följande värden: ON, OFF, , TRUEeller FALSE. Alla andra värden ger ett fel.

Returnera kodvärden

1 om SXI är aktiverat i en viss databas, 0 om det är inaktiverat.

Examples

A. Aktivera selektiv XML-indexfunktionalitet

Följande exempel aktiverar SXI i den aktuella databasen.

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

Följande exempel aktiverar SXI i databasen AdventureWorks2025 .

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

B. Inaktivera selektiv XML-indexfunktionalitet

Följande exempel inaktiverar SXI i den aktuella databasen.

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

Följande exempel inaktiverar SXI i databasen AdventureWorks2025 .

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

C. Upptäck om selektivt XML-index är aktiverat

Följande exempel upptäcker om SXI är aktiverat och returnerar 1 om SXI är aktiverat.

EXECUTE sys.sp_db_selective_xml_index;
GO