sp_help_fulltext_system_components(Transact-SQL)
적용 대상:
SQL Server Azure Synapse Analytics
등록된 단어 분리기, 필터 및 프로토콜 처리기에 대한 정보를 반환합니다. sp_help_fulltext_system_components 또한 지정된 구성 요소를 사용하는 데이터베이스 및 전체 텍스트 카탈로그의 식별자 목록을 반환합니다.
구문
sp_help_fulltext_system_components
[ { 'all' | [ @component_type = ] N'component_type' } ]
[ , [ @param = ] N'param' ]
[ ; ]
인수
'all'
모든 전체 텍스트 구성 요소에 대한 정보를 반환합니다.
[ @component_type = ] N'component_type'
구성 요소 유형을 지정합니다. @component_type sysname이며 다음 옵션 중 하나일 수 있습니다.
wordbreakerfilterprotocol handlerfullpath
전체 경로를 지정 하는 경우 구성 요소 DLL의 전체 경로를 사용하여 @param 지정해야 합니다. 그렇지 않으면 오류 메시지가 반환됩니다.
[ @param = ] N'param'
@param sysname이며 기본값은 .입니다NULL. 구성 요소 유형 에 따라 @param 다음 옵션 중 하나입니다.
- 로캘 식별자(LCID)
- 접두사를 가진
.파일 확장명입니다. - 프로토콜 처리기의 전체 구성 요소 이름
- 구성 요소 DLL의 전체 경로
반환 코드 값
0(성공) 또는 1(실패).
결과 집합
시스템 구성 요소에 대해 다음 결과 집합이 반환됩니다.
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
componenttype |
sysname | 구성 요소의 유형입니다. 다음 옵션 중 하나입니다. -필터 - 프로토콜 처리기 - 단어 분리기 |
componentname |
sysname | 구성 요소의 이름 |
clsid |
uniqueidentifier | 구성 요소의 클래스 식별자 |
fullpath |
nvarchar(256) | 구성 요소의 위치에 대한 경로입니다. NULL = serveradmin 고정 서버 역할의 멤버가 아닌 호출자 |
version |
nvarchar(30) | 구성 요소의 버전 |
manufacturer |
sysname | 구성 요소 제조업체의 이름 |
다음 결과 집합은 @component_type 사용하는 하나 이상의 전체 텍스트 카탈로그가 있는 경우에만 반환됩니다.
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
dbid |
int | 데이터베이스의 ID |
ftcatid |
int | 전체 텍스트 카탈로그의 ID |
사용 권한
공용 역할의 멤버 자격이 필요하지만 사용자는 VIEW DEFINITION 권한이 있는 전체 텍스트 카탈로그에 대한 정보만 볼 수 있습니다. serveradmin 고정 서버 역할의 멤버만 열의 fullpath 값을 볼 수 있습니다.
설명
이 방법은 업그레이드를 준비할 때 특히 중요합니다. 특정 데이터베이스 내에서 저장 프로시저를 실행하고 출력을 사용하여 특정 카탈로그가 업그레이드의 영향을 받는지 여부를 확인합니다.
예제
A. 모든 전체 텍스트 시스템 구성 요소 나열
다음 예제에서는 서버 인스턴스에 등록된 모든 전체 텍스트 시스템 구성 요소를 나열합니다.
EXEC sp_help_fulltext_system_components 'all';
GO
B. 단어 분리기 나열
다음 예제에서는 서비스 인스턴스에 등록된 모든 단어 분리기를 나열합니다.
EXEC sp_help_fulltext_system_components 'wordbreaker';
GO
C. 특정 단어 분리기가 등록되어 있는지 확인
다음 예제에서는 터키어(LCID = 1055)가 시스템에 설치되고 서비스 인스턴스에 등록된 경우 단어 분리기를 나열합니다. 이 예제에서는 매개 변수 이름, @component_type 및 @param 지정합니다.
EXEC sp_help_fulltext_system_components @component_type = 'wordbreaker', @param = 1055;
GO
기본적으로 이 단어 분리기는 설치되지 않으므로 결과 집합은 비어 있습니다.
D. 특정 필터가 등록되어 있는지 확인
다음 예제에서는 구성 요소가 시스템에 수동으로 설치되고 서버 인스턴스에 등록된 경우 구성 요소에 대한 필터 .xdoc 를 나열합니다.
EXEC sp_help_fulltext_system_components 'filter', '.xdoc';
GO
기본적으로 이 필터는 설치되지 않으므로 결과 집합은 비어 있습니다.
E. 특정 DLL 파일 나열
다음 예제에서는 기본적으로 설치되는 특정 .ddl 파일을 nlhtml.dll나열합니다.
EXEC sp_help_fulltext_system_components 'fullpath',
'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Binn\nlhtml.dll';
GO