sp_fulltext_service(Transact-SQL)

  • 아티클

적용 대상:SQL Server

SQL Server에 대한 전체 텍스트 검색의 서버 속성을 변경합니다.

Transact-SQL 구문 표기 규칙

구문

sp_fulltext_service
    [ [ @action = ] N'action' ]
    [ , [ @value = ] value ]
[ ; ]

인수

[ @action = ] N'action'

변경하거나 다시 설정할 속성입니다. @action nvarchar(100)이며 기본값은 없습니다. @action 속성 목록, 해당 설명 및 설정할 수 있는 값은 @value 인수 아래의 테이블을 참조하세요.

이 인수는 다음 속성을 반환합니다.

  • 데이터 형식
  • 현재 실행 중인 값
  • 최소값 또는 최대값
  • 해당되는 경우 사용 중단 상태.

[ @value = ] value

@value 기본값NULL인 sql_variant.

지정된 속성의 값입니다. @value 기본값이 NULL인 sql_variant. @value null sp_fulltext_service 이면 현재 설정을 반환합니다. 이 표에서는 동작 속성, 설명 및 설정할 수 있는 값 목록을 보여 줍니다.

참고 항목

이후 SQL Server 릴리스에서는 클린_up, connect_timeout, data_timeout 및 resource_usage 제거될 예정입니다. 새 개발 작업에서 이러한 작업을 사용하지 말고 현재 해당 작업을 사용하는 애플리케이션을 수정할 계획입니다.

작업 데이터 형식 설명
클린_up int 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다.
connect_timeout int 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다.
data_timeout int 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다.
load_os_resources int 운영 체제 단어 분리기, 형태소 분석기 및 필터가 이 SQL Server 인스턴스에 등록되고 사용되는지 여부를 나타냅니다. 다음 중 하나입니다.

0 = 이 SQL Server 인스턴스와 연관된 필터와 단어 분리기만 사용합니다.

1 = 운영 체제 필터 및 단어 분리기를 로드합니다.

기본적으로 이 속성은 운영 체제에 대한 업데이트로 인한 실수로 인한 동작 변경을 방지하기 위해 사용하지 않도록 설정됩니다. 운영 체제 리소스를 사용하도록 설정하면 인스턴스별 리소스가 설치되지 않은 Microsoft Indexing Service에 등록된 언어 및 문서 유형에 대한 리소스에 액세스할 수 있습니다. 운영 체제 리소스의 로드를 사용하도록 설정하는 경우 운영 체제 리소스가 신뢰할 수 있는 서명된 이진 파일인지 확인합니다. 그렇지 않으면 verify_signature 1로 설정된 경우 로드할 수 없습니다.
master_merge_dop int 마스터 병합 프로세스에서 사용할 스레드 수를 지정합니다. 이 값은 사용 가능한 CPU 또는 CPU 코어 수를 초과하면 안 됩니다.

이 인수를 지정하지 않으면 서비스에서 4보다 작거나 사용 가능한 CPU 또는 CPU 코어 수를 사용합니다.
pause_indexing int 전체 텍스트 인덱싱을 일시 중지할지, 현재 실행 중인지 또는 현재 일시 중지된 경우 다시 시작해야 하는지를 지정합니다.

0 = 서버 인스턴스에 대한 전체 텍스트 인덱싱 작업을 다시 시작합니다.

1 = 서버 인스턴스에 대한 전체 텍스트 인덱싱 작업을 일시 중지합니다.
resource_usage int SQL Server 2008(10.0.x) 이상 버전에는 함수가 없으며 무시됩니다.
update_languages NULL 전체 텍스트 검색에 등록된 언어 및 필터 목록을 업데이트. 언어는 인덱싱 및 전체 텍스트 쿼리를 구성할 때 지정됩니다. 필터는 필터 디먼 호스트에서 전체 텍스트 인덱싱을 위해 varbinary, varbinary(max), image 또는 xml과 같은 데이터 형식에 저장된 .docx 같은 해당 파일 형식에서 텍스트 정보를 추출하는 데 사용됩니다.

자세한 내용은 등록된 필터 및 단어 분리기 보기 또는 변경 내용을 참조 하세요.
upgrade_option int SQL Server 2005(9.x)에서 이후 버전으로 데이터베이스를 업그레이드할 때 전체 텍스트 인덱스가 마이그레이션되는 방법을 제어합니다. 이 속성은 데이터베이스 복사 마법사를 사용하여 데이터베이스를 연결하거나, 데이터베이스 백업 및 파일 백업을 복원하거나, 데이터베이스를 복사하여 업그레이드에 적용됩니다.

다음 중 하나입니다.

0 = 새 단어 분리기를 사용하여 전체 텍스트 카탈로그를 다시 작성합니다. 인덱스를 다시 빌드하는 데 다소 시간이 걸릴 수 있으며 업그레이드 후에 상당한 양의 CPU 및 메모리가 필요할 수 있습니다.

1 = 전체 텍스트 카탈로그가 다시 설정됩니다. SQL Server 2005(9.x) 전체 텍스트 카탈로그 파일이 제거되지만 전체 텍스트 카탈로그 및 전체 텍스트 인덱스의 메타데이터는 유지됩니다. 업그레이드된 후에는 변경 내용 추적을 위해 모든 전체 텍스트 인덱스를 사용할 수 없으며 크롤링이 자동으로 시작되지 않습니다. 업그레이드가 완료된 후 전체 채우기를 수동으로 실행할 때까지 카탈로그가 비어 있습니다.

2 = 전체 텍스트 카탈로그를 가져옵니다. 일반적으로 가져오기는 다시 빌드보다 빠릅니다. 예를 들어 CPU를 하나만 사용하는 경우 가져오기는 다시 빌드보다 약 10배 빠르게 실행됩니다. 그러나 가져온 전체 텍스트 카탈로그는 새롭고 향상된 단어 분리기를 사용하지 않으므로 결국 전체 텍스트 카탈로그를 다시 빌드할 수 있습니다.

참고: 다시 빌드는 다중 스레드 모드에서 실행될 수 있으며, 10개 이상의 CPU를 사용할 수 있는 경우 다시 빌드에서 모든 CPU를 사용하도록 허용하는 경우 가져오기보다 더 빠르게 다시 빌드가 실행될 수 있습니다.

전체 텍스트 카탈로그를 사용할 수 없는 경우 연결된 전체 텍스트 인덱스가 다시 작성됩니다. 이 옵션은 SQL Server 2005(9.x) 데이터베이스에 대해서만 사용할 수 있습니다.

전체 텍스트 업그레이드 옵션을 선택하는 방법에 대한 자세한 내용은 전체 텍스트 검색 전체 업그레이드를 참조하세요.

참고: SQL Server Management Studio에서 이 속성을 설정하려면 전체 텍스트 업그레이드 옵션 속성을 사용합니다. 자세한 내용은 서버 인스턴스에 대한 전체 텍스트 검색 관리 및 모니터링을 참조 하세요.
verify_signature int 전체 텍스트 엔진이 서명된 이진 파일만 로드하는지 여부를 나타냅니다. 기본적으로 트러스트된 서명된 이진 파일만 로드됩니다.

1 = 신뢰할 수 있는 서명된 이진 파일만 로드되는지 확인합니다(기본값).

0 = 이진 파일이 서명되었는지 여부를 확인하지 않습니다.

반환 코드 값

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

결과 집합

없음

사용 권한

serveradmin 고정 서버 역할의 멤버 또는 시스템 관리자만 실행할 sp_fulltext_service수 있습니다.

예제

A. 등록된 언어 목록 업데이트

다음 예제에서는 전체 텍스트 검색에 등록된 언어 목록을 업데이트합니다.

EXEC sp_fulltext_service 'update_languages';
GO

B. 전체 텍스트 카탈로그를 다시 설정하도록 전체 텍스트 업그레이드 옵션 변경

다음은 전체 텍스트 카탈로그를 다시 설정하여 완전히 제거하도록 전체 텍스트 업그레이드 옵션을 변경하는 예제입니다. 이 예제에서는 선택적 @action 및 @value 인수를 지정합니다.

EXEC sp_fulltext_service
    @action = 'upgrade_option',
    @value = 1;
GO

관련 콘텐츠