sp_help_fulltext_tables_cursor(Transact-SQL)
적용 대상: SQL Server Azure SQL Managed Instance Analytics Platform System (PDW)
커서를 사용하여 전체 텍스트 인덱싱에 등록된 테이블 목록을 반환합니다.
Important
SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 새 sys.fulltext_indexes
카탈로그 뷰를 사용합니다. 자세한 내용은 sys.fulltext_indexes 참조하세요.
구문
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