• Articolo

sp_help_fulltext_system_components (Transact-SQL)

Restituisce informazioni per i word breaker, i filtri e i gestori di protocollo registrati. sp_help_fulltext_system_components restituisce inoltre l'elenco degli identificatori dei database e dei cataloghi full-text che hanno utilizzato il componente specificato.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • 'all'
    Restituisce informazioni per tutti i componenti full-text.

  • [ @component_type= ] component_type
    Specifica il tipo di componente. I possibili valori per component_type sono i seguenti:

    • wordbreaker

    • filter

    • protocol handler

    • fullpath

    Se viene specificato un percorso completo, è necessario specificare anche param con il percorso completo per la DLL del componente. In caso contrario, viene restituito un messaggio di errore.

    Nota

    Per ulteriori informazioni sui componenti della ricerca full-text, vedere Architettura della ricerca full-text e Configurazione dei componenti linguistici full-text.

  • [ @param= ] param
    In base al tipo di componente, i possibili valori sono i seguenti: identificatore delle impostazioni locali (LCID), estensione di file con prefisso ".", nome completo del componente del gestore di protocollo o percorso completo della DLL del componente.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Il set di risultati seguente viene restituito per i componenti di sistema.

Nome colonna

Tipo di dati

Descrizione

componenttype

sysname

Tipo di componente. Uno dei valori seguenti:

  • filter

  • protocol handler

  • wordbreaker

componentname

sysname

Nome del componente.

clsid

uniqueidentifier

Identificatore di classe del componente.

fullpath

nvarchar(256)

Percorso della posizione del componente.

NULL = il chiamante non è membro del ruolo predefinito del server serveradmin.

version

nvarchar(30)

Versione del componente.

manufacturer

sysname

Nome del produttore del componente.

Il set di risultati seguente viene restituito solo se esistono uno o più cataloghi che utilizzano component_type.

Nome colonna

Tipo di dati

Descrizione

dbid

int

ID del database.

ftcatid

int

ID del catalogo full-text.

Autorizzazioni

È richiesta l'appartenenza al ruolo public. Gli utenti possono tuttavia visualizzare solo le informazioni relative ai cataloghi full-text per i quali dispongono dell'autorizzazione VIEW DEFINITION. Solo i membri del ruolo predefinito del server serveradmin possono visualizzare i valori nella colonna fullpath.

Osservazioni

Questo metodo è di particolare importanza durante la preparazione per un aggiornamento. Eseguire la stored procedure all'interno di un particolare database e utilizzare l'output per determinare se l'aggiornamento avrà effetti su un particolare catalogo.

Esempi

A. Elenco di tutti i componenti di sistema full-text

Nell'esempio seguente vengono elencati tutti i componenti di sistema full-text registrati sull'istanza server.

EXEC sp_help_fulltext_system_components 'all';
GO

B. Elenco di word breaker

Nell'esempio seguente vengono elencati tutti i word breaker registrati sull'istanza del servizio.

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

C. Determinazione della registrazione di un word breaker specifico

Nell'esempio seguente viene elencato il word breaker per la lingua turca (LCID = 1055) se è stato installato nel sistema e registrato sull'istanza del servizio. In questo esempio vengono specificati i nomi di parametro @component_type e @param.

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

Per impostazione predefinita, questo word breaker non è installato, pertanto il set di risultati è vuoto.

C. Determinazione della registrazione di un filtro specifico

Nell'esempio seguente viene elencato il filtro per il componente xdoc se è stato manualmente installato nel sistema e registrato sull'istanza del server.

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

Per impostazione predefinita, questo filtro non è installato, pertanto il set di risultati è vuoto.

E. Elenco di un file dll specifico

Nell'esempio seguente viene elencato un file con estensione ddl specifico, nlhtml.dll, installato per impostazione predefinita.

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