sp_db_selective_xml_index (Transact-SQL)

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

注意注意

为了使用此存储过程禁用选择性 XML 索引,通过使用 ALTER DATABASE SET 选项 (Transact-SQL) 命令使该数据库必须处于简单恢复模式。

主题链接图标 Transact-SQL 语法约定

语法

sys.sp_db_selective_xml_index
[[ @db_name = ] 'db_name'], 
[[ @selective_xml_index = ] 'action']

参数

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

  • [ @ selective_xml_index = ] 'action'
    确定是启用还是禁用该索引。 如果传递了“on”、“true”、“off”或“false”之外的其他值,则会引发错误。

    允许的值:“on”、“off”、“true”、“false”

返回代码值

如果在特定数据库上启用选择性 XML 索引,则返回 1

示例

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

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

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

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

EXECUTE sys.sp_db_selective_xml_index
    @db_name = N'AdventureWorks2012'
  , @selective_xml_index = N'true';
GO

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

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

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

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

EXECUTE sys.sp_db_selective_xml_index
    @db_name = N'AdventureWorks2012'
  , @selective_xml_index = N'false';
GO

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

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

EXECUTE sys.sp_db_selective_xml_index;
GO

请参阅

概念

选择性 XML 索引 (SXI)