ALTER FULLTEXT CATALOG (Transact-SQL)

Artigo
10/16/2024

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

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

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 um catálogo com o nome especificado não existir, 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 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 distinção de acentos 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
Diz para o SQL Server 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 memória e disco. 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, veja 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, 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 AdventureWorks2022;  
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

Compartilhar via