sp_db_selective_xml_index (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Habilita y deshabilita la funcionalidad Índice XML selectivo en una base de datos de SQL Server. Si se llama sin ningún parámetro, el procedimiento almacenado devuelve 1 si el índice XML selectivo está habilitado en una base de datos determinada.

Nota:

A partir SQL Server 2014 (12.x), no se puede deshabilitar la función Índice XML selectivo. Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En SQL Server 2012 (11.x), para deshabilitar la característica Índice XML selectivo mediante este procedimiento almacenado, la base de datos debe colocarse en el modelo de recuperación SIMPLE mediante el comando ALTER DATABASE SET Options (Transact-SQL).

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
      sys.sp_db_selective_xml_index[[ @dbname = ] 'dbname'],   
[[ @selective_xml_index = ] 'selective_xml_index']

Argumentos

[ @ dbname = ] 'dbname' Nombre de la base de datos en la que se va a habilitar o deshabilitar el índice XML selectivo. Si dbname es NULL, se asume la base de datos actual. @dbname es sysname.

[ @selective_xml_index = ] 'selective_xml_index' Determina si se va a habilitar o deshabilitar el índice. Valores permitidos: 'on', 'off', 'true', 'false'. Si se pasa otro valor excepto "on", "true", "off" o "false", se generará un error. @selective_xml_index es varchar(6).

Valores de código de retorno

1 si el índice XML selectivo está habilitado en una base de datos determinada, 0 si está deshabilitado.

Ejemplos

A Habilitar la funcionalidad de índice XML selectivo

En el ejemplo siguiente se habilita el índice XML selectivo en la base de datos actual.

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

En el ejemplo siguiente se habilita el índice XML selectivo en la AdventureWorks2022 base de datos.

EXECUTE sys.sp_db_selective_xml_index  
    @dbname = N'AdventureWorks2022'  
  , @selective_xml_index = N'true';  
GO

B. Deshabilitar la funcionalidad de índice XML selectivo

En el ejemplo siguiente se deshabilita el índice XML selectivo en la base de datos actual.

EXECUTE sys.sp_db_selective_xml_index  
    @dbname = NULL  
  , @selective_xml_index = N'off';  
GO

En el ejemplo siguiente se deshabilita el índice XML selectivo en la AdventureWorks2022 base de datos.

EXECUTE sys.sp_db_selective_xml_index  
    @dbname = N'AdventureWorks2022'  
  , @selective_xml_index = N'false';  
GO

C. Detectar si el índice XML selectivo está habilitado

En el ejemplo siguiente se detecta si el índice XML selectivo está habilitado. Devuelve 1 si el índice XML selectivo está habilitado.

EXECUTE sys.sp_db_selective_xml_index;  
GO

Consulte también

Índices XML selectivos (SXI)