Applies to:
SQL Server
SQL Server에 대한 전체 텍스트 검색의 서버 속성을 변경합니다.
Caution
SQL upgrade_option Server 2022(16.x) 이상 버전에서는 이 작업이 완전히 지원되지 않습니다. 자세한 내용은 이 문서의 뒷부분에 있는 SQL Server 2022 이상 버전 과의 호환성 섹션을 참조하세요.
Syntax
sp_fulltext_service
[ [ @action = ] N'action' ]
[ , [ @value = ] value ]
[ ; ]
Arguments
[ @action = ] N'action'
변경하거나 다시 설정할 속성입니다. @action is nvarchar(100), with no default. For a list of @action properties, their descriptions, and the values that can be set, see the table under the @value argument.
이 인수는 다음 속성을 반환합니다.
- data type
- 현재 실행 중인 값
- 최소값 또는 최대값
- 사용 중단 상태(해당하는 경우).
[ @value = ] value
@value is sql_variant, with a default of NULL.
지정된 속성의 값입니다.
@value is sql_variant, with a default value of NULL. If @value is null, sp_fulltext_service returns the current setting. 이 표에서는 동작 속성, 설명 및 설정할 수 있는 값 목록을 보여 줍니다.
Note
다음 작업은 SQL Server의 이후 릴리스에서 제거될 예정입니다. clean_upconnect_timeoutdata_timeoutresource_usage 새 개발 작업에서 이러한 작업을 사용하지 말고 현재 해당 작업을 사용하는 애플리케이션을 수정할 계획입니다.
| Action | Data type | Description |
|---|---|---|
clean_up |
int | 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다. |
connect_timeout |
int | 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다. |
data_timeout |
int | 이전 버전과의 호환성을 위해서만 지원됩니다. 값은 항상 0.입니다. |
load_os_resources |
int | 운영 체제 단어 분리기, 형태소 분석기 및 필터가 이 SQL Server 인스턴스에 등록되고 사용되는지 여부를 나타냅니다. One of:0 = 이 SQL Server 인스턴스와 관련된 필터 및 단어 분리기만 사용합니다.1 = 운영 체제 필터 및 단어 분리기를 로드합니다.기본적으로 이 속성은 운영 체제에 대한 업데이트로 인한 실수로 인한 동작 변경을 방지하기 위해 사용하지 않도록 설정됩니다. 운영 체제 리소스를 사용하도록 설정하면 인스턴스별 리소스가 설치되지 않은 Microsoft Indexing Service에 등록된 언어 및 문서 유형에 대한 리소스에 액세스할 수 있습니다. 운영 체제 리소스의 로드를 사용하도록 설정하는 경우 운영 체제 리소스가 신뢰할 수 있는 서명된 이진 파일인지 확인합니다. 그렇지 않으면 로 설정된 verify_signature경우 1 로드할 수 없습니다. |
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 |
전체 텍스트 검색에 등록된 언어 및 필터 목록을 업데이트합니다. 언어는 인덱싱 및 전체 텍스트 쿼리를 구성할 때 지정됩니다. Filters are used by the filter daemon host to extract textual information from corresponding file formats such as .docx stored in data types, such as varbinary, varbinary(max), image, or xml, for full-text indexing.자세한 내용은 등록된 필터 및 단어 분리기 보기 또는 변경을 참조 하세요. |
upgrade_option |
int | SQL Server 2005(9.x)에서 이후 버전으로 데이터베이스를 업그레이드할 때 전체 텍스트 인덱스가 마이그레이션되는 방법을 제어합니다. 이 속성은 데이터베이스 복사 마법사를 사용하여 데이터베이스를 연결하거나, 데이터베이스 백업 및 파일 백업을 복원하거나, 데이터베이스를 복사하여 업그레이드에 적용됩니다. One of: - 0 = 전체 텍스트 카탈로그는 새롭고 향상된 단어 분리기를 사용하여 다시 작성됩니다. 인덱스를 다시 빌드하는 데 다소 시간이 걸릴 수 있으며 업그레이드 후에 상당한 양의 CPU 및 메모리가 필요할 수 있습니다.- 1 = 전체 텍스트 카탈로그가 다시 설정됩니다. SQL Server 2005(9.x) 전체 텍스트 카탈로그 파일이 제거되지만 전체 텍스트 카탈로그 및 전체 텍스트 인덱스의 메타데이터는 유지됩니다. 업그레이드된 후에는 변경 내용 추적을 위해 모든 전체 텍스트 인덱스를 사용할 수 없으며 크롤링이 자동으로 시작되지 않습니다. 업그레이드가 완료된 후 전체 채우기를 수동으로 실행할 때까지 카탈로그가 비어 있습니다.- 2 = 전체 텍스트 카탈로그를 가져옵니다. 일반적으로 가져오기는 다시 빌드보다 빠릅니다. 예를 들어 CPU를 하나만 사용하는 경우 가져오기는 다시 빌드하는 것 보다 약 10배 빠르게 실행됩니다. 그러나 가져온 전체 텍스트 카탈로그는 새롭고 향상된 단어 분리기를 사용하지 않으므로 전체 텍스트 카탈로그를 다시 작성할 수 있습니다. SQL Server 2022(16.x) 이상 버전에서 제거되고 오류가 발생합니다.Note: Rebuild can run in multi-threaded mode, and if more than 10 CPUs are available, rebuild might run faster than import if you allow rebuild to use all of the CPUs. 전체 텍스트 카탈로그를 사용할 수 없는 경우 연결된 전체 텍스트 인덱스가 다시 작성됩니다. 이 옵션은 SQL Server 2005(9.x) 데이터베이스에만 사용할 수 있습니다. 전체 텍스트 업그레이드 옵션을 선택하는 방법은 전체 텍스트 검색 업그레이드를 참조하세요. Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. 자세한 내용은 서버 인스턴스의 전체 텍스트 검색 관리 및 모니터링을 참조하세요. |
verify_signature
1 |
int | 전체 텍스트 엔진이 서명된 이진 파일만 로드하는지 여부를 나타냅니다. 기본적으로 트러스트된 서명된 이진 파일만 로드됩니다.1 = 신뢰할 수 있는 서명된 이진 파일만 로드되는지 확인합니다(기본값).0 = 이진 파일이 서명되었는지 여부를 확인하지 않습니다. |
1 When verify_signature is 1, the Full-Text Engine only checks the cached Certificate Revocation List (CRL) before loading binaries. You should periodically refresh your local CRL cache with certutil, when using third party binaries.
반환 코드 값
0(성공) 또는 1(실패).
Result set
None.
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)로 업그레이드할 수 있습니다.
Permissions
Only members of the serveradmin fixed server role or the system administrator can execute sp_fulltext_service.
Examples
A. 등록된 언어 목록 업데이트
다음 예제에서는 전체 텍스트 검색에 등록된 언어 목록을 업데이트합니다.
EXECUTE sp_fulltext_service 'update_languages';
GO
B. 전체 텍스트 카탈로그를 다시 설정하도록 전체 텍스트 업그레이드 옵션 변경
다음은 전체 텍스트 카탈로그를 다시 설정하여 완전히 제거하도록 전체 텍스트 업그레이드 옵션을 변경하는 예제입니다. This example specifies the optional @action and @value arguments.
EXECUTE sp_fulltext_service
@action = 'upgrade_option',
@value = 1;
GO