sp_help_fulltext_system_components (Transact-SQL)

Articolo
08/21/2023

Si applica a:SQL Server Azure Synapse Analytics

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

Convenzioni di 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. component_type può essere una delle opzioni seguenti:

wordbreaker
filter
protocol handler
fullpath

Se viene specificato un percorso completo, è necessario specificare anche il parametro con il percorso completo della DLL del componente oppure viene restituito un messaggio di errore.

[ @param = ] 'param'

A seconda del tipo di componente, param è una delle opzioni seguenti:

identificatore delle impostazioni locali (LCID)
l'estensione di file con prefisso "."
nome completo del componente del gestore del protocollo
percorso completo della DLL del componente

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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. Una delle opzioni seguenti: -Filtro - Gestore del protocollo - wordbreaker
componentname	sysname	Nome del componente
Clsid	uniqueidentifier	Identificatore di classe del componente
Fullpath	nvarchar(256)	Percorso della posizione del componente. NULL = Chiamante non membro del ruolo predefinito del server serveradmin
version	nvarchar(30)	Versione del componente
Produttore	sysname	Nome del produttore del componente

Il set di risultati seguente viene restituito solo se esiste uno o più cataloghi full-text che utilizzano component_type.

Nome colonna	Tipo di dati	Descrizione
dbid	int	ID del database
ftcatid	int	ID del catalogo full-text

Autorizzazioni

Richiede l'appartenenza al ruolo pubblico . Tuttavia, gli utenti possono visualizzare solo informazioni sui cataloghi full-text per i quali dispongono dell'autorizzazione VIEW DEFINITION. Solo i membri del ruolo predefinito del serveradmin possono visualizzare i valori nella fullpath colonna .

Osservazioni:

Questo metodo è di particolare importanza durante la preparazione per un aggiornamento. Eseguire la stored procedure all'interno di un determinato database e usare l'output per determinare se un determinato catalogo sarà interessato dall'aggiornamento.

Esempi

R. Elencare 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. Elencare 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. Determinare se è registrato 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 nell'istanza del servizio. In questo esempio vengono specificati i nomi @component_type dei parametri e @param.

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

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

D. Determinare se è stato registrato un filtro specifico

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

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

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

E. Elencare 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\MSSQL13.MSSQLSERVER\MSSQL\Binn\nlhtml.dll';
GO