sp_help_fulltext_system_components (Transact-SQL)

S’applique à : SQL Server Azure Synapse Analytics

Retourne des informations sur les analyseurs lexicaux, le filtre et les gestionnaires de protocoles. sp_help_fulltext_system_components retourne également une liste d’identificateurs de bases de données et de catalogues de texte intégral qui utilisent le composant spécifié.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_help_fulltext_system_components
    [ { 'all' | [ @component_type = ] N'component_type' } ]
    [ , [ @param = ] N'param' ]
[ ; ]

Arguments

'all'

Retourne des informations pour tous les composants de recherche en texte intégral.

[ @component_type = ] N’component_type'

Spécifie le type de composant. @component_type est sysname et peut être l’une des options suivantes :

  • wordbreaker
  • filter
  • protocol handler
  • fullpath

Si un chemin d’accès complet est spécifié, @param doit également être spécifié avec le chemin complet de la DLL du composant, ou un message d’erreur est retourné.

[ @param = ] N’param'

@param est sysname, avec la valeur par défaut NULL. Selon le type de composant, @param est l’une des options suivantes :

  • identificateur de paramètres régionaux (LCID)
  • extension de fichier avec . préfixe
  • nom complet du composant du gestionnaire de protocole
  • chemin d’accès complet à la DLL du composant

Valeurs des codes de retour

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

Jeu de résultats

Le jeu de résultats suivant est retourné pour les composants système.

Nom de la colonne Type de données Description
componenttype sysname Type de composant. Utilisez l’une des options suivantes :

-filtre
- Gestionnaire de protocole
- analyseur de mots
componentname sysname Nom du composant
clsid uniqueidentifier Identificateur de classe du composant
fullpath nvarchar (256) Chemin d'accès de l'emplacement du composant.

NULL = Appelant non membre du rôle serveur fixe serveradmin
version nvarchar(30) Version du composant
manufacturer sysname Nom du fabricant du composant

Le jeu de résultats suivant est retourné uniquement si un ou plusieurs catalogues de texte intégral existent qui utilise @component_type.

Nom de la colonne Type de données Description
dbid int ID de la base de données
ftcatid int ID du catalogue de texte intégral

autorisations

Nécessite l’appartenance au rôle public ; toutefois, les utilisateurs ne peuvent voir que des informations sur les catalogues de texte intégral pour lesquels ils disposent de l’autorisation VIEW DEFINITION. Seuls les membres du rôle serveur fixe serveradmin peuvent voir les valeurs dans la fullpath colonne.

Notes

Cette méthode est particulièrement importante lors de la préparation d'une mise à niveau. Exécutez la procédure stockée dans une base de données particulière et utilisez la sortie pour déterminer si un catalogue particulier est affecté par la mise à niveau.

Exemples

R. Répertorier tous les composants système de texte intégral

L’exemple suivant répertorie tous les composants système de texte intégral inscrits sur l’instance de serveur.

EXEC sp_help_fulltext_system_components 'all';
GO

B. Répertorier les analyseurs de mots

L'exemple suivant répertorie tous les analyseurs lexicaux enregistrés sur l'instance du service.

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

C. Déterminer si un analyseur de mots spécifique est inscrit

L’exemple suivant répertorie le analyseur de mots pour la langue turque (LCID = 1055) s’il a été installé sur le système et inscrit sur l’instance de service. Cet exemple spécifie les noms de paramètres, @component_type et @param.

EXEC sp_help_fulltext_system_components @component_type = 'wordbreaker', @param = 1055;
GO

Par défaut, ce analyseur de mots n’est pas installé. Le jeu de résultats est donc vide.

D. Déterminer si un filtre spécifique est inscrit

L’exemple suivant répertorie le filtre du .xdoc composant s’il a été installé manuellement sur le système et inscrit sur l’instance de serveur.

EXEC sp_help_fulltext_system_components 'filter', '.xdoc';
GO

Par défaut, ce filtre n’est pas installé. Le jeu de résultats est donc vide.

E. Répertorier un fichier DLL spécifique

L'exemple suivant affiche un fichier .ddl spécifique, nlhtml.dll, installé par défaut.

EXEC sp_help_fulltext_system_components 'fullpath',
   'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Binn\nlhtml.dll';
GO