다음을 통해 공유

  • 아티클

sp_help_fulltext_system_components(Transact-SQL)

등록된 단어 분리기, 필터 및 프로토콜 처리기에 대한 정보를 반환합니다. 또한 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= ] param
    구성 요소 유형에 따라 LCID(로캘 ID), "." 접두사가 있는 파일 확장명, 프로토콜 처리기의 전체 구성 요소 이름 또는 구성 요소 DLL의 전체 경로 중 하나일 수 있습니다.

반환 코드 값

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

결과 집합

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

열 이름

데이터 형식

설명

componenttype

sysname

구성 요소 유형입니다. 다음 중 하나일 수 있습니다.

  • 필터

  • 프로토콜 처리기

  • 단어 분리기

componentname

sysname

구성 요소 이름입니다.

clsid

uniqueidentifier

구성 요소의 클래스 식별자입니다.

fullpath

nvarchar(256)

구성 요소 위치에 대한 경로입니다.

NULL = 호출자가 serveradmin 고정 서버 역할의 멤버가 아닙니다.

버전

nvarchar(30)

구성 요소 버전입니다.

manufacturer

sysname

구성 요소 제조업체의 이름입니다.

다음 결과 집합은 component_type을 사용하는 전체 텍스트 카탈로그가 이미 하나 이상 있을 경우에만 반환됩니다.

열 이름

데이터 형식

설명

dbid

int

데이터베이스의 ID입니다.

ftcatid

int

전체 텍스트 카탈로그의 ID입니다.

사용 권한

public 역할의 멤버 자격이 필요합니다. 그러나 사용자는 VIEW DEFINITION 권한이 있는 전체 텍스트 카탈로그에 대한 정보만 볼 수 있습니다. serveradmin 고정 서버 역할의 멤버만 fullpath 열의 값을 볼 수 있습니다.

주의

이 메서드는 업그레이드를 준비할 때 특히 중요합니다. 특정 데이터베이스 내에서 저장 프로시저를 실행하고, 출력을 사용하여 특정 카탈로그가 업그레이드에 영향을 받는지 여부를 지정합니다.

예

1. 모든 전체 텍스트 시스템 구성 요소 나열

다음 예에서는 서버 인스턴스에 등록된 모든 전체 텍스트 시스템 구성 요소를 나열합니다.

EXEC sp_help_fulltext_system_components 'all';
GO

2. 단어 분리기 나열

다음 예에서는 서비스 인스턴스에 등록된 모든 단어 분리기를 나열합니다.

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

3. 특정 단어 분리기의 등록 여부 확인

다음 예에서는 시스템에 설치되어 있으며 서비스 인스턴스에 등록되어 있는 터키어(LCID=1055)용 단어 분리기를 나열합니다. 이 예에서는 매개 변수 이름 @component_type 및 @param을 지정합니다.

EXEC sp_help_fulltext_system_components @component_type = 'wordbreaker', @param = 1055;
GO

기본적으로 이 단어 분리기는 설치되지 않으므로 결과 집합이 비어 있습니다.

4. 특정 필터의 등록 여부 확인

다음 예에서는 수동으로 시스템에 설치되어 있으며 서버 인스턴스에 등록되어 있는 .xdoc 구성 요소에 대한 필터를 나열합니다.

EXEC sp_help_fulltext_system_components 'filter', '.xdoc';
GO

기본적으로 이 필터는 설치되지 않으므로 결과 집합이 비어 있습니다.

5. 특정 .dll 파일 나열

다음 예에서는 기본적으로 설치되는 특정 .ddl 파일 nlhtml.dll을 나열합니다.

EXEC sp_help_fulltext_system_components 'fullpath', 
   'C:\Program Files\Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\Binn\nlhtml.dll';
GO

변경 내역

업데이트된 내용

구문을 수정했습니다.

"예" 섹션을 확장했습니다.