sp_help_fulltext_system_components(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure Synapse Analytics

등록된 단어 분리기, 필터 및 프로토콜 처리기에 대한 정보를 반환합니다. sp_help_fulltext_system_components 또한 지정된 구성 요소를 사용한 데이터베이스 및 전체 텍스트 카탈로그의 식별자 목록을 반환합니다.

Transact-SQL 구문 표기 규칙

구문

sp_help_fulltext_system_components
    { 'all' | [ @component_type = ] 'component_type' }
    , [ @param = ] 'param'

인수

'all'

모든 전체 텍스트 구성 요소에 대한 정보를 반환합니다.

[ @component_type = ] 'component_type'

구성 요소 유형을 지정합니다. component_type 다음 옵션 중 하나일 수 있습니다.

  • wordbreaker
  • filter
  • protocol handler
  • fullpath

전체 경로를 지정 하는 경우 구성 요소 DLL의 전체 경로로 매개 변수 를 지정해야 합니다. 그렇지 않으면 오류 메시지가 반환됩니다.

[ @param = ] 'param'

구성 요소 유형 에 따라 매개 변수 는 다음 옵션 중 하나입니다.

  • 로캘 식별자(LCID)
  • "." 접두사를 가진 파일 확장명입니다.
  • 프로토콜 처리기의 전체 구성 요소 이름
  • 구성 요소 DLL의 전체 경로

반환 코드 값

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

결과 집합

시스템 구성 요소에 대해 다음 결과 집합이 반환됩니다.

열 이름 데이터 형식 설명
componenttype sysname 구성 요소의 유형입니다. 다음 옵션 중 하나입니다.

-필터
- 프로토콜 처리기
- 단어 분리기
componentname sysname 구성 요소의 이름
clsid uniqueidentifier 구성 요소의 클래스 식별자
Fullpath nvarchar(256) 구성 요소의 위치에 대한 경로입니다.

NULL = serveradmin 고정 서버 역할의 멤버가 아닌 호출자
version nvarchar(30) 구성 요소의 버전
제조업체 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

관련 콘텐츠