Compartir vía


sp_help_fulltext_system_components (Transact-SQL)

Se aplica a: SQL Server Azure Synapse Analytics

Devuelve información de los separadores de palabras, filtros y controladores de protocolo registrados. sp_help_fulltext_system_components también devuelve una lista de identificadores de bases de datos y catálogos de texto completo que usan el componente especificado.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

'all'

Devuelve información para todos los componentes de texto completo.

[ @component_type = ] N'component_type'

Especifica el tipo de componente. @component_type es sysname y puede ser una de las siguientes opciones:

  • wordbreaker
  • filter
  • protocol handler
  • fullpath

Si se especifica una ruta de acceso completa, también se debe especificar @param con la ruta de acceso completa al archivo DLL del componente o se devuelve un mensaje de error.

[ @param = ] N'param'

@param es sysname, con un valor predeterminado de NULL. En función del tipo de componente, @param es una de las siguientes opciones:

  • un identificador de configuración regional (LCID)
  • la extensión de archivo con . prefijo
  • el nombre completo del componente del controlador de protocolos
  • la ruta de acceso completa al archivo DLL del componente

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Para los componentes del sistema, se devuelve el siguiente conjunto de resultados.

Nombre de la columna Tipo de datos Descripción
componenttype sysname Tipo de componente. Una de las siguientes opciones:

-filtro
- controlador de protocolo
- separador de palabras
componentname sysname Nombre del componente
clsid uniqueidentifier Identificador de clase del componente
fullpath nvarchar(256) Ruta de acceso a la ubicación del componente.

NULL = Llamador no miembro del rol fijo de servidor serveradmin
version nvarchar(30) Versión del componente
manufacturer sysname Nombre del fabricante del componente

El siguiente conjunto de resultados solo se devuelve si existe uno o más de un catálogo de texto completo que usa @component_type.

Nombre de la columna Tipo de datos Descripción
dbid int Id. de la base de datos
ftcatid int Id. del catálogo de texto completo

Permisos

Requiere la pertenencia al rol público ; sin embargo, los usuarios solo pueden ver información sobre los catálogos de texto completo para los que tienen permiso VIEW DEFINITION. Solo los miembros del rol fijo de servidor serveradmin pueden ver los valores de la fullpath columna.

Comentarios

Este método es de particular importancia cuando se prepara una actualización. Ejecute el procedimiento almacenado dentro de una base de datos determinada y use la salida para determinar si un catálogo determinado se ve afectado por la actualización.

Ejemplos

A Enumeración de todos los componentes del sistema de texto completo

En el ejemplo siguiente se enumeran todos los componentes del sistema de texto completo registrados en la instancia del servidor.

EXEC sp_help_fulltext_system_components 'all';
GO

B. Enumerar separadores de palabras

En el ejemplo siguiente se muestran todos los separadores de palabras registrados en la instancia del servicio.

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

C. Determinar si un separador de palabras específico está registrado

En el ejemplo siguiente se muestra el separador de palabras para el idioma turco (LCID = 1055) si se instaló en el sistema y se registró en la instancia de servicio. En este ejemplo se especifican los nombres de parámetro, @component_type y @param.

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

De forma predeterminada, este separador de palabras no está instalado, por lo que el conjunto de resultados está vacío.

D. Determinar si se registra un filtro específico

En el ejemplo siguiente se muestra el filtro del .xdoc componente si se instaló manualmente en el sistema y se registró en la instancia del servidor.

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

De forma predeterminada, este filtro no está instalado, por lo que el conjunto de resultados está vacío.

E. Enumeración de un archivo DLL específico

En el ejemplo siguiente se muestra un archivo .ddl específico, nlhtml.dll, que se instala de manera predeterminada.

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