sp_fulltext_service (Transact-SQL)

2025-07-23

Applies to:SQL Server

Изменяет серверные свойства полнотекстового поиска для SQL Server.

Caution

Действие upgrade_option не полностью поддерживается в SQL Server 2022 (16.x) и более поздних версиях. Дополнительные сведения см . в разделе "Совместимость с SQL Server 2022 и более поздними версиями " далее в этой статье.

Соглашения о синтаксисе Transact-SQL

Syntax

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

Arguments

[ @action = ] N'action'

Свойство, которое необходимо изменить или сбросить. @action is nvarchar(100), with no default. For a list of @action properties, their descriptions, and the values that can be set, see the table under the @value argument.

Этот аргумент возвращает следующие свойства:

data type
текущее запущенное значение
минимальное или максимальное значение
состояние нерекомендуемого значения, если применимо.

[ @value = ] value

@value is sql_variant, with a default of NULL.

Значение указанного свойства. @value is sql_variant, with a default value of NULL. If @value is null, sp_fulltext_service returns the current setting. В этой таблице перечислены свойства действий, их описания, а также возможные значения.

Note

Следующие действия будут удалены в будущем выпуске SQL Server: clean_up, , connect_timeoutdata_timeoutи resource_usage. Следует избегать использования этих действий в новой разработке и запланировать изменение приложений, использующих их в настоящий момент.

Action	Data type	Description
`clean_up`	int	Поддерживается только для обеспечения обратной совместимости. Значение всегда `0`равно.
`connect_timeout`	int	Поддерживается только для обеспечения обратной совместимости. Значение всегда `0`равно.
`data_timeout`	int	Поддерживается только для обеспечения обратной совместимости. Значение всегда `0`равно.
`load_os_resources`	int	Указывает, регистрируются ли и используются в этом экземпляре SQL Server средства разбиения по словам операционной системы, стволовые модули и фильтры. One of: `0` = используйте только фильтры и средства разбиения слов, относящиеся к этому экземпляру SQL Server. `1` = загрузка фильтров операционной системы и разбиений по словам. По умолчанию это свойство отключено во избежание непреднамеренных изменений, которые могут быть внесены в операционную систему при обновлении. Включение использования ресурсов операционной системы обеспечивает доступ к ресурсам для языков и типов документов, зарегистрированных в службе индексирования Майкрософт, у которых нет установленного ресурса конкретного экземпляра. Если вы включите загрузку ресурсов операционной системы, убедитесь, что ресурсы операционной системы являются доверенными подписанными двоичными файлами; в противном случае они не могут быть загружены, если `verify_signature` задано значение `1`.
`master_merge_dop`	int	Указывает количество потоков, которые будут использоваться в процессе слияния в единый документ. Это значение не должно превышать количество доступных ЦП или ядер ЦП. Если этот аргумент не указан, служба использует меньшее `4`количество процессоров или ядер ЦП.
`pause_indexing`	int	Указывает, следует ли приостанавливать полнотекстовый индексирование, если он выполняется в данный момент или возобновляется, если он приостановлен. `0` = возобновляет действия полнотекстового индексирования для экземпляра сервера. `1` = приостанавливает действия полнотекстового индексирования для экземпляра сервера.
`resource_usage`	int	Не имеет функции в SQL Server 2008 (10.0.x) и более поздних версиях и игнорируется.
`update_languages`	`NULL`	Обновляет список языков и фильтров, зарегистрированных для полнотекстового поиска. Языки указываются при настройке индексирования и полнотекстовых запросов. Filters are used by the filter daemon host to extract textual information from corresponding file formats such as `.docx` stored in data types, such as varbinary, varbinary(max), image, or xml, for full-text indexing. Дополнительные сведения см. в разделе "Просмотр или изменение зарегистрированных фильтров и разбиений слов".
`upgrade_option`	int	Определяет, как полнотекстовые индексы переносятся при обновлении базы данных с SQL Server 2005 (9.x) до более поздней версии. Это свойство применяется к обновлению, выполняемому путем присоединения базы данных, восстановления базы данных из резервной копии или восстановления файла из резервной копии, а также в случае, если база данных копируется мастером копирования баз данных. One of: - `0` = полнотекстовые каталоги перестроены с помощью новых и расширенных средств разбиения слов. Перестроение индексов может занять некоторое время, и после обновления может потребоваться значительное количество ЦП и памяти. - `1` = сбрасываются полнотекстовые каталоги. Файлы полнотекстового каталога SQL Server 2005 (9.x) удаляются, но метаданные для полнотекстовых каталогов и полнотекстовых индексов сохраняются. После обновления все полнотекстовые индексы отключены для отслеживания изменений и обходы не запускаются автоматически. После завершения обновления каталог останется пустым, пока не будет вручную запущено полное заполнение. - `2` = импортируются полнотекстовые каталоги. Как правило, импорт выполняется быстрее, чем перестроение. Например, если используется только один ЦП, то импорт выполняется в 10 раз быстрее, чем перестроение. Однако импортированный полнотекстовый каталог не использует новые и расширенные средства разбиения слов, поэтому вместо этого может потребоваться перестроить полнотекстовые каталоги. Удалены в SQL Server 2022 (16.x) и более поздних версиях и возникает ошибка. Note: Rebuild can run in multi-threaded mode, and if more than 10 CPUs are available, rebuild might run faster than import if you allow rebuild to use all of the CPUs. Если полнотекстовый каталог недоступен, связанные полнотекстовые индексы перестроены. Этот параметр доступен только для баз данных SQL Server 2005 (9.x). Сведения о выборе параметра полнотекстового обновления см. в статьеОбновление полнотекстового поиска. Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. Дополнительные сведения см. в разделе Управление и наблюдение за полнотекстовым поиском для экземпляра сервера.
`verify_signature` ¹	int	Указывает, загружает ли модуль полнотекстовых файлов только подписанные двоичные файлы. По умолчанию загружаются только доверенные, подписанные двоичные файлы. `1` = убедитесь, что загружаются только доверенные двоичные файлы, подписанные (по умолчанию). `0` = Не проверяйте, подписаны ли двоичные файлы.

¹ When verify_signature is 1, the Full-Text Engine only checks the cached Certificate Revocation List (CRL) before loading binaries. You should periodically refresh your local CRL cache with certutil, when using third party binaries.

Значения кода возврата

0 (успешно) или 1 (сбой).

Result set

None.

Совместимость с SQL Server 2022 и более поздними версиями

Функция импорта в действии (указанаupgrade_option) удаляется в @action = 'upgrade_option', @value = 2 SQL Server 2022 (16.x) и более поздних версиях. Если необходимо импортировать полнотекстовый индекс из более старой версии SQL Server, его можно импортировать с помощью SQL Server 2019 (15.x) или более ранних версий, а затем обновить до SQL Server 2022 (16.x).

Permissions

Only members of the serveradmin fixed server role or the system administrator can execute sp_fulltext_service.

Examples

A. Обновление списка зарегистрированных языков

В следующем примере обновляется список языков, зарегистрированных для полнотекстового поиска.

EXECUTE sp_fulltext_service 'update_languages';
GO

B. Изменение параметра полнотекстового обновления для сброса полнотекстовых каталогов

В следующем примере изменяется параметр полнотекстового обновления, чтобы сбросить полнотекстовые каталоги, удалив их полностью. This example specifies the optional @action and @value arguments.

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