sp_fulltext_service (Transact-SQL)

  • Article

S’applique à :SQL Server

Modifie les propriétés serveur de la recherche en texte intégral pour SQL Server.

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 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 : propre_up, connect_timeout, data_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
propre_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 = Utiliser uniquement les filtres et les analyseurs lexicaux propres à cette instance de SQL Server.

1 = Charger les filtres et les analyseurs lexicaux du système d'exploitation.

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 lorsque verify_signature est défini 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 la valeur inférieure à 4, ou le nombre de processeurs ou de cœurs de processeur 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 en texte intégral.

Pour plus d’informations, consultez Afficher ou modifier des filtres et des analyseurs lexicaux inscrits.
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 lexicaux 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 éventuellement.

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érifier que seuls les binaires signés et approuvés sont chargés (valeur par défaut).

0 = Ne vérifiez pas si les fichiers binaires sont signés.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Aucune.

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.

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

EXEC sp_fulltext_service
    @action = 'upgrade_option',
    @value = 1;
GO

Contenu connexe