다음을 통해 공유


sp_help_fulltext_catalogs_cursor(Transact-SQL)

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance

커서를 사용하여 지정된 전체 텍스트 카탈로그의 ID, 이름, 루트 디렉터리, 상태 및 전체 텍스트 인덱싱된 테이블 수를 반환합니다.

Important

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 int 형식의 OUTPUT 매개 변수입니다. 커서는 읽기 전용이고 스크롤 가능하며 동적 커서입니다.

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

전체 텍스트 카탈로그의 이름입니다. @fulltext_catalog_name sysname이며 기본값은 .입니다NULL. 이 매개 변수를 생략하거나 이 매개 변수인 NULL경우 현재 데이터베이스와 연결된 모든 전체 텍스트 카탈로그에 대한 정보가 반환됩니다.

반환 코드 값

0(성공) 또는 1(실패).

결과 집합

열 이름 데이터 형식 설명
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 카탈로그와 연결된 전체 텍스트 인덱싱된 테이블의 번호입니다.

사용 권한

실행 권한은 기본적으로 공용 역할로 설정됩니다.

예제

다음 예제에서는 전체 텍스트 카탈로그에 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