共用方式為

sp_db_selective_xml_index （Transact-SQL）

  • 發行項

適用於：SQL Server

啟用和停用 SQL Server 資料庫上的選擇性 XML 索引 （SXI） 功能。 如果沒有任何參數呼叫，則預存程式會在特定資料庫上啟用 SXI 時傳回 1 。

注意

在 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 則為 ，如果停用則為 。

範例

A. 啟用選擇性 XML 索引功能

下列範例會在目前的資料庫上啟用SXI。

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

下列範例會在資料庫上 AdventureWorks2022 啟用SXI。

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，並在啟用 SXI 時傳回 1 。

EXECUTE sys.sp_db_selective_xml_index;
GO

相關內容