sp_fulltext_service (Transact-SQL)
S'applique à : 
SQL Server
Modifie les propriétés serveur de la recherche en texte intégral pour SQL Server.
Attention
L’action upgrade_option n’est pas entièrement prise en charge dans SQL Server 2022 (16.x) et versions ultérieures. Pour plus d’informations, consultez la section Compatibilité avec SQL Server 2022 et versions ultérieures plus loin dans cet article.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_fulltext_service
[ [ @action = ] N'action' ]
[ , [ @value = ] value ]
[ ; ]
Arguments
[ @action = ] N’action'
Propriété à modifier ou réinitialiser. @action est nvarchar(100), sans valeur par défaut. Pour obtenir la liste des propriétés @action , leurs descriptions et les valeurs qui peuvent être définies, consultez la table sous l’argument @value .
Cet argument retourne les propriétés suivantes :
- type de données
- valeur en cours d’exécution
- valeur minimale ou maximale
- état de dépréciation, le cas échéant.
[ @value = ] value
@value est sql_variant, avec la valeur par défaut NULL.
Valeur de la propriété spécifiée. @value est sql_variant, avec une valeur par défaut de NULL. Si @value a la valeur Null, sp_fulltext_service retourne le paramètre actuel. Ce tableau répertorie les propriétés relatives aux actions, leurs descriptions et les valeurs qui peuvent être définies.
Remarque
Les actions suivantes seront supprimées dans une prochaine version de SQL Server : clean_up, , connect_timeoutdata_timeout, et resource_usage. Évitez par conséquent d'utiliser ces actions dans un nouveau travail de développement et prévoyez la modification des applications qui les utilisent actuellement.
| Action | Type de données | Description |
|---|---|---|
clean_up |
int | Pris en charge pour la compatibilité descendante uniquement. La valeur est toujours 0. |
connect_timeout |
int | Pris en charge pour la compatibilité descendante uniquement. La valeur est toujours 0. |
data_timeout |
int | Pris en charge pour la compatibilité descendante uniquement. La valeur est toujours 0. |
load_os_resources |
int | Indique si les analyseurs de mots, les générateurs de formes dérivées et les filtres du système d’exploitation sont inscrits et utilisés avec cette instance de SQL Server. Valeurs possibles :0 = Utilisez uniquement des filtres et des analyseurs de mots spécifiques à cette instance de SQL Server.1 = Charger des filtres de système d’exploitation et des analyseurs de mots.Par défaut, cette propriété est désactivée afin d'empêcher des modifications de comportement accidentelles suite à des mises à jour du système d'exploitation. L’activation de l’utilisation des ressources du système d’exploitation permet d’accéder aux ressources pour les langues et les types de documents inscrits auprès du service d’indexation Microsoft qui n’ont pas de ressource spécifique à une instance installée. Si vous activez le chargement des ressources du système d’exploitation, vérifiez que les ressources du système d’exploitation sont des fichiers binaires signés approuvés ; sinon, ils ne peuvent pas être chargés lorsqu’ils verify_signature sont définis sur 1. |
master_merge_dop |
int | Spécifie le nombre de threads à utiliser par le processus de fusion principal. Cette valeur ne doit pas dépasser le nombre de processeurs ou de cœurs d’UC disponibles. Quand cet argument n’est pas spécifié, le service utilise le moins grand nombre de 4processeurs ou de cœurs d’UC disponibles. |
pause_indexing |
int | Spécifie si l’indexation de texte intégral doit être suspendue, si elle est en cours d’exécution ou reprise, si elle est actuellement suspendue.0 = Reprend les activités d’indexation de texte intégral pour l’instance de serveur.1 = Suspend les activités d’indexation de texte intégral pour l’instance de serveur. |
resource_usage |
int | N’a aucune fonction dans SQL Server 2008 (10.0.x) et versions ultérieures, et est ignorée. |
update_languages |
NULL |
Met à jour la liste des langues et des filtres qui sont inscrits avec la recherche en texte intégral. Les langues sont spécifiées lors de la configuration de l'indexation et dans les requêtes de texte intégral. Les filtres sont utilisés par l’hôte de démon de filtre pour extraire des informations textuelles à partir de formats de fichiers correspondants tels que .docx stockés dans des types de données, tels que varbinary, varbinary(max), image ou xml, pour l’indexation de texte intégral.Pour plus d’informations, consultez Afficher ou modifier les filtres inscrits et les analyseurs de mots. |
upgrade_option |
int | Contrôle la migration des index de recherche en texte intégral lors de la mise à niveau d’une base de données de SQL Server 2005 (9.x) vers une version ultérieure. Cette propriété s'applique à la mise à niveau par attachement d'une base de données, restauration d'une sauvegarde de la base de données, restauration d'une sauvegarde de fichiers ou copie de la base de données à l'aide de l'Assistant Copie de base de données. Valeurs possibles : - 0 = Les catalogues de texte intégral sont reconstruits à l’aide des analyseurs de mots nouveaux et améliorés. La reconstruction d’index peut prendre un certain temps, et une quantité importante d’UC et de mémoire peut être nécessaire après la mise à niveau.- 1 = Les catalogues de texte intégral sont réinitialisés. SQL Server 2005 (9.x) Les fichiers de catalogue de texte intégral sont supprimés, mais les métadonnées pour les catalogues de texte intégral et les index de recherche en texte intégral sont conservés. Une fois mis à niveau, tous les index de recherche en texte intégral sont désactivés pour le suivi des modifications et les analyses ne sont pas démarrés automatiquement. Le catalogue reste vide tant que vous n'avez pas procédé manuellement à une alimentation complète, au terme de la mise à niveau.- 2 = Les catalogues de texte intégral sont importés. En règle générale, l’importation est plus rapide que la reconstruction. Par exemple, lorsque vous utilisez un seul processeur, l'importation s'exécute approximativement 10 fois plus vite que lors de la reconstruction. Toutefois, un catalogue de texte intégral importé n’utilise pas les nouveaux analyseurs de mots améliorés. Vous pouvez donc reconstruire vos catalogues de texte intégral à la place. Supprimé dans SQL Server 2022 (16.x) et versions ultérieures, et génère une erreur.Remarque : La reconstruction peut s’exécuter en mode multithread et, si plus de 10 PROCESSEURs sont disponibles, la reconstruction peut s’exécuter plus rapidement que l’importation si vous autorisez la reconstruction à utiliser toutes les UC. Si aucun catalogue de texte intégral n’est disponible, les index de recherche en texte intégral associés sont reconstruits. Cette option est disponible uniquement pour les bases de données SQL Server 2005 (9.x). Pour plus d’informations sur le choix d’une option de mise à niveau de recherche en texte intégral, consultezMise à niveau de la fonction de recherche en texte intégral. Remarque : Pour définir cette propriété dans SQL Server Management Studio, utilisez la propriété Option de mise à niveau de texte intégral. Pour plus d’informations, consultez Gérer et surveiller la recherche en texte intégral pour une instance de serveur. |
verify_signature |
int | Indique si le moteur de recherche en texte intégral charge uniquement les fichiers binaires signés. Par défaut, seuls les binaires approuvés et signés sont chargés.1 = Vérifiez que seuls les fichiers binaires approuvés et signés sont chargés (par défaut).0 = Ne vérifiez pas si les fichiers binaires sont signés. |
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Jeu de résultats
Aucune.
Compatibilité avec SQL Server 2022 et versions ultérieures
La fonctionnalité d’importation dans l’action upgrade_option (spécifiée par @action = 'upgrade_option', @value = 2) est supprimée dans SQL Server 2022 (16.x) et versions ultérieures. Si vous devez importer un index de texte intégral à partir d’une version antérieure de SQL Server, vous pouvez l’importer à l’aide de SQL Server 2019 (15.x) ou des versions antérieures, puis effectuer une mise à niveau vers SQL Server 2022 (16.x).
autorisations
Seuls les membres du rôle serveur fixe serveradmin ou l’administrateur système peuvent s’exécuter sp_fulltext_service.
Exemples
R. Mettre à jour la liste des langues inscrites
L'exemple ci-dessous met à jour la liste des langues inscrites avec la recherche en texte intégral.
EXECUTE sp_fulltext_service 'update_languages';
GO
B. Modifier l’option de mise à niveau de texte intégral pour réinitialiser les catalogues de texte intégral
L’exemple suivant modifie l’option de mise à niveau de texte intégral pour réinitialiser complètement les catalogues de texte intégral. Cet exemple spécifie les arguments facultatifs @action et @value .
EXECUTE sp_fulltext_service
@action = 'upgrade_option',
@value = 1;
GO