ALTER FULLTEXT CATALOG (Transact-SQL)

 

Altera as propriedades de um catálogo de texto completo.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de Dados SQL V12.

Convenções de sintaxe Transact-SQL

Sintaxe

ALTER FULLTEXT CATALOG catalog_name 
{ REBUILD [ WITH ACCENT_SENSITIVITY = { ON | OFF } ]
| REORGANIZE
| AS DEFAULT 
}

Argumentos

• catalog_name
  Especifica o nome do catálogo a ser modificado.Se não existir um catálogo com o nome especificado, o MicrosoftSQL Server retornará um erro e não executará a operação ALTER.

• REBUILD
  Instrui o SQL Server a reconstruir o catálogo inteiro.Quando um catálogo é recriado, o catálogo existente é excluído e um novo catálogo é criado em seu lugar.Todas as tabelas que têm referências de indexação de texto completo são associadas ao novo catálogo.A recriação redefine os metadados de texto completo nas tabelas do sistema de banco de dados. 

• WITH ACCENT_SENSITIVITY = {ON|OFF}
  Especifica se o catálogo a ser alterado diferencia acentuação ou não para indexação e consulta de texto completo.

  Para determinar a configuração atual da propriedade de diferenciação de acentuação de um catálogo de texto completo, use a função FULLTEXTCATALOGPROPERTY com o valor da propriedade accentsensitivity em catalog_name.Se a função retornar '1', o catálogo de texto completo diferencia acentuação; se a função retornar '0', o catálogo não diferencia acentuação.

  O padrão de diferenciação de acentuação do catálogo e do banco de dados é o mesmo.

• REORGANIZE
  Informa o SQL Server para executar uma mesclagem mestra, que envolve a mesclagem dos índices menores criados no processo de indexação em um índice grande.A mesclagem dos fragmentos de índice de texto completo pode melhorar o desempenho e liberar recursos de disco e de memória.Se houver alterações frequentes no catálogo de texto completo, use este comando periodicamente para reorganizar o catálogo de texto completo.

  REORGANIZE também otimiza o índice interno e as estruturas do catálogo.

  Lembre-se de que, dependendo da quantidade de dados indexados, uma mesclagem mestra pode demorar algum tempo para ser concluída.A mesclagem mestra de grande quantidade de dados pode criar uma transação demorada, atrasando o truncamento do log de transações durante o ponto de verificação.Nesse caso, o log de transações pode crescer significativamente sob o modelo de recuperação completa.Como prática recomendada, verifique se o log de transações contém espaço suficiente para uma transação demorada antes de reorganizar um índice de texto completo grande em um banco de dados que usa o modelo de recuperação completa.Para obter mais informações, consulte Gerenciar o tamanho do arquivo de log de transações.

• AS DEFAULT
  Especifica que este catálogo é o padrão.Quando forem criados índices de texto completo sem nenhum catálogo especificado, o catálogo padrão será usado.Se houver um catálogo de texto completo padrão, a configuração de AS DEFAULT para este catálogo substituirá o padrão existente.

Permissões

O usuário deve ter permissão ALTER no catálogo de texto completo ou ser um membro das funções de banco de dados fixas db_owner e db_ddladmin ou da função de servidor fixa sysadmin.

Dica

Para usar ALTER FULLTEXT CATALOG AS DEFAULT, o usuário deve ter permissão ALTER no catálogo de texto completo e permissão CREATE FULLTEXT CATALOG no banco de dados.

Exemplos

O exemplo a seguir altera a propriedade accentsensitivity do catálogo de texto completo padrão ftCatalog que diferencia acentos.

--Change to accent insensitive
USE AdventureWorks2012;
GO
ALTER FULLTEXT CATALOG ftCatalog 
REBUILD WITH ACCENT_SENSITIVITY=OFF;
GO
-- Check Accentsensitivity
SELECT FULLTEXTCATALOGPROPERTY('ftCatalog', 'accentsensitivity');
GO
--Returned 0, which means the catalog is not accent sensitive.

Consulte também

sys.fulltext_catalogs (Transact-SQL)
CREATE FULLTEXT CATALOG (Transact-SQL)
DROP FULLTEXT CATALOG (Transact-SQL)
Pesquisa de Texto Completo