Compartir a través de


sp_fulltext_service (Transact-SQL)

Se aplica a: SQL Server

Cambia las propiedades de servidor de la búsqueda de texto completo para SQL Server.

Precaución

La upgrade_option acción no es totalmente compatible con SQL Server 2022 (16.x) y versiones posteriores. Para obtener más información, consulte la sección Compatibilidad con SQL Server 2022 y versiones posteriores más adelante en este artículo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_fulltext_service
    [ [ @action = ] N'action' ]
    [ , [ @value = ] value ]
[ ; ]

Argumentos

[ @action = ] N'action'

Propiedad que se va a cambiar o restablecer. @action es nvarchar(100), sin ningún valor predeterminado. Para obtener una lista de propiedades de @action , sus descripciones y los valores que se pueden establecer, vea la tabla en el argumento @value .

Este argumento devuelve las siguientes propiedades:

  • tipo de datos
  • valor en ejecución actual
  • valor mínimo o máximo
  • estado de desuso, si procede.

[ @value = ] value

@value es sql_variant, con un valor predeterminado de NULL.

Valor de la propiedad especificada. @value es sql_variant, con un valor predeterminado de NULL. Si @value es null, sp_fulltext_service devuelve la configuración actual. En la siguiente tabla se muestran las propiedades de acción, sus descripciones y los valores que se pueden establecer.

Nota:

Las siguientes acciones se quitarán en una versión futura de SQL Server: clean_up, connect_timeout, data_timeouty resource_usage. Evite su uso en nuevos trabajos de desarrollo y piense en modificar las aplicaciones que las usan actualmente.

Action Tipo de datos Descripción
clean_up int Se admite únicamente por compatibilidad con versiones anteriores. El valor siempre 0es .
connect_timeout int Se admite únicamente por compatibilidad con versiones anteriores. El valor siempre 0es .
data_timeout int Se admite únicamente por compatibilidad con versiones anteriores. El valor siempre 0es .
load_os_resources int Indica si los separadores de palabras, los lematizadores y los filtros del sistema operativo están registrados y se usan con esta instancia de SQL Server. Uno de los valores siguientes:

0 = Use solo filtros y separadores de palabras específicos de esta instancia de SQL Server.

1 = Cargar filtros del sistema operativo y separadores de palabras.

De forma predeterminada, esta propiedad está deshabilitada para impedir cambios de comportamiento involuntarios por actualizaciones del sistema operativo. Habilitar el uso de recursos del sistema operativo proporciona acceso a los recursos para los idiomas y los tipos de documento registrados con microsoft Indexing Service que no tienen instalado un recurso específico de instancia. Si habilita la carga de recursos del sistema operativo, asegúrese de que los recursos del sistema operativo sean binarios firmados de confianza; De lo contrario, no se pueden cargar cuando verify_signature se establece en 1.
master_merge_dop int Especifica el número de subprocesos que utilizará el proceso de mezcla maestra. Este valor no debe superar el número de CPU o núcleos de CPU disponibles.

Cuando no se especifica este argumento, el servicio usa el menor de o el número de 4CPU o núcleos de CPU disponibles.
pause_indexing int Especifica si se debe pausar la indexación de texto completo, si se está ejecutando o reanudando, si está en pausa actualmente.

0 = Reanuda las actividades de indexación de texto completo para la instancia del servidor.

1 = Pausa las actividades de indexación de texto completo para la instancia del servidor.
resource_usage int No tiene ninguna función en SQL Server 2008 (10.0.x) y versiones posteriores, y se omite.
update_languages NULL Actualiza la lista de idiomas y filtros registrados con búsqueda de texto completo. Los idiomas se especifican al configurar la indización y en las consultas de texto completo. El host del demonio de filtro usa filtros para extraer información textual de los formatos de archivo correspondientes, como .docx almacenados en tipos de datos, como varbinary, varbinary(max), image o xml para la indexación de texto completo.

Para obtener más información, vea Ver o cambiar filtros registrados y separadores de palabras.
upgrade_option int Controla cómo se migran los índices de texto completo al actualizar una base de datos de SQL Server 2005 (9.x) a una versión posterior. Esta propiedad se aplica a la actualización al adjuntar una base de datos, restaurar una copia de seguridad de base de datos, restaurar una copia de seguridad de archivo o copiar la base de datos mediante el Asistente para copiar bases de datos.

Uno de los valores siguientes:

- 0 = Los catálogos de texto completo se vuelven a generar mediante los separadores de palabras nuevos y mejorados. La regeneración de índices puede tardar algún tiempo y es posible que se requiera una cantidad significativa de CPU y memoria después de la actualización.

- 1 = Se restablecen los catálogos de texto completo. SQL Server 2005 (9.x) Los archivos de catálogo de texto completo se quitan, pero los metadatos de los catálogos de texto completo y los índices de texto completo se conservan. Después de actualizarse, todos los índices de texto completo están deshabilitados para el seguimiento de cambios y los rastreos no se inician automáticamente. El catálogo permanecerá vacío hasta que se emita manualmente un rellenado completo después de que se complete la actualización.

- 2 = Se importan catálogos de texto completo. Normalmente, la importación es más rápida que la recompilación. Por ejemplo, si se usa solo una CPU, importar es aproximadamente 10 veces más rápido que volver a generar. Sin embargo, un catálogo de texto completo importado no usa los separadores de palabras nuevos y mejorados, por lo que es posible que quiera recompilar los catálogos de texto completo en su lugar. Se ha quitado en SQL Server 2022 (16.x) y versiones posteriores, y genera un error.

Nota: La recompilación se puede ejecutar en modo multiproceso y, si hay más de 10 CPU disponibles, la recompilación puede ejecutarse más rápido que la importación si permite volver a generar para usar todas las CPU.

Si un catálogo de texto completo no está disponible, se vuelven a generar los índices de texto completo asociados. Esta opción solo está disponible para las bases de datos de SQL Server 2005 (9.x).

Para obtener información sobre cómo elegir una opción de actualización de texto completo, veaActualizar la búsqueda de texto completo.

Nota: Para establecer esta propiedad en SQL Server Management Studio, use la propiedad Opción de actualización de texto completo. Para obtener más información, vea Administrar y supervisar la búsqueda de texto completo para una instancia de servidor.
verify_signature int Indica si el motor de texto completo solo carga archivos binarios firmados. De forma predeterminada, solo se cargan binarios con firma de confianza.

1 = Compruebe que solo se cargan archivos binarios firmados de confianza (valor predeterminado).

0 = No compruebe si los archivos binarios están firmados.

Valores de código de retorno

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

Conjunto de resultados

Ninguno.

Compatibilidad con SQL Server 2022 y versiones posteriores

La característica de importación de la upgrade_option acción (especificada por @action = 'upgrade_option', @value = 2) se quita en SQL Server 2022 (16.x) y versiones posteriores. Si necesita importar un índice de texto completo de una versión anterior de SQL Server, puede importarlo mediante SQL Server 2019 (15.x) o versiones anteriores y, a continuación, actualizar a SQL Server 2022 (16.x).

Permisos

Solo los miembros del rol fijo de servidor serveradmin o el administrador del sistema pueden ejecutar sp_fulltext_service.

Ejemplos

A Actualizar la lista de idiomas registrados

En el ejemplo siguiente se actualiza la lista de idiomas registrados con búsqueda de texto completo.

EXECUTE sp_fulltext_service 'update_languages';
GO

B. Cambiar la opción de actualización de texto completo para restablecer catálogos de texto completo

En el ejemplo siguiente se cambia la opción de actualización de texto completo para restablecer catálogos de texto completo, quitándolos completamente. En este ejemplo se especifican los argumentos opcionales @action y @value .

EXECUTE sp_fulltext_service
    @action = 'upgrade_option',
    @value = 1;
GO