ALTER FULLTEXT CATALOG (Transact-SQL)

Artigo
06/18/2013

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

Ícone de vínculo de tópico 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 Microsoft SQL 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 do sistema de arquivos 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 relação ao 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.

Observação
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 AdventureWorks;
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.