Partager via


sp_fulltext_service (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe Transact-SQL

Syntaxe

sp_fulltext_service [ [@action=] 'action' 
     [ , [ @value= ] value ] ]

Arguments

  • [ @action=] 'action'
    Propriété à modifier ou à réinitialiser. L'argument action est de type nvarchar(100), , sans valeur par défaut. Le tableau présenté sous l'argument value récapitule les propriétés des actions, leurs descriptions et les valeurs qui peuvent être définies. Cet argument retourne les propriétés suivantes : type de données, valeur d'exécution actuelle, valeur minimum ou maximum et état de désapprobation, le cas échéant.

  • [ @value=] value
    Valeur de la propriété spécifiée. value est de type sql_variant, avec la valeur par défaut NULL. Si @value est Null, sp_fulltext_service retourne la valeur actuelle. Ce tableau répertorie les propriétés relatives aux actions, leurs descriptions et les valeurs qui peuvent être définies.

    Notes

    Les actions suivantes seront supprimées dans une version ultérieure de SQL Server : clean_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

    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.

    upgrade_option

    int

    Contrôle la manière dont les index de recherche en texte intégral sont migrés lors d'une mise à niveau d'une base de données de SQL Server 2000 ou SQL Server 2005 vers SQL Server 2008 ou une version ultérieure. Cette propriété s'applique à la mise à niveau par attachement d'une base de données, par la restauration d'une sauvegarde de la base, la restauration d'une sauvegarde de fichiers ou la copie de la base de données à l'aide de l'Assistant Copie de base de données.

    Une des valeurs suivantes :

    0 = Les catalogues de texte intégral sont reconstruits à l'aide des analyseurs lexicaux nouveaux et améliorés. La reconstruction des index peut prendre du temps, et une quantité importante de ressources en termes d'UC et de mémoire peut être requise après la mise à niveau.

    1 = Les catalogues de texte intégral sont réinitialisés. Les catalogues de texte intégral SQL Server 2005 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. Après leur mise à niveau, tous les index de recherche en texte intégral ont le suivi des modifications désactivé et aucune analyse n'est démarrée 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 général, l'importation est considérablement plus rapide que lors d'une 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 analyseurs lexicaux nouveaux et améliorés introduits dans SQL Server 2008, ce qui fait que vous pouvez le cas échéant reconstruire vos catalogues de texte intégral au final.

    RemarqueRemarque
    Le processus de reconstruction peut s'exécuter en mode multithread, et si plus de 10 processeurs sont disponibles, la reconstruction peut s'effectuer plus vite que l'importation si vous la laissez utiliser tous les processeurs.

    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.

    Pour plus d'informations sur le choix d'une option de mise à niveau du catalogue de texte intégral, consultez Mise à niveau de la fonction de recherche en texte intégral.

    RemarqueRemarque
    Pour définir cette propriété dans SQL Server Management Studio, utilisez la propriété Option de mise à niveau du catalogue de texte intégral. Pour plus d'informations, consultez Procédure : afficher ou modifier les propriétés de serveur pour la recherche en texte intégral (SQL Server Management Studio).

    load_os_resources

    int

    Indique si les analyseurs lexicaux, 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. Une des valeurs suivantes :

    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'utilisation des ressources du système d'exploitation permet d'accéder aux ressources associées aux langues et types de document inscrits avec le service d'indexation Microsoft pour lesquels aucune ressource propre à l'instance n'est installée. Si vous activez le chargement des ressources du système d'exploitation, assurez-vous que ces ressources sont des fichiers binaires signés et approuvés ; si tel n'est pas le cas, il est impossible de les charger lorsque verify_signature (voir ci-dessous) a la valeur 1.

    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 et les versions ultérieures, et est ignoré.

    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 de formats de fichier correspondants, tels que .docx, stockées dans les types de données, tels que varbinary, varbinary(max), image ou xml, pour l'indexation de texte intégral.

    Pour plus d'informations, consultez Procédure : modifier la liste des analyseurs lexicaux et des filtres inscrits (Transact-SQL).

    verify_signature

    int

    Indique si seuls les fichiers binaires signés sont chargés par le Moteur d'indexation et de recherche en texte intégral. Par défaut, seuls les fichiers binaires signés et approuvé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 pas vérifier si les binaires sont signés.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Autorisations

Seuls les membres du rôle serveur fixe serveradmin ou l'administrateur système peuvent exécuter sp_fulltext_service.

Exemples

A. Mise à jour de 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. Modification de l'option de mise à niveau du catalogue de texte intégral pour réinitialiser des catalogues de texte intégral

L'exemple ci-dessous modifie l'option de mise à niveau du catalogue de texte intégral pour réinitialiser des catalogues de texte intégral. Cela les supprime complètement. Cet exemple spécifie les mots clés facultatifs @action et @value.

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