sp_fulltext_service(Transact-SQL)
적용 대상: 
SQL Server
SQL Server에 대한 전체 텍스트 검색의 서버 속성을 변경합니다.
주의
SQL upgrade_option Server 2022(16.x) 이상 버전에서는 이 작업이 완전히 지원되지 않습니다. 자세한 내용은 이 문서의 뒷부분에 있는 SQL Server 2022 이상 버전 과의 호환성 섹션을 참조하세요.
구문
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의 이후 릴리스에서 제거될 예정입니다. clean_upconnect_timeoutdata_timeoutresource_usage 새 개발 작업에서 이러한 작업을 사용하지 말고 현재 해당 작업을 사용하는 애플리케이션을 수정할 계획입니다.
| 작업 | 데이터 형식 | 설명 |
|---|---|---|
clean_up |
int | 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다. |
connect_timeout |
int | 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다. |
data_timeout |
int | 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다. |
load_os_resources |
int | 운영 체제 단어 분리기, 형태소 분석기 및 필터가 이 SQL Server 인스턴스에 등록되고 사용되는지 여부를 나타냅니다. 다음 중 하나입니다.0 = 이 SQL Server 인스턴스와 관련된 필터 및 단어 분리기만 사용합니다.1 = 운영 체제 필터 및 단어 분리기를 로드합니다.기본적으로 이 속성은 운영 체제에 대한 업데이트로 인한 실수로 인한 동작 변경을 방지하기 위해 사용하지 않도록 설정됩니다. 운영 체제 리소스를 사용하도록 설정하면 인스턴스별 리소스가 설치되지 않은 Microsoft Indexing Service에 등록된 언어 및 문서 유형에 대한 리소스에 액세스할 수 있습니다. 운영 체제 리소스의 로드를 사용하도록 설정하는 경우 운영 체제 리소스가 신뢰할 수 있는 서명된 이진 파일인지 확인합니다. 그렇지 않으면 로 설정된 1경우 verify_signature 로드할 수 없습니다. |
master_merge_dop |
int | 마스터 병합 프로세스에서 사용할 스레드 수를 지정합니다. 이 값은 사용 가능한 CPU 또는 CPU 코어 수를 초과하면 안 됩니다. 이 인수를 지정하지 않으면 서비스에서 사용 가능한 CPU 또는 CPU 코어 수를 4더 적게 사용합니다. |
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배 빠르게 실행됩니다. 그러나 가져온 전체 텍스트 카탈로그는 새롭고 향상된 단어 분리기를 사용하지 않으므로 전체 텍스트 카탈로그를 다시 작성할 수 있습니다. SQL Server 2022(16.x) 이상 버전에서 제거되고 오류가 발생합니다.참고: 다시 빌드는 다중 스레드 모드에서 실행될 수 있으며, 10개 이상의 CPU를 사용할 수 있는 경우 다시 빌드에서 모든 CPU를 사용하도록 허용하는 경우 가져오기보다 더 빠르게 다시 빌드가 실행될 수 있습니다. 전체 텍스트 카탈로그를 사용할 수 없는 경우 연결된 전체 텍스트 인덱스가 다시 작성됩니다. 이 옵션은 SQL Server 2005(9.x) 데이터베이스에만 사용할 수 있습니다. 전체 텍스트 업그레이드 옵션을 선택하는 방법은 전체 텍스트 검색 업그레이드를 참조하세요. 참고: SQL Server Management Studio에서 이 속성을 설정하려면 전체 텍스트 업그레이드 옵션 속성을 사용합니다. 자세한 내용은 서버 인스턴스의 전체 텍스트 검색 관리 및 모니터링을 참조하세요. |
verify_signature |
int | 전체 텍스트 엔진이 서명된 이진 파일만 로드하는지 여부를 나타냅니다. 기본적으로 트러스트된 서명된 이진 파일만 로드됩니다.1 = 신뢰할 수 있는 서명된 이진 파일만 로드되는지 확인합니다(기본값).0 = 이진 파일이 서명되었는지 여부를 확인하지 않습니다. |
반환 코드 값
0(성공) 또는 1(실패).
결과 집합
없음
SQL Server 2022 이상 버전과의 호환성
작업의 가져오기 기능 upgrade_option (지정됨)은 SQL Server 2022(16.x) 이상 버전에서 제거됩니다 @action = 'upgrade_option', @value = 2. 이전 버전의 SQL Server에서 전체 텍스트 인덱을 가져와야 하는 경우 SQL Server 2019(15.x) 또는 이전 버전을 사용하여 가져온 다음 SQL Server 2022(16.x)로 업그레이드할 수 있습니다.
사용 권한
serveradmin 고정 서버 역할의 멤버 또는 시스템 관리자만 실행할 sp_fulltext_service수 있습니다.
예제
A. 등록된 언어 목록 업데이트
다음 예제에서는 전체 텍스트 검색에 등록된 언어 목록을 업데이트합니다.
EXECUTE sp_fulltext_service 'update_languages';
GO
B. 전체 텍스트 카탈로그를 다시 설정하도록 전체 텍스트 업그레이드 옵션 변경
다음은 전체 텍스트 카탈로그를 다시 설정하여 완전히 제거하도록 전체 텍스트 업그레이드 옵션을 변경하는 예제입니다. 이 예제에서는 선택적 @action 및 @value 인수를 지정합니다.
EXECUTE sp_fulltext_service
@action = 'upgrade_option',
@value = 1;
GO