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 DATABASE SET 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  

下列範例會在資料庫上 AdventureWorks2022 啟用選擇性 XML 索引。

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)