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.

    upgrade_option

    int

    Управляет переносом полнотекстовых индексов при обновлении базы данных с версии SQL Server 2000 или SQL Server 2005 до SQL Server 2008 или более поздней. Это свойство применяется к обновлению, выполняемому путем присоединения базы данных, восстановления базы данных из резервной копии или восстановления файла из резервной копии, а также в случае, когда база данных копируется мастером копирования баз данных.

    Может принимать одно из следующих значений.

    0 = при перестроении полнотекстовых каталогов используются новые и улучшенные средства разбиения по словам. Перестроение индексов может занять длительное время, а после обновления может потребоваться значительный объем ресурсов ЦП и памяти.

    1 = полнотекстовые каталоги сбрасываются. Файлы полнотекстовых каталогов SQL Server 2005 удаляются, но метаданные полнотекстовых каталогов и полнотекстовых индексов сохраняются. После обновления для всех полнотекстовых индексов отключается отслеживание изменений и сканирование не запускается автоматически. После завершения обновления каталог останется пустым, пока не будет вручную запущено полное заполнение.

    2 = полнотекстовые каталоги импортируются. Обычно импорт производится значительно быстрее перестроения. Например, если используется только один ЦП, то импорт выполняется в 10 раз быстрее, чем перестроение. Однако в импортированных полнотекстовых каталогах не используются новые улучшенные средства разбиения по словам, добавленные в SQL Server 2008, поэтому со временем рекомендуется произвести перестроение полнотекстовых каталогов.

    ПримечаниеПримечание
    Перестроение может выполняться в многопоточном режиме; если доступно более 10 ЦП, то перестроение может выполниться быстрее импорта, если ему будет разрешено использовать все ЦП.

    Если полнотекстовый каталог недоступен, связанные полнотекстовые индексы перестраиваются. Этот параметр доступен только для баз данных SQL Server 2005.

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

    ПримечаниеПримечание
    Чтобы задать это свойство в среде Среда SQL Server Management Studio, используйте свойство Режим обновления полнотекстовых данных. Дополнительные сведения см. в разделе Как просмотреть или изменить свойства сервера для полнотекстового поиска (среда SQL Server Management Studio).

    load_os_resources

    int

    Указывает, зарегистрированы ли средства разбиения по словам, парадигматические модули и фильтры операционной системы и используются ли они с этим экземпляром SQL Server. Может иметь одно из следующих значений.

    0 = использовать только фильтры и средства разбиения по словам, характерные для этого экземпляра SQL Server.

    1 = загрузить фильтры и средства разбиения по словам из операционной системы.

    По умолчанию это свойство отключено во избежание непреднамеренных изменений, которые могут быть внесены в операционную систему при обновлении. Применение ресурсов операционной системы обеспечивает доступ к ресурсам для языков и типов документов, зарегистрированных в службе индексирования Майкрософт, а также для которых не установлены ресурсы, относящиеся к экземпляру. Если разрешена загрузка ресурсов операционной системы, то убедитесь, что эти ресурсы являются достоверными подписанными двоичными файлами, иначе их нельзя будет загрузить, когда для параметра verify_signature (см. ниже) будет задано значение 1.

    pause_indexing

    int

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

    0 = продолжить полнотекстовое индексирование для экземпляра сервера.

    1 = приостановить полнотекстовое индексирование для экземпляра сервера.

    resource_usage

    int

    Не имеет функции в SQL Server 2008 и более поздних версиях, поэтому не обрабатывается.

    update_languages

    NULL

    Обновляет список языков и фильтров, зарегистрированных для полнотекстового поиска. Языки указываются при настройке индексирования и полнотекстовых запросов. Фильтры используются управляющей программой фильтрации при полнотекстовом индексировании для извлечения текстовых сведений из соответствующих форматов файлов, таких как DOCX, хранящихся в типах данных varbinary, varbinary(max), image и xml.

    Дополнительные сведения см. в разделе Как изменить список зарегистрированных средств разбиения по словам и фильтров (Transact-SQL).

    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