sp_fulltext_service (Transact-SQL)

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

Синтаксические обозначения Transact-SQL

Синтаксис

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

Аргументы

• [ @action=] 'action'
  Это свойство для изменения или сброса. Аргумент action имеет тип nvarchar(100), не имеет значения по умолчанию. Список свойств действий, их описания, а также их возможные значения см. в таблице в разделе, посвященном аргументу value. Этот аргумент возвращает следующие свойства: тип данных, текущее значение выполнения, минимальное или максимальное значение, а также состояние устаревания, если оно применимо.

• [ @value=] value
  Значение указанного свойства. Аргумент value имеет тип sql_variant и значение по умолчанию NULL. Если значение аргумента @value равно NULL, то процедура sp_fulltext_service возвращает текущий параметр. В этой таблице перечислены свойства действий, их описания, а также возможные значения.

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

  Действие	Тип данных	Описание
  clean_up	int	Поддерживается только для обеспечения обратной совместимости. Значение всегда равно 0.
  connect_timeout	int	Поддерживается только для обеспечения обратной совместимости. Значение всегда равно 0.
  data_timeout	int	Поддерживается только для обеспечения обратной совместимости. Значение всегда равно 0.
  load_os_resources	int	Указывает, зарегистрированы ли средства разбиения по словам, парадигматические модули и фильтры операционной системы и используются ли они с этим экземпляром SQL Server. Может иметь одно из следующих значений. 0 = использовать только фильтры и средства разбиения по словам, характерные для этого экземпляра SQL Server. 1 = загрузить фильтры и средства разбиения по словам из операционной системы. По умолчанию это свойство отключено во избежание непреднамеренных изменений, которые могут быть внесены в операционную систему при обновлении. Применение ресурсов операционной системы обеспечивает доступ к ресурсам для языков и типов документов, зарегистрированных в службе индексирования Microsoft, а также для которых не установлены ресурсы, относящиеся к экземпляру. Если разрешена загрузка ресурсов операционной системы, то убедитесь, что эти ресурсы являются достоверными подписанными двоичными файлами, иначе их нельзя будет загрузить, когда для параметра verify_signature (см. ниже) будет задано значение 1.
  master_merge_dop	int	Указывает количество потоков, которые будут использоваться в процессе слияния в единый документ. Это значение не должно превышать количество доступных процессоров или ядер ЦП. Если данный аргумент не был указан, то служба будет использовать либо меньше четырех процессоров или ядер ЦП, либо только доступные процессоры или ядра ЦП.
  pause_indexing	int	Указывает необходимость приостановки полнотекстового индексирования, если оно запущено, или возобновления, если оно приостановлено. 0 = продолжить полнотекстовое индексирование для экземпляра сервера. 1 = приостановить полнотекстовое индексирование для экземпляра сервера.
  resource_usage	int	Не имеет функции в SQL Server 2008 и более поздних версиях, поэтому не обрабатывается.
  update_languages	NULL	Обновляет список языков и фильтров, зарегистрированных для полнотекстового поиска. Языки указываются при настройке индексирования и полнотекстовых запросов. Фильтры используются управляющей программой фильтрации при полнотекстовом индексировании для извлечения текстовых сведений из соответствующих форматов файлов, таких как DOCX, хранящихся в типах данных varbinary, varbinary(max), image и xml. Дополнительные сведения см. в разделе Просмотр или изменение зарегистрированных фильтры и разделители слов.
  upgrade_option	int	Управляет переносом полнотекстовых индексов при обновлении базы данных с версии SQL Server 2005 до SQL Server 2008 или более поздней. Это свойство применяется к обновлению, выполняемому путем присоединения базы данных, восстановления базы данных из резервной копии или восстановления файла из резервной копии, а также в случае, если база данных копируется мастером копирования баз данных. Может принимать одно из следующих значений. 0 = при перестроении полнотекстовых каталогов используются новые и улучшенные средства разбиения по словам. Перестроение индексов может занять длительное время, а после обновления может потребоваться значительный объем ресурсов ЦП и памяти. 1 = полнотекстовые каталоги сбрасываются. Полнотекстовые файлы каталога SQL Server 2005 удалены, но метаданные для полнотекстовых каталогов и полнотекстовых индексов сохранены. После обновления для всех полнотекстовых индексов отключается отслеживание изменений и сканирование не запускается автоматически. После завершения обновления каталог останется пустым, пока не будет вручную запущено полное заполнение. 2 = полнотекстовые каталоги импортируются. Обычно импорт производится значительно быстрее перестроения. Например, если используется только один процессор, то импорт выполняется в 10 раз быстрее, чем перестроение. Однако в импортированных полнотекстовых каталогах не используются новые улучшенные средства разбиения по словам, добавленные в SQL Server 2008, поэтому со временем рекомендуется произвести перестроение полнотекстовых каталогов. Примечание Перестроение может выполняться в многопоточном режиме; если доступно более 10 процессоров, то перестроение может выполниться быстрее импорта, если будет разрешено использовать все процессоры. Если полнотекстовый каталог недоступен, связанные полнотекстовые индексы перестраиваются. Этот параметр доступен только для баз данных SQL Server 2005. Сведения о выборе параметра полнотекстового обновления см. в разделе Обновление полнотекстового поиска из SQL Server 2005. Примечание Чтобы задать это свойство в среде Среда SQL Server Management Studio, используйте свойство Режим обновления полнотекстовых данных. Дополнительные сведения см. в разделе Управление и наблюдение за полнотекстовым поиском для экземпляра сервера.
  verify_signature	int	Указывает допустимость загрузки в средство полнотекстового поиска только подписанных двоичных файлов. По умолчанию загружаются только достоверные подписанные двоичные файлы. 1 = производится проверка того, что загружаются только достоверные подписанные двоичные файлы (по умолчанию). 0 = не проверять наличие подписи у двоичных файлов.

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

0(успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет

Разрешения

Только элементы предопределенной роли сервера serveradmin или системный администратор могут запускать процедуру sp_fulltext_service.

Примеры

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

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

EXEC sp_fulltext_service 'update_languages';
GO

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

В следующем примере демонстрируется изменение параметров полнотекстового обновления для сброса полнотекстовых каталогов. Это приводит к их полному удалению. В данном примере задаются два дополнительных ключевых слова: @action и @value.

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

См. также

Справочник

FULLTEXTSERVICEPROPERTY (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)

Основные понятия

Компонент Full-Text Search (SQL Server)