sp_db_selective_xml_index (Transact-SQL)

適用対象: SQL サーバー

SQL Server データベースで選択的 XML インデックス (SXI) 機能を有効または無効にします。 パラメーターを指定せずに呼び出された場合、ストアド プロシージャは、特定のデータベースで SXI が有効になっている場合に 1 を返します。

Note

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

次の例では、 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

関連するコンテンツ

• 選択的 XML インデックス (SXI)