• Artigo

sp_help_fulltext_system_components (Transact-SQL)

Retorna informações para os separadores de palavra, 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 usaram o componente especificado.

Ícone de vínculo de tópicoConvenções de sintaxe 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 de componente. component_type pode ser um dos seguintes:

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

    ObservaçãoObservação

    Para obter informações sobre os componentes da pesquisa de texto completo, consulte Arquitetura da pesquisa de texto completo e Configurando componentes lingüísticos de texto completo.

  • [ @param= ] param
    Dependendo do tipo de componente, esse parâmetro poderá ser um dos seguintes: um LCID (identificador de localidade), a extensão do arquivo com o prefixo ".", o nome completo do componente do manipulador de protocolo ou o caminho completo para a DLL do componente.

Valores de código de retorno

0 (êxito) ou (1) falha

Conjuntos 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. Um dos seguintes:

  • filtro

  • manipulador de protocolo

  • separador de palavras

componentname

sysname

O 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)

A versão do componente.

manufacturer

sysname

Nome do fabricante do componente.

O conjunto de resultados a seguir é retornado somente se um ou mais catálogos de texto completo existirem e usarem 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; entretanto, os usuários podem ver apenas as informações sobre os catálogos de texto completo para os quais têm a permissão VIEW DEFINITION. Somente os membros da função fixa serveradmin podem ver os valores na coluna fullpath.

Comentários

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

Exemplos

A. Listando todos os componentes de texto completo do sistema

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. Listando 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. Determinando se um separador de palavras específico está registrado

O exemplo a seguir listará o separador de palavras do idioma turco (LCID = 1055) se este tiver sido instalado no sistema e registrado na instância do serviço. Este exemplo especifica os nomes de parâmetro, @ 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 é instalado, portanto, o conjunto de resultados é vazio.

D. Determinando se um filtro específico foi registrado

O exemplo a seguir listará o filtro do componente .xdoc se ele tiver sido 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 é instalado, portanto, o conjunto de resultados é vazio.

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