Partilhar via


sp_help_fulltext_system_components (Transact-SQL)

Aplica-se a:Servidor SQLAzure Synapse Analytics

Retorna informações para os separadores de palavras, filtros e manipuladores de protocolo registrados. 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.

Transact-SQL convenções de sintaxe

Sintaxe

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

Argumentos

'todos'

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

@component_type [ = ] N'component_type'

Especifica o tipo de 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 identificador de localidade (LCID)
  • 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 de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

O seguinte conjunto de resultados é retornado para os componentes do sistema.

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

- filtro
- manipulador de protocolo
- Disjuntor de palavras
componentname sysname Nome do componente
clsid identificador único Identificador de classe do componente
fullpath Nvarchar(256) Caminho para o local 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 da base de dados
ftcatid Int ID do catálogo de texto completo

Permissões

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

Observações

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

Exemplos

Um. 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.

EXECUTE 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 de serviço.

EXECUTE 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.

EXECUTE 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.

EXECUTE 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, que é instalado por padrão.

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