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
, , OFF
TRUE
или 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