sp_db_selective_xml_index (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Note

SQL Server 2014 (12.x) から、選択的 XML インデックス機能を無効にすることはできません。 この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 SQL Server 2012 (11.x) では、このストアド プロシージャを使用して選択的 XML インデックス機能を無効にするには、ALTER DATABA Standard Edition Standard Edition T 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

次の例では、データベースで選択的 XML インデックスを AdventureWorks2022 有効にします。

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)