다음을 통해 공유


sp_help_fulltext_columns_cursor(Transact-SQL)

적용 대상:SQL Server

커서를 사용하여 전체 텍스트 인덱싱에 지정된 열을 반환합니다.

Important

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

Transact-SQL 구문 표기 규칙

구문

sp_help_fulltext_columns_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @table_name = ] N'table_name' ]
    [ , [ @column_name = ] N'column_name' ]
[ ; ]

인수

[ @cursor_return = ] cursor_return OUTPUT

@cursor_return int 형식의 OUTPUT 매개 변수입니다. 결과 커서는 읽기 전용이고 스크롤 가능한 동적 커서입니다.

[ @table_name = ] N'table_name'

전체 텍스트 인덱스 정보가 요청되는 한 부분 또는 두 부분으로 구성된 테이블 이름입니다. @table_name 기본값NULL인 nvarchar(517)입니다.

@table_name 생략하면 전체 텍스트 인덱싱된 모든 테이블에 대해 전체 텍스트 인덱스 열 정보가 검색됩니다.

[ @column_name = ] N'column_name'

전체 텍스트 인덱스 메타데이터가 필요한 열의 이름입니다. @column_name sysname이며 기본값은 .입니다NULL. @column_name 생략되었거나 NULL생략된 경우 @table_name 전체 텍스트 인덱싱된 모든 열에 대해 전체 텍스트 열 정보가 반환됩니다.

@table_name 생략되었거나 NULL생략된 경우 데이터베이스의 모든 테이블에 대해 전체 텍스트 인덱싱된 모든 열에 대해 전체 텍스트 인덱스 열 정보가 반환됩니다.

반환 코드 값

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

결과 집합

열 이름 데이터 형식 설명
TABLE_OWNER sysname 테이블 소유자입니다. 소유자는 테이블을 만든 데이터베이스 사용자의 이름입니다.
TABLE_ID int 테이블 ID입니다.
TABLE_NAME sysname 테이블 이름입니다.
FULLTEXT_COLUMN_NAME sysname 인덱싱을 위해 지정된 전체 텍스트 인덱싱 테이블의 열입니다.
FULLTEXT_COLID int 전체 텍스트 인덱싱된 열의 열 ID입니다.
FULLTEXT_BLOBTP_COLNAME sysname 전체 텍스트 인덱싱된 열의 문서 형식을 지정하는 전체 텍스트 인덱싱된 테이블의 열입니다. 이 값은 전체 텍스트 인덱싱된 열이 varbinary(max) 또는 이미지 열인 경우에만 적용됩니다.
FULLTEXT_BLOBTP_COLID int 문서 형식 열의 열 ID입니다. 이 값은 전체 텍스트 인덱싱된 열이 varbinary(max) 또는 이미지 열인 경우에만 적용됩니다.
FULLTEXT_LANGUAGE sysname 열의 전체 텍스트 검색에 사용되는 언어입니다.

사용 권한

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

예제

다음 예제에서는 데이터베이스의 모든 테이블에서 전체 텍스트 인덱싱을 위해 지정된 열에 대한 정보를 반환합니다.

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