Поделиться через


sp_db_selective_xml_index (Transact-SQL)

Область применения: SQL Server

Включает и отключает функции выборочного XML-индекса (SXI) в базе данных SQL Server. При вызове без каких-либо параметров хранимая процедура возвращается 1 , если SXI включен в определенной базе данных.

Примечание.

В SQL Server 2014 (12.x) и более поздних версиях функции SXI нельзя отключить. Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @dbname = ] N'dbname'

Имя базы данных, в которой необходимо включить или отключить выборочный XML-индекс. @dbname — sysname с значением по умолчаниюNULL.

Если @dbname , NULLпредполагается текущая база данных.

[ @selective_xml_index = ] 'selective_xml_index'

Определяет, следует включить или отключить индекс. @selective_xml_index — varchar(6), по умолчанию NULLи может быть одним из следующих значений: ON, , OFFTRUEили FALSE. Любое другое значение вызывает ошибку.

Значения кода возврата

1 Значение , если SXI включен в определенной базе данных, 0 при отключении.

Примеры

А. Включение функций выборочного XML-индекса

Следующий пример включает SXI в текущей базе данных.

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

Следующий пример включает SXI в AdventureWorks2022 базе данных.

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

B. Отключение функций выборочного XML-индекса

В следующем примере отключается SXI в текущей базе данных.

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

Следующий пример отключает SXI в AdventureWorks2022 базе данных.

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

C. Определить, включен ли выборочный XML-индекс

В следующем примере определяется, включена ли SXI, и возвращается 1 , включен ли SXI.

EXECUTE sys.sp_db_selective_xml_index;
GO