Поделиться через


sp_help_fulltext_tables_cursor (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure Платформенная система аналитики (PDW)

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

Внимание

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_help_fulltext_tables_cursor
     [ @cursor_return = ] cursor_return OUTPUT
     [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
     [ , [ @table_name = ] N'table_name' ]
[ ; ]

Аргументы

[ @cursor_return = ] cursor_return OUTPUT

Выходная переменная курсора типа. Этот курсор является динамическим, прокручиваемым и доступным только для чтения.

[ @fulltext_catalog_name = ] N'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 = ] N'table_name'

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

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

0 (успешно) или 1 (сбой).

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

Имя столбца Тип данных Description
TABLE_OWNER sysname Владелец таблицы. Это имя пользователя базы данных, создавшего таблицу.
TABLE_NAME sysname Имя таблицы.
FULLTEXT_KEY_INDEX_NAME sysname Индекс, налагающий UNIQUE ограничение на столбец, назначенный в качестве уникального ключевого столбца.
FULLTEXT_KEY_COLID int Идентификатор столбца уникального индекса, определяемого FULLTEXT_KEY_INDEX_NAMEпо .
FULLTEXT_INDEX_ACTIVE int Указывает, можно ли использовать в запросах столбцы, помеченные для полнотекстового индексирования в этой таблице.

0 = неактивное
1 = Активно
FULLTEXT_CATALOG_NAME sysname Полнотекстовый каталог, в котором хранятся данные полнотекстового индекса.

Разрешения

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

Примеры

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

USE AdventureWorks2022;
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