• Статья

sp_help_fulltext_system_components (Transact-SQL)

Возвращает сведения о зарегистрированных фильтрах, разделителях слов и обработчиках протоколов. Процедура sp_help_fulltext_system_components также возвращает список идентификаторов баз данных и полнотекстовых каталогов, использовавших указанный компонент.

Значок ссылки на разделСоглашение о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

  • 'all'
    Возвращает сведения для всех полнотекстовых компонентов.

  • [ @component_type= ] component_type
    Указывает тип компонента. Параметр component_type может иметь одно из следующих значений:

    • wordbreaker

    • filter

    • protocol handler

    • fullpath

    Если указан полный путь, необходимо также указать для параметра аргумента param полный путь к библиотеке компонента. В противном случае будет возвращено сообщение об ошибке.

    ПримечаниеПримечание

    Дополнительные сведения о компонентах полнотекстового поиска см. в разделах Архитектура компонента Full-Text Search и Настройка полнотекстовых лингвистических компонентов.

  • [ @param= ] param
    В зависимости от типа компонента указывается одно из следующих значений: идентификатор языкового стандарта (LCID), расширение файла с префиксом «.», полное имя компонента обработчика протокола или полный путь к DLL-компоненту.

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

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

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

Следующий результирующий набор возвращается для системных компонентов.

Имя столбца

Тип данных

Описание

componenttype

sysname

Тип компонента. Одно из следующих значений:

  • фильтр

  • обработчик протокола

  • разделитель слов

componentname

sysname

Имя компонента.

clsid

uniqueidentifier

Идентификатор класса компонента.

fullpath

nvarchar(256)

Путь к расположению компонента.

NULL = вызывающая сторона не является членом предопределенной роли сервера serveradmin.

version

nvarchar(30)

Версия компонента.

manufacturer

sysname

Имя производителя компонента.

Следующий результирующий набор возвращается только в случае, если один или более их существующих полнотекстовых каталогов использует тип component_type.

Имя столбца

Тип данных

Описание

dbid

int

Идентификатор базы данных.

ftcatid

int

Идентификатор полнотекстового каталога.

Разрешения

Требуется членство в роли public; однако пользователи могут просматривать сведения только о тех полнотекстовых каталогах, для которых у них есть разрешение VIEW DEFINITION. Значения столбца fullpath могут просматривать только члены предопределенной роли сервера serveradmin.

Замечания

Этот метод очень важен при подготовке к обновлению. Запустите хранимую процедуру в определенной базе данных и используйте результаты, чтобы определить, будет ли определенный каталог затронут обновлением.

Примеры

А. Список всех полнотекстовых системных компонентов

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

EXEC sp_help_fulltext_system_components 'all';
GO

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

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

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

В. Как выяснить, зарегистрировано ли определенное средство разбиения по словам

В следующем примере будет выведено средство разбиения по словам для турецкого языка (LCID = 1055), если оно установлено в системе и зарегистрировано в экземпляре сервера. В этом примере задаются имена параметров: @component_type и @param.

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

По умолчанию средство разбиения по словам не установлено, поэтому результирующий набор будет пустым.

Г. Как определить, зарегистрирован ли тот или иной фильтр

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

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

По умолчанию этот фильтр не устанавливается, поэтому результирующий набор будет пустым.

Д. Листинг конкретного DLL-файла

В следующем примере выводится конкретный DDL-файл nlhtml.dll, установленный по умолчанию.

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