ALTER FULLTEXT CATALOG (Transact-SQL)

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

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

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 avec le nom spécifié, MicrosoftSQL 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 de l'espace disque ainsi que de la 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 Gestion de la taille du fichier journal des transactions.

  • AS DEFAULT
    Spécifie que ce catalogue est le catalogue par défaut. Lorsque des index de 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 être membre du rôle de serveur fixe sysadmin ou membre du rôle de base de données fixe db_owner ou db_ddladmin.

[!REMARQUE]

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

Historique des modifications

Mise à jour du contenu

Correction et développement de la description de l'option REORGANIZE.

Révision de la description de l'option REBUILD.