sp_help_fulltext_system_components (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerAzure 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 usaram o componente especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

'all'

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

@component_type [ = ] 'component_type'

Especifica o tipo do componente. component_type 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 [ = ] 'param'

Dependendo do tipo de componente, param é uma das seguintes opções:

  • um identificador de localidade (LCID)
  • A extensão do arquivo com o 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
tipo de componente sysname Tipo de componente. Uma das seguintes opções:

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

NULL = Chamador não é membro da função de servidor fixa serveradmin
version nvarchar(30) Versão do componente
fabricante 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 à 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 os fullpath valores 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 será afetado pela atualização.

Exemplos

R. Listar todos os componentes do sistema de texto completo

O exemplo a seguir lista todos os componentes de texto completo do sistema que tenham sido registrados na instância de 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 listará o separador de palavras para o idioma turco (LCID = 1055) se ele tiver sido instalado no sistema e registrado na instância de serviço. Este exemplo especifica os nomes @component_type dos parâmetros 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 foi registrado

O exemplo a seguir lista o filtro do componente se ele tiver sido instalado manualmente no sistema e registrado na instância do .xdoc 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

Conteúdo relacionado