sp_db_selective_xml_index (Transact-SQL)

  • 项目

适用于：SQL Server

在 SQL Server 数据库上启用和禁用选择性 XML 索引功能。 如果不带任何参数调用，则当在特定数据库上启用选择性 XML 索引时，存储过程返回 1。

注意

从 SQL Server 2014 (12.x) 开始，无法禁用选择性 XML 索引功能。 在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 在 SQL Server 2012（11.x）中，若要使用此存储过程禁用选择性 XML 索引功能，必须使用 ALTER DATABA标准版 标准版T Options（Transact-SQL）命令将数据库置于 SIMPLE 恢复模型中。

Transact-SQL 语法约定

语法

  
      sys.sp_db_selective_xml_index[[ @dbname = ] 'dbname'],   
[[ @selective_xml_index = ] 'selective_xml_index']

参数

[ @ dbname = ] 'dbname' 要启用或禁用选择性 XML 索引的数据库的名称。 如果 dbname 为 NULL，则假定当前数据库。 @dbname 为 sysname。

[ @selective_xml_index = ] 'selective_xml_index' 确定是否启用或禁用索引。 允许的值：“on”、“off”、“true”、“false”。 如果传递了除“on”、“true”、“off”或“false”以外的其他值，将引发错误。 @selective_xml_index是 varchar（6）。

返回代码值

如果对特定数据库启用了选择性 XML 索引，则为 1 ; 如果禁用，则为 0 。

示例

A. 启用选择性 XML 索引功能

下面的示例在当前数据库上启用选择性 XML 索引。

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

以下示例对数据库启用选择性 XML 索引 AdventureWorks2022 。

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

B. 禁用选择性 XML 索引功能

下面的示例在当前数据库上禁用选择性 XML 索引。

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

以下示例对数据库禁用选择性 XML 索引 AdventureWorks2022 。

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

°C 检测是否启用了选择性 XML 索引

下面的示例检测是否启用了选择性 XML 索引。 如果启用选择性 XML 索引，则返回 1。

EXECUTE sys.sp_db_selective_xml_index;  
GO

另请参阅

选择性 XML 索引 (SXI)