Share via

  • Статья

sp_help_fulltext_tables_cursor (Transact-SQL)

Использует курсор для возврата списка таблиц, которые зарегистрированы для полнотекстового индексирования.

Важное примечаниеВажно!

В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Используйте вместо этого новое представление каталога sys.fulltext_indexes. Дополнительные сведения см. в разделе sys.fulltext_indexes (Transact-SQL).

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_help_fulltext_tables_cursor [ @cursor_return = ] @cursor_variable OUTPUT 
     [ , [ @fulltext_catalog_name = ] 'fulltext_catalog_name' ] 
     [ , [ @table_name = ] 'table_name' ]

Аргументы

  • [ @cursor_return= ] @cursor_variable OUTPUT
    Выходная переменная типа cursor. Этот курсор является динамическим, прокручиваемым и доступным только для чтения.

  • [ @fulltext_catalog_name= ] 'fulltext_catalog_name'
    Имя полнотекстового каталога. Аргумент fulltext_catalog_name имеет тип sysname и значение по умолчанию NULL. Если аргумент fulltext_catalog_name опущен или имеет значение NULL, то возвращаются все таблицы с полнотекстовым индексом, связанные с базой данных. Если аргумент fulltext_catalog_name указан, а аргумент table_name опущен или имеет значение NULL, данные полнотекстового индекса извлекаются для каждой таблицы с полнотекстовым индексом, связанной с этим каталогом. При указании обоих аргументов, fulltext_catalog_name и table_name, возвращение строки осуществляется при условии, что аргумент table_name связан с аргументом fulltext_catalog_name, в противном случае возникает ошибка.

  • [ @table_name=] 'table_name'
    Имя таблицы, состоящей из одной или двух частей, для которой запрашиваются полнотекстовые метаданные. Аргумент table_name имеет тип nvarchar(517) и значение по умолчанию NULL. Если указан только аргумент table_name, возвращается только строка, соответствующая аргументу table_name.

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

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

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

Имя столбца

Тип данных

Описание

TABLE_OWNER

sysname

Владелец таблицы. Имя пользователя базы данных, создавшего таблицу.

TABLE_NAME

sysname

Имя таблицы.

FULLTEXT_KEY_INDEX_NAME

sysname

Индекс, налагающий ограничение UNIQUE на столбец, помеченный как уникальный ключевой столбец.

FULLTEXT_KEY_COLID

int

Идентификатор столбца уникального индекса, задаваемого параметром FULLTEXT_KEY_NAME.

FULLTEXT_INDEX_ACTIVE

int

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

0 = неактивно.

1= активно.

FULLTEXT_CATALOG_NAME

sysname

Полнотекстовый каталог, в котором хранятся данные полнотекстового индекса.

Разрешения

По умолчанию разрешения на выполнение предоставлены членам роли public.

Примеры

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

USE AdventureWorks2008R2;
GO
DECLARE @mycursor CURSOR;
EXEC sp_help_fulltext_tables_cursor @mycursor OUTPUT, 'Cat_Desc';
FETCH NEXT FROM @mycursor;
WHILE (@@FETCH_STATUS <> -1)
   BEGIN
      FETCH NEXT FROM @mycursor;
   END;
CLOSE @mycursor;
DEALLOCATE @mycursor;
GO