sp_db_selective_xml_index (Transact-SQL)

Artigo
03/13/2024

Aplica-se a:SQL Server

Habilita e desabilita a funcionalidade de Índice XML Seletivo em um banco de dados do SQL Server. Se for chamado sem qualquer parâmetro, o procedimento armazenado retornará 1 se o índice XML seletivo estiver habilitado em um banco de dados específico.

Observação

A partir do SQL Server 2014 (12.x), a funcionalidade de Índice XML Seletivo não poderá 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. No SQL Server 2012 (11.x), para desabilitar o recurso Índice XML Seletivo usando esse procedimento armazenado, o banco de dados deve ser colocado no modelo de recuperação SIMPLE usando o comando ALTER DATABASE SET Options (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

[ @ dbname = ] 'dbname' O nome do banco de dados no qual habilitar ou desabilitar o Índice XML Seletivo. Se dbname for NULL, o banco de dados atual será assumido. @dbname é sysname.

[ @selective_xml_index = ] 'selective_xml_index' Determina se o índice deve ser habilitado ou desabilitado. Valores permitidos: 'on', 'off', 'true', 'false'. Se outro valor, exceto 'on', 'true', 'off' ou 'false' for passado, um erro será gerado. @selective_xml_index é varchar(6).

Valores do código de retorno

1 se o Índice XML Seletivo estiver habilitado em um banco de dados específico, 0 se desabilitado.

Exemplos

R. Habilitar a funcionalidade seletiva de índice XML

O exemplo a seguir habilita o índice XML seletivo 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 AdventureWorks2022 Índice XML Seletivo no banco de dados.

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

B. Desabilitar a funcionalidade seletiva de índice XML

O exemplo a seguir desabilita o índice XML seletivo 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 AdventureWorks2022 Índice XML Seletivo 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 índice XML seletivo está habilitado. Retorna 1 se o índice XML seletivo está habilitado.

EXECUTE sys.sp_db_selective_xml_index;  
GO

Confira também

SXI (índices XML seletivos)

Share via