Compartilhar via


sp_help_fulltext_system_components (Transact-SQL)

Aplica-se a: SQL Server Azure Synapse Analytics

Retorna informações para os separadores de palavras, filtro e manipuladores de protocolos. sp_help_fulltext_system_components também retorna uma lista de identificadores de bancos de dados e catálogos de texto completo que usam o componente especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

'all'

Retorna informações de todos os componentes de texto completo.

@component_type [ = ] N'component_type'

Especifica o tipo do componente. @component_type é sysname e pode ser uma das seguintes opções:

  • wordbreaker
  • filter
  • protocol handler
  • fullpath

Se um caminho completo for especificado, @param também deverá ser especificado com o caminho completo para a DLL do componente ou uma mensagem de erro será retornada.

@param [ = ] N'param'

@param é sysname, com um padrão de NULL. Dependendo do tipo de componente, @param é uma das seguintes opções:

  • um LCID (identificador de localidade)
  • a extensão do arquivo com . prefixo
  • o nome completo do componente do manipulador de protocolo
  • o caminho completo para a DLL do componente

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

O conjunto de resultados a seguir é retornado para os componentes de sistema.

Nome da coluna Tipo de dados Descrição
componenttype sysname Tipo de componente. Uma das seguintes opções:

-filtro
- manipulador de protocolo
- Separador de palavras
componentname sysname Nome do componente
clsid uniqueidentifier Identificador de classe do componente
fullpath nvarchar(256) Caminho até a localização do componente.

NULL = O chamador não é membro da função de servidor fixa serveradmin
version nvarchar(30) Versão do componente
manufacturer sysname Nome do fabricante do componente

O conjunto de resultados a seguir será retornado somente se existir um ou mais de um catálogo de texto completo que use @component_type.

Nome da coluna Tipo de dados Descrição
dbid int ID do banco de dados
ftcatid int Identificação do catálogo de texto completo.

Permissões

Requer associação na função pública ; no entanto, os usuários só podem ver informações sobre os catálogos de texto completo para os quais têm permissão VIEW DEFINITION. Somente os membros da função de servidor fixa serveradmin podem ver valores fullpath na coluna.

Comentários

Este método é importante na preparação para uma atualização. Execute o procedimento armazenado em um banco de dados específico e use a saída para determinar se um catálogo específico é afetado pela atualização.

Exemplos

R. Listar todos os componentes do sistema de texto completo

O exemplo a seguir lista todos os componentes do sistema de texto completo registrados na instância do servidor.

EXEC sp_help_fulltext_system_components 'all';
GO

B. Listar separadores de palavras

O exemplo a seguir lista todos os separadores de palavras registrados na instância do serviço.

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

C. Determinar se um separador de palavras específico está registrado

O exemplo a seguir lista o separador de palavras para o idioma turco (LCID = 1055) se ele foi instalado no sistema e registrado na instância de serviço. Este exemplo especifica os nomes dos parâmetros, @component_type e @param.

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

Por padrão, esse separador de palavras não está instalado, portanto, o conjunto de resultados está vazio.

D. Determinar se um filtro específico está registrado

O exemplo a seguir lista o filtro para o .xdoc componente se ele foi instalado manualmente no sistema e registrado na instância do servidor.

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

Por padrão, esse filtro não está instalado, portanto, o conjunto de resultados está vazio.

E. Listar um arquivo DLL específico

O exemplo a seguir lista um arquivo .ddl específico, nlhtml.dll, o qual é instalado por padrão.

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