Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Applies to:
SQL Server
Modifie les propriétés serveur de la recherche en texte intégral pour SQL Server.
Caution
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
Syntax
sp_fulltext_service
[ [ @action = ] N'action' ]
[ , [ @value = ] value ]
[ ; ]
Arguments
[ @action = ] N'action'
Propriété à modifier ou réinitialiser. @action is nvarchar(100), with no default. For a list of @action properties, their descriptions, and the values that can be set, see the table under the @value argument.
Cet argument retourne les propriétés suivantes :
- data type
- valeur en cours d’exécution
- valeur minimale ou maximale
- état de dépréciation, le cas échéant.
[ @value = ] value
@value is sql_variant, with a default of NULL.
Valeur de la propriété spécifiée.
@value is sql_variant, with a default value of NULL. If @value is null, sp_fulltext_service returns the current setting. Ce tableau répertorie les propriétés relatives aux actions, leurs descriptions et les valeurs qui peuvent être définies.
Note
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 | Data type | 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. One of: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. Filters are used by the filter daemon host to extract textual information from corresponding file formats such as .docx stored in data types, such as varbinary, varbinary(max), image, or xml, for full-text indexing.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. One of: - 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.Note: Rebuild can run in multi-threaded mode, and if more than 10 CPUs are available, rebuild might run faster than import if you allow rebuild to use all of the CPUs. 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. Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. Pour plus d’informations, consultez Gérer et surveiller la recherche en texte intégral pour une instance de serveur. |
verify_signature
1 |
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. |
1 When verify_signature is 1, the Full-Text Engine only checks the cached Certificate Revocation List (CRL) before loading binaries. You should periodically refresh your local CRL cache with certutil, when using third party binaries.
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Result set
None.
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).
Permissions
Only members of the serveradmin fixed server role or the system administrator can execute sp_fulltext_service.
Examples
A. 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. This example specifies the optional @action and @value arguments.
EXECUTE sp_fulltext_service
@action = 'upgrade_option',
@value = 1;
GO