Partilhar via

sp_db_selective_xml_index (Transact-SQL)

Aplica-se a:SQL Server

Ativa e desativa a funcionalidade de índice seletivo XML (SXI) numa base de dados SQL Server. Se chamado sem quaisquer parâmetros, o procedimento armazenado retorna 1 se o SXI estiver ativado numa determinada base de dados.

Observação

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

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @dbname = ] N'dbname'

O nome da base de dados onde se pode ativar ou desativar o índice XML seletivo. @dbname é sysname, com um padrão de NULL.

Se @dbname for NULL, assume-se a base de dados atual.

[ @selective_xml_index = ] 'selective_xml_index'

Determina se deve ativar ou desativar o índice. @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 de código de retorno

1 se o SXI estiver ativado numa determinada base de dados, 0 se desativado.

Examples

A. Ativar funcionalidade seletiva de índice XML

O exemplo seguinte ativa o SXI na base de dados atual.

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

O exemplo seguinte permite o SXI na AdventureWorks2025 base de dados.

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

B. Desativar funcionalidade de índice seletivo XML

O exemplo seguinte desativa o SXI na base de dados atual.

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

O exemplo seguinte desativa o SXI na AdventureWorks2025 base de dados.

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

C. Detetar se o índice XML seletivo está ativado

O exemplo seguinte deteta se o SXI está ativado e devolve 1 se o SXI estiver ativado.

EXECUTE sys.sp_db_selective_xml_index;
GO

Conteúdo relacionado

  • Last updated on