FULLTEXTCATALOGPROPERTY (Transact-SQL)

Изменения: 17 июля 2006 г.

Возвращает сведения о свойствах полнотекстовых каталогов.

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

Синтаксис

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')

Аргументы

• catalog_name
  Выражение, содержащее имя полнотекстового каталога.

• property
  Выражение, содержащее имя свойства полнотекстового каталога. В таблице перечислены свойства и описания возвращаемых сведений.

  Свойство	Описание
  AccentSensitivity	Настройка учета диакритических знаков: 0 = без учета диакритических знаков; 1 = с учетом диакритических знаков.
  IndexSize	Размер полнотекстового каталога в мегабайтах (MБ).
  ItemCount	Количество полнотекстовых индексированных элементов в полнотекстовом каталоге.
  LogSize	Поддерживается только для обеспечения обратной совместимости. Всегда возвращает значение 0. Размер в байтах связанного набора журналов ошибок, связанных с полнотекстовым каталогом Microsoft Search Service.
  MergeStatus	Состояние мастера слияния: 0 = мастер слияния не работает; 1 = мастер слияния работает.
  PopulateCompletionAge	Разница в секундах между завершением последнего заполнения полнотекстового индекса и 01/01/1990 00:00:00. Обновляется только для полного и последовательного сканирования. Возвращает значение 0, если заполнение не выполнялось.
  PopulateStatus	0 = бездействие 1 = выполняется полное заполнение 2 = приостановлено 3 = ожидание истечения интервала повтора 4 = восстановление по журналу 5 = завершение работы 6 = выполняется добавочное заполнение 7 = построение индекса 8 = диск заполнен, приостановлено. 9 = отслеживание изменений
  UniqueKeyCount	Количество уникальных ключей в полнотекстовом каталоге.

Типы возвращаемых данных

int

Исключения

Возвращает значение NULL в случае ошибки или если участник не имеет разрешений для просмотра объекта.

В SQL Server 2005 пользователь может просматривать только метаданные защищаемых объектов, которыми он владеет или на которые ему были предоставлены разрешения. Это означает, что встроенные функции, создающие метаданные, такие как FULLTEXTCATALOGPROPERTY, могут вернуть значение NULL в случае, если пользователь не имеет разрешений на объект. Дополнительные сведения см. в разделах Настройка видимости метаданных и Устранение неполадок, связанных с видимостью метаданных.

Замечания

Важно, чтобы приложение не проверяло в непрерывном цикле свойство PopulateStatus до перехода в состояние бездействия (показывая, что сбор данных завершен), так как это отнимает время ЦП от обработки базы данных и выполнения полнотекстового поиска и приводит к дополнительным задержкам. В добавление к этому обычно лучший параметр для проверки соответствующего свойства PopulateStatus на уровне таблицы — свойство TableFullTextPopulateStatus в системной функции OBJECTPROPERTYEX. Это и другие полнотекстовые свойства в функции OBJECTPROPERTYEX предоставляют более подробные сведения о таблицах с полнотекстовым индексированием. Дополнительные сведения см. в разделе OBJECTPROPERTYEX (Transact-SQL).

Примеры

Следующий пример возвращает количество полнотекстовых индексированных элементов в полнотекстовом каталоге Cat_Desc.

USE AdventureWorks;
GO
SELECT fulltextcatalogproperty('Cat_Desc', 'ItemCount');
GO

См. также

Справочник

FULLTEXTSERVICEPROPERTY (Transact-SQL)
Функции метаданных (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений