sp_fulltext_catalog (Transact-SQL)sp_fulltext_catalog (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Permet de créer ou de supprimer un catalogue de texte intégral, et de démarrer ou d'arrêter l'indexation d'un catalogue.Creates and drops a full-text catalog, and starts and stops the indexing action for a catalog. Plusieurs catalogues de texte intégral peuvent être créés pour chaque base de données.Multiple full-text catalogs can be created for each database.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server.This feature will be removed in a future version of Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.Utilisez CREATE FULLTEXT CATALOG, ALTER FULLTEXT CATALOG, et DROP FULLTEXT CATALOG à la place. Use CREATE FULLTEXT CATALOG, ALTER FULLTEXT CATALOG, and DROP FULLTEXT CATALOG instead.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


sp_fulltext_catalog [ @ftcat= ] 'fulltext_catalog_name' ,   
     [ @action= ] 'action'   
     [ , [ @path= ] 'root_directory' ]   

ArgumentsArguments

[ @ftcat=] 'fulltext_catalog_name'[ @ftcat=] 'fulltext_catalog_name'
Nom du catalogue de texte intégral.Is the name of the full-text catalog. Les noms de catalogues doivent être uniques dans chaque base de données.Catalog names must be unique for each database. fulltext_catalog_name est sysname.fulltext_catalog_name is sysname.

[ @action=] 'action'[ @action=] 'action'
Action à exécuter.Is the action to be performed. action est varchar (20), et peut prendre l’une des valeurs suivantes.action is varchar(20), and can be one of these values.

Note

En fonction de vos besoins, vous pouvez créer, supprimer et modifier des catalogues de texte intégral.Full-text catalogs can be created, dropped, and modified as needed. Toutefois, il vaut mieux éviter de procéder à des modifications de schéma sur plusieurs catalogues à la fois.However, avoid making schema changes on multiple catalogs at the same time. Ces actions peuvent être effectuées à l’aide de la sp_fulltext_table procédure stockée, qui est la méthode recommandée.These actions can be performed using the sp_fulltext_table stored procedure, which is the recommended way.

ValeurValue DescriptionDescription
CréerCreate Crée un catalogue de texte intégral vide dans le système de fichiers et ajoute une ligne correspondante dans sysfulltextcatalogs avec la fulltext_catalog_name et root_directory, le cas échéant, les valeurs.Creates an empty, new full-text catalog in the file system and adds an associated row in sysfulltextcatalogs with the fulltext_catalog_name and root_directory, if present, values. fulltext_catalog_name doit être unique dans la base de données.fulltext_catalog_name must be unique within the database.
SupprimerDrop Supprime fulltext_catalog_name en le supprimant du système de fichiers, en supprimant la ligne correspondante dans sysfulltextcatalogs.Drops fulltext_catalog_name by removing it from the file system and deleting the associated row in sysfulltextcatalogs. Cette action échoue si le catalogue contient des index pour une ou plusieurs tables.This action fails if this catalog contains indexes for one or more tables. sp_fulltext_table 'table_name', 'drop' doit être exécutée pour supprimer les tables du catalogue.sp_fulltext_table 'table_name', 'drop' should be executed to drop the tables from the catalog.

Une erreur est affichée si le catalogue n'existe pas.An error is displayed if the catalog does not exist.
start_incrementalstart_incremental Démarre un remplissage incrémentiel fulltext_catalog_name.Starts an incremental population for fulltext_catalog_name. Une erreur est affichée si le catalogue n'existe pas.An error is displayed if the catalog does not exist. Si une alimentation d'index de recherche en texte intégral est déjà active, un avertissement est affiché, mais aucune opération d'alimentation ne se produit.If a full-text index population is already active, a warning is displayed but no population action occurs. Avec un remplissage incrémentiel uniquement les lignes modifiées sont récupérées pour l’indexation de texte intégral, si tant est un timestamp les colonnes présentes dans la table en cours de recherche en texte intégral indexées.With incremental population only changed rows are retrieved for full-text indexing, provided there is a timestamp column present in the table being full-text indexed.
start_fullstart_full Démarre un remplissage complet pour fulltext_catalog_name.Starts a full population for fulltext_catalog_name. Même si elle a déjà été indexée, chaque ligne de chaque table associée à ce catalogue de texte intégral est récupérée lors de l'indexation en texte intégral.Every row of every table associated with this full-text catalog is retrieved for full-text indexing even if they have already been indexed.
ArrêterStop Arrête un remplissage d’index pour fulltext_catalog_name.Stops an index population for fulltext_catalog_name. Une erreur est affichée si le catalogue n'existe pas.An error is displayed if the catalog does not exist. Aucun avertissement n'est affiché si l'alimentation était déjà arrêtée.No warning is displayed if population is already stopped.
ReconstruireRebuild Reconstruit fulltext_catalog_name.Rebuilds fulltext_catalog_name. Dans ce cas, le catalogue existant est supprimé et un autre catalogue est créé à sa place.When a catalog is rebuilt, the existing catalog is deleted and a new catalog is created in its place. Toutes les tables qui comportent des références d'indexation de texte intégral sont associées au nouveau catalogue.All the tables that have full-text indexing references are associated with the new catalog. La reconstruction redéfinit les métadonnées de texte intégral des tables système de la base de données.Rebuilding resets the full-text metadata in the database system tables.

Si le suivi des modifications est désactivé (OFF), la reconstruction ne déclenche pas de réalimentation du catalogue de texte intégral récemment créé.If change tracking is OFF, rebuilding does not cause a repopulation of the newly created full-text catalog. Dans ce cas, pour réalimenter, exécutez sp_fulltext_catalog avec la start_full ou start_incremental action.In this case, to repopulate, execute sp_fulltext_catalog with the start_full or start_incremental action.

[ @path=] 'root_directory'[ @path=] 'root_directory'
Est le répertoire racine (pas le chemin physique complet) pour un créer action.Is the root directory (not the complete physical path) for a create action. root_directory est nvarchar (100) et a la valeur par défaut NULL, ce qui indique l’utilisation de l’emplacement par défaut spécifié lors de l’installation.root_directory is nvarchar(100) and has a default value of NULL, which indicates the use of the default location specified at setup. Il s’agit du sous-répertoire Ftdata situé dans le répertoire Mssql ; par exemple, C:\Program Files\Microsoft SQL Server\MSSQL13. MSSQLSERVER\MSSQL\FTData.This is the Ftdata subdirectory in the Mssql directory; for example, C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\FTData. Le répertoire racine spécifié doit se trouver sur un lecteur du même ordinateur, ne pas être désigné seulement par une lettre de lecteur et ne pas être un chemin d'accès relatif.The specified root directory must reside on a drive on the same computer, consist of more than just the drive letter, and cannot be a relative path. Les disques réseau et amovibles, les disquettes et chemins UNC ne sont pas pris en charge.Network drives, removable drives, floppy disks, and UNC paths are not supported. Les catalogues de texte intégral doivent être créés sur un lecteur de disque local associé à une instance de SQL ServerSQL Server.Full-text catalogs must be created on a local hard drive associated with an instance of SQL ServerSQL Server.

@pathest valide uniquement lorsque action est créer.@path is valid only when action is create. Pour les actions autres que créer (arrêter, reconstruire, et ainsi de suite), @path doit être NULL ou omis.For actions other than create (stop, rebuild, and so on), @path must be NULL or omitted.

Si l'instance de SQL ServerSQL Server est un serveur virtuel de cluster, le répertoire de catalogue spécifié doit être installé sur un lecteur de disque partagé dont la ressource SQL ServerSQL Server dépend.If the instance of SQL ServerSQL Server is a virtual server in a cluster, the catalog directory specified needs to be on a shared disk drive on which the SQL ServerSQL Server resource depends. Si @path n’est pas spécifié, l’emplacement du répertoire de catalogue par défaut est sur le lecteur de disque partagé dans le répertoire qui a été spécifié lors de l’installation du serveur virtuel.If @path is not specified, the location of default catalog directory is on the shared disk drive, in the directory that was specified when the virtual server was installed.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

AucuneNone

NotesRemarks

Le start_full action est utilisée pour créer un instantané complet des données de recherche en texte intégral dans fulltext_catalog_name.The start_full action is used to create a complete snapshot of the full-text data in fulltext_catalog_name. Le start_incremental action permet de réindexer uniquement les lignes modifiées dans la base de données.The start_incremental action is used to re-index only the changed rows in the database. Alimentation incrémentielle peut être appliquée uniquement si la table possède une colonne de type timestamp.Incremental population can be applied only if the table has a column of the type timestamp. Si une table dans le catalogue de texte intégral ne contient pas une colonne de type timestamp, la table subit un remplissage complet.If a table in the full-text catalog does not contain a column of the type timestamp, the table undergoes a full population.

Les données d'index et de catalogue de texte intégral sont enregistrées dans des fichiers créés dans un répertoire du catalogue de texte intégral.Full-text catalog and index data is stored in files created in a full-text catalog directory. Le répertoire de catalogue de texte intégral est créé en tant que sous-répertoire du répertoire spécifié dans @path ou dans le répertoire du catalogue de texte intégral par défaut serveur si @path n’est pas spécifié.The full-text catalog directory is created as a sub-directory of the directory specified in @path or in the server default full-text catalog directory if @path is not specified. Le nom du répertoire du catalogue de texte intégral est créé de telle façon qu'il est unique sur le serveur.The name of the full-text catalog directory is built in a way that guarantees it will be unique on the server. Par conséquent, tous les répertoires de catalogue de texte intégral peuvent partager le même chemin.Therefore, all full-text catalog directories on a server can share the same path.

PermissionsPermissions

L’appelant doit être membre de la db_owner rôle.The caller is required to be member of the db_owner role. Selon l’action demandée, l’appelant doit disposer des autorisations ALTER ou CONTROL (qui db_owner a) sur le catalogue de texte intégral cible.Depending on the action requested, the caller should not be denied ALTER or CONTROL permissions (which db_owner has) on the target full-text catalog.

ExemplesExamples

A.A. Création d'un catalogue de texte intégralCreate a full-text catalog

Cet exemple crée un catalogue de texte intégral vide, Cat_Desc, dans le AdventureWorks2012 base de données.This example creates an empty full-text catalog, Cat_Desc, in the AdventureWorks2012 database.

USE AdventureWorks2012;  
GO  
EXEC sp_fulltext_catalog 'Cat_Desc', 'create';  
GO  

B.B. Pour reconstruire un catalogue de texte intégralTo rebuild a full-text catalog

Cet exemple reconstruit un catalogue de texte intégral existant, Cat_Desc, dans le AdventureWorks2012 base de données.This example rebuilds an existing full-text catalog, Cat_Desc, in the AdventureWorks2012 database.

USE AdventureWorks2012;  
GO  
EXEC sp_fulltext_catalog 'Cat_Desc', 'rebuild';  
GO  

C.C. Démarrage de l'alimentation d'un catalogue de texte intégralStart the population of a full-text catalog

Cet exemple démarre un remplissage complet de le Cat_Desc catalogue.This example begins a full population of the Cat_Desc catalog.

USE AdventureWorks2012;  
GO  
EXEC sp_fulltext_catalog 'Cat_Desc', 'start_full';  
GO  

D.D. Arrêt de l'alimentation d'un catalogue de texte intégralStop the population of a full-text catalog

Cet exemple arrête le remplissage de la Cat_Desc catalogue.This example stops the population of the Cat_Desc catalog.

USE AdventureWorks2012;  
GO  
EXEC sp_fulltext_catalog 'Cat_Desc', 'stop';  
GO  

E.E. Suppression d'un catalogue de texte intégralTo remove a full-text catalog

L’exemple suivant supprime le Cat_Desc catalogue.This example removes the Cat_Desc catalog.

USE AdventureWorks2012;  
GO  
EXEC sp_fulltext_catalog 'Cat_Desc', 'drop';  
GO  

Voir aussiSee Also

FULLTEXTCATALOGPROPERTY ( Transact-SQL ) FULLTEXTCATALOGPROPERTY (Transact-SQL)
sp_fulltext_database ( Transact-SQL ) sp_fulltext_database (Transact-SQL)
sp_help_fulltext_catalogs ( Transact-SQL ) sp_help_fulltext_catalogs (Transact-SQL)
sp_help_fulltext_catalogs_cursor ( Transact-SQL ) sp_help_fulltext_catalogs_cursor (Transact-SQL)
Procédures stockées système (Transact-SQL) System Stored Procedures (Transact-SQL)
Recherche en texte intégralFull-Text Search