sp_help_fulltext_catalogs_cursor (Transact-SQL)

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

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

Внимание

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

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

Синтаксис

sp_help_fulltext_catalogs_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
[ ; ]

Аргументы

[ @cursor_return = ] cursor_return OUTPUT

@cursor_return — это параметр OUTPUT типа int. Курсор — это только для чтения, прокручиваемый, динамический курсор.

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

Имя полнотекстового каталога. @fulltext_catalog_name — sysname с значением по умолчаниюNULL. Если этот параметр опущен или является NULL, возвращается информация обо всех полнотекстовых каталогах, связанных с текущей базой данных.

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

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

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

Имя столбца Тип данных Description
fulltext_catalog_id smallint Идентификатор полнотекстового каталога.
NAME sysname Имя полнотекстового каталога.
PATH nvarchar(260) Это предложение не действует.
STATUS int Состояние заполнения полнотекстового индекса каталога:

0 = бездействия
1 = полное заполнение
2 = приостановлено
3 = регулирование
4 = восстановление
5 = завершение работы
6 = добавочное население в процессе выполнения
7 = создание индекса
8 = диск заполнен. Приостановлен
9 = отслеживание изменений
NUMBER_FULLTEXT_TABLES int Число полнотекстовых индексированных таблиц, связанных с каталогом.

Разрешения

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

Примеры

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

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