sp_db_selective_xml_index (Transact-SQL)
適用対象: 
SQL Server
SQL Server データベースで選択的 XML インデックス (SXI) 機能を有効または無効にします。 パラメーターを指定せずに呼び出された場合、ストアド プロシージャは、特定のデータベースで SXI が有効になっている場合に 1 を返します。
Note
SQL Server 2014 (12.x) 以降のバージョンでは、SXI 機能を無効にすることはできません。 この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。
構文
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
次の例では、 AdventureWorks2022 データベースで SXI を無効にします。
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