Udostępnij za pomocą


sp_db_selective_xml_index (Transact-SQL)

Dotyczy:SQL Server

Włącza i wyłącza funkcjonalność selective XML index (SXI) w bazie danych SQL Server. Jeśli wywołana jest bez żadnych parametrów, procedura przechowywana zwraca informację 1 , jeśli SXI jest włączone w danej bazie danych.

Uwaga / Notatka

W SQL Server 2014 (12.x) i późniejszych wersjach funkcjonalność SXI nie może zostać wyłączona. Ta funkcja zostanie usunięta w przyszłej wersji programu SQL Server. Unikaj używania tej funkcji w nowych pracach programistycznych i zaplanuj modyfikowanie aplikacji, które obecnie korzystają z tej funkcji.

Transact-SQL konwencje składni

Składnia

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

Arguments

[ @dbname = ] N'dbname'

Nazwa bazy danych, na której należy włączyć lub wyłączyć selektywny indeks XML. @dbname jest nazwa systemu, z wartością domyślną NULL.

Jeśli @dbname jest , NULLzakłada się aktualną bazę danych.

[ @selective_xml_index = ] 'selective_xml_index'

Decyduje, czy włączyć czy wyłączyć indeks. @selective_xml_index to varchar(6), z domyślnym , NULLi może być jedną z następujących wartości: ON, OFF, TRUE, lub FALSE. Każda inna wartość powoduje błąd.

Zwracanie wartości kodu

1 jeśli SXI jest włączone w konkretnej bazie danych, 0 jeśli jest wyłączone.

Przykłady

A. Włącz selektywną funkcjonalność indeksu XML

Poniższy przykład umożliwia SXI na aktualnej bazie danych.

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

Poniższy przykład umożliwia SXI w bazie AdventureWorks2025 danych.

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

B. Wyłącz selektywną funkcjonalność indeksu XML

Poniższy przykład wyłącza SXI w aktualnej bazie danych.

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

Poniższy przykład wyłącza SXI w bazie AdventureWorks2025 danych.

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

C. Sprawdź, czy selektywny indeks XML jest włączony

Poniższy przykład wykrywa, czy SXI jest włączone, i zwraca informacje 1 , jeśli SXI jest włączone.

EXECUTE sys.sp_db_selective_xml_index;
GO