sp_fulltext_service (Transact-SQL)
Modifie les propriétés serveur de la recherche en texte intégral pour SQL Server.
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.
RemarqueLe 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.
RemarquePour 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
Voir aussi