sp_help_fulltext_system_components (Transact-SQL)

  • Articolo

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 utilizzano il componente specificato.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

'all'

Restituisce informazioni per tutti i componenti full-text.

[ @component_type = ] N'component_type'

Specifica il tipo di componente. @component_type è sysname e può essere una delle opzioni seguenti:

  • wordbreaker
  • filter
  • protocol handler
  • fullpath

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

[ @param = ] N'param'

@param è sysname, con un valore predefinito .NULL A seconda del tipo di componente, @param è una delle opzioni seguenti:

  • identificatore delle impostazioni locali (LCID)
  • 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
manufacturer 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 è interessato dall'aggiornamento.

Esempi

R. Elencare tutti i componenti di sistema full-text

Nell'esempio seguente sono elencati tutti i componenti di sistema full-text registrati nell'istanza del 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 dei parametri, @component_type 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 un filtro specifico è registrato

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

Contenuto correlato