sp_db_selective_xml_index (Transact-SQL)

Aplica-se:SQL Server

Habilita e desabilita a funcionalidade SXI (índice XML seletivo) em um banco de dados SQL Server. Se chamado sem parâmetros, o procedimento armazenado retornará 1 se o SXI estiver habilitado em um banco de dados específico.

Observação

No SQL Server 2014 (12.x) e versões posteriores, a funcionalidade SXI não pode ser desabilitada. Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@dbname [ = ] N'dbname'

O nome do banco de dados no qual habilitar ou desabilitar o índice XML seletivo. @dbname é sysname, com um padrão de NULL.

Se @dbname for NULL, o banco de dados atual será assumido.

@selective_xml_index [ = ] 'selective_xml_index'

Determina se o índice deve ser habilitado ou desabilitado. @selective_xml_index é varchar(6), com um padrão de NULL, e pode ser um dos seguintes valores: ON, OFF, TRUE, ou FALSE. Qualquer outro valor gera um erro.

Valores do código de retorno

1 se o SXI estiver habilitado em um banco de dados específico, 0 se desabilitado.

Exemplos

R. Habilitar a funcionalidade de índice XML seletivo

O exemplo a seguir habilita o SXI no banco de dados atual.

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

O exemplo a seguir habilita o SXI no AdventureWorks2025 banco de dados.

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

B. Desabilitar a funcionalidade de índice XML seletivo

O exemplo a seguir desabilita o SXI no banco de dados atual.

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

O exemplo a seguir desabilita o AdventureWorks2025 SXI no banco de dados.

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

C. Detectar se o índice XML seletivo está habilitado

O exemplo a seguir detecta se o SXI está habilitado e retorna 1 se o SXI está habilitado.

EXECUTE sys.sp_db_selective_xml_index;
GO

Conteúdo relacionado

• SXI (índices XML seletivos)