다음을 통해 공유

sp_help_fulltext_tables_cursor(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL Managed InstanceAnalytics Platform System(PDW)

커서를 사용하여 전체 텍스트 인덱싱에 등록된 테이블 목록을 반환합니다.

Important

SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 새 sys.fulltext_indexes 카탈로그 뷰를 사용합니다. 자세한 내용은 sys.fulltext_indexes(Transact-SQL)를 참조하세요.

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 기본값NULL인 nvarchar(517)입니다. @table_name만 지정하면 @table_name 관련된 행만 반환됩니다.

반환 코드 값

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

결과 집합

열 이름 데이터 형식 설명
TABLE_OWNER sysname 테이블 소유자입니다. 테이블을 만든 데이터베이스 사용자의 이름입니다.
TABLE_NAME sysname 테이블 이름입니다.
FULLTEXT_KEY_INDEX_NAME sysname 고유 키 열로 지정된 열에 제약 조건을 적용 UNIQUE 하는 인덱스입니다.
FULLTEXT_KEY_COLID int 로 식별되는 고유 인덱스의 열 ID입니다 FULLTEXT_KEY_INDEX_NAME.
FULLTEXT_INDEX_ACTIVE int 해당 테이블의 전체 텍스트 인덱싱에 대해 표시된 열이 쿼리에 적합한지 여부를 지정합니다.

0 = 비활성
1 = 활성
FULLTEXT_CATALOG_NAME sysname 전체 텍스트 인덱스 데이터가 있는 전체 텍스트 카탈로그입니다.

사용 권한

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

예제

다음 예제에서는 전체 텍스트 카탈로그와 연결된 전체 텍스트 인덱싱된 테이블의 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

관련 콘텐츠