sp_db_selective_xml_index (Transact-SQL)

Se aplica a: SQL Server

Habilita y deshabilita la funcionalidad de índice XML selectivo (SXI) en una base de datos de SQL Server. Si se llama sin parámetros, el procedimiento almacenado devuelve 1 si SXI está habilitado en una base de datos determinada.

Nota:

En SQL Server 2014 (12.x) y versiones posteriores, la funcionalidad SXI no se puede deshabilitar. 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.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_db_selective_xml_index
    [ [ @dbname = ] N'dbname' ]
    [ , [ @selective_xml_index = ] 'selective_xml_index' ]
[ ; ]

Argumentos

[ @dbname = ] N'dbname'

Nombre de la base de datos en la que se va a habilitar o deshabilitar el índice XML selectivo. @dbname es sysname, con un valor predeterminado de NULL.

Si @dbname es NULL, se asume la base de datos actual.

[ @selective_xml_index = ] 'selective_xml_index'

Determina si se va a habilitar o deshabilitar el índice. @selective_xml_index es varchar(6), con un valor predeterminado de NULLy puede ser uno de los siguientes valores: ON, OFF, TRUEo FALSE. Cualquier otro valor genera un error.

Valores de código de retorno

1 si el SXI está habilitado en una base de datos determinada, 0 si está deshabilitado.

Ejemplos

A Habilitación de la funcionalidad de índice XML selectivo

En el ejemplo siguiente se habilita SXI en la base de datos actual.

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

En el ejemplo siguiente se habilita SXI en la AdventureWorks2022 base de datos.

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

B. Deshabilitación de la funcionalidad de índice XML selectivo

En el ejemplo siguiente se deshabilita SXI 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 SXI en la AdventureWorks2022 base de datos.

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

C. Detección de si el índice XML selectivo está habilitado

En el ejemplo siguiente se detecta si SXI está habilitado y devuelve 1 si SXI está habilitado.

EXECUTE sys.sp_db_selective_xml_index;
GO

Contenido relacionado

• Índices XML selectivos (SXI)