ALTER FULLTEXT CATALOG (Transact-SQL)

Article
05/30/2023

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Modifie les propriétés d'un catalogue de texte intégral.

Syntaxe

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

Arguments

CATALOG_NAME
Spécifie le nom du catalogue à modifier. S’il n’existe pas de catalogue portant le nom spécifié, Microsoft SQL Server retourne une erreur et n’exécute pas l’opération ALTER.

REBUILD
Indique à SQL Server de reconstruire tout le catalogue. Dans ce cas, le catalogue existant est supprimé et un autre catalogue est créé à sa place. Toutes les tables qui comportent des références d'indexation de texte intégral sont associées au nouveau catalogue. La reconstruction redéfinit les métadonnées de texte intégral des tables système de la base de données.

WITH ACCENT_SENSITIVITY = {ON|OFF}
Indique si le catalogue à modifier respecte les accents ou non pour l'indexation et l'exécution de requêtes de texte intégral.

Pour déterminer si un catalogue de texte intégral respecte, ou non, les accents, utilisez la fonction FULLTEXTCATALOGPROPERTY avec la valeur de propriété accentsensitivity sur catalog_name. Si cette fonction retourne « 1 », le catalogue de texte intégral respecte les accents ; si elle retourne « 0 », il n'en tient pas compte.

Le catalogue et la base de données ont par défaut le même comportement quant au respect des accents.

REORGANIZE
Indique à SQL Server d’effectuer une fusion principale, qui consiste à fusionner les plus petits index créés lors de l’indexation afin de constituer un seul grand index. La fusion des fragments d’index de recherche en texte intégral peut améliorer les performances, et libérer des ressource de disque et des ressources mémoire. Si le catalogue de texte intégral fait l'objet de modifications fréquentes, utilisez cette commande régulièrement pour le réorganiser.

REORGANIZE optimise également les structures d'index et de catalogue internes.

N'oubliez pas que, selon la quantité de données indexées, une fusion principale peut prendre du temps. La fusion principale d'une grande quantité de données peut créer une transaction dont l'exécution est longue, ce qui retarde la troncation du journal des transactions pendant le point de contrôle. Dans ce cas, la taille du journal des transactions peut s'accroître considérablement en mode de récupération complète. Il est fortement recommandé de vous assurer que votre journal des transactions contient un espace suffisant pour une transaction dont l'exécution est longue avant de réorganiser un index de recherche en texte intégral de grande taille dans une base de données qui utilise le mode de récupération complète. Pour plus d’informations, consultez Gérer la taille du fichier journal des transactions.

AS DEFAULT
Spécifie que ce catalogue est le catalogue par défaut. Lorsque des index de recherche en texte intégral sont créés sans qu'aucun catalogue n'ait été spécifié, c'est le catalogue par défaut qui est utilisé. S'il existe un catalogue de texte intégral par défaut, l'utilisation de l'argument AS DEFAULT pour ce catalogue remplace le catalogue par défaut existant.

Autorisations

L’utilisateur doit disposer de l’autorisation ALTER sur le catalogue de texte intégral, ou bien être membre du rôle serveur fixe sysadmin ou membre des rôles de base de données fixes db_owner ou db_ddladmin.

Notes

Pour utiliser ALTER FULLTEXT CATALOG AS DEFAULT, l'utilisateur doit disposer de l'autorisation ALTER sur le catalogue de texte intégral et de l'autorisation CREATE FULLTEXT CATALOG sur la base de données.

Exemples

L'exemple suivant modifie la propriété accentsensitivity du catalogue de texte intégral par défaut ftCatalog, qui respecte les accents.

--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.

Voir aussi

sys.fulltext_catalogs (Transact-SQL)
CREATE FULLTEXT CATALOG (Transact-SQL)
DROP FULLTEXT CATALOG (Transact-SQL)
Recherche en texte intégral

Partage via