전체 텍스트 인덱스 만들기 및 관리

아티클
08/21/2023

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance

이 문서에서는 SQL Server에서 전체 텍스트 인덱스를 만들고, 채우고, 관리하는 방법을 설명합니다.

전체 텍스트 카탈로그를 만듭니다.

전체 텍스트 인덱스 만들기 전에 전체 텍스트 카탈로그가 있어야 합니다. 카탈로그는 하나 이상의 전체 텍스트 인덱스에 대한 가상 컨테이너입니다. 자세한 내용은 전체 텍스트 카탈로그 만들기 및 관리를 참조하세요.

전체 텍스트 인덱스 생성, 변경 또는 삭제

전체 텍스트 인덱스 채우기

전체 텍스트 인덱스를 생성하고 유지하는 프로세스를 모집단(크롤링이라고도 함)이라고 합니다. 전체 텍스트 인덱스 채우기에는 다음 세 가지 유형이 있습니다.

전체 모집단
변경 내용 추적 기반 모집단
타임스탬프 기반 증분 채우기

자세한 내용은 전체 텍스트 인덱스 채우기를 참조하세요.

전체 텍스트 인덱스의 속성 보기

Transact-SQL을 사용하여 전체 텍스트 인덱스의 속성 보기

카탈로그 뷰 또는 동적 관리 뷰	설명
sys.fulltext_index_catalog_usages(Transact-SQL)	전체 텍스트 인덱스 참조에 대한 각 전체 텍스트 카탈로그에 대해 행을 반환합니다.
sys.fulltext_index_columns(Transact-SQL)	전체 텍스트 인덱스의 일부인 각 열에 대한 행을 포함합니다.
sys.fulltext_index_fragments(Transact-SQL)	전체 텍스트 인덱스는 전체 텍스트 인덱스 조각이라는 내부 테이블을 사용하여 반전된 인덱스 데이터를 저장합니다. 이 뷰를 사용하여 이러한 조각에 대한 메타데이터를 쿼리할 수 있습니다. 이 뷰에는 전체 텍스트 인덱스를 포함하는 모든 테이블의 각 전체 인덱스 조각에 대한 행이 들어 있습니다.
sys.fulltext_indexes(Transact-SQL)	테이블 형식 개체의 각 전체 텍스트 인덱스당 한 개의 행을 포함합니다.
sys.dm_fts_index_keywords(Transact-SQL)	지정된 테이블에 대한 전체 텍스트 인덱스 내용에 관한 정보를 반환합니다.
sys.dm_fts_index_keywords_by_document(Transact-SQL)	지정된 테이블에 대한 전체 텍스트 인덱스의 문서 수준 내용에 관한 정보를 반환합니다. 지정된 키워드는 여러 문서에 나타날 수 있습니다.
sys.dm_fts_index_population(Transact-SQL)	현재 진행 중인 전체 텍스트 인덱스 채우기에 대한 정보를 반환합니다.

SQL Server Management Studio를 사용하여 전체 텍스트 인덱스의 속성 보기

참고 항목

Azure SQL 데이터베이스에 대한 전체 텍스트 인덱스의 속성을 보려면 Transact-SQL을 사용합니다.

SQL Server Management Studio의 개체 탐색기에서 서버를 확장합니다.
데이터베이스를 확장한 다음 전체 텍스트 인덱스가 포함된 데이터베이스를 확장합니다.
테이블을 확장합니다.
전체 텍스트 인덱스가 정의된 테이블을 마우스 오른쪽 단추로 클릭하고 전체 텍스트 인덱스를 선택한 다음 전체 텍스트 인덱스 상황에 맞는 메뉴에서 속성을 선택합니다. 그러면 전체 텍스트 인덱스 대화 상자가 열립니다.

페이지 선택 창에서 다음 페이지 중 원하는 페이지를 선택할 수 있습니다.

페이지	설명
일반	전체 텍스트 인덱스의 기본 속성을 표시합니다. 여기에는 여러 가지 수정 가능한 속성과 데이터베이스 이름, 테이블 이름 및 전체 텍스트 키 열의 이름과 같은 변경되지 않는 많은 속성이 포함됩니다. 수정할 가능한 속성은 다음과 같습니다. 전체 텍스트 인덱스 중지 목록 전체 텍스트 인덱싱 사용 변경 내용 추적 검색 속성 목록
열	전체 텍스트 인덱싱에 사용할 수 있는 테이블 열을 표시합니다. 열을 선택하면 선택한 열이 전체 텍스트 인덱싱됩니다. 이때 전체 텍스트 인덱스에 포함하려는 만큼 사용 가능한 열을 선택할 수 있습니다. 자세한 내용은 전체 텍스트 인덱스 채우기를 참조하세요.
일정	이 페이지를 사용하여 전체 텍스트 인덱스 채우기에 대한 증분 테이블 채우기를 시작하는 SQL Server 에이전트 작업에 대한 일정을 만들거나 관리할 수 있습니다. 자세한 내용은 전체 텍스트 인덱스 채우기를 참조하세요. 참고: 전체 텍스트 인덱스 속성 대화 상자를 닫으면 새로 만든 일정이 SQL Server 에이전트 작업( database_name.table_name에 대한 증분 테이블 채우기 시작)에 연결됩니다.

확인을 선택하여 변경 내용을 저장하고 전체 텍스트 인덱스 속성 대화 상자를 종료합니다.

인덱싱된 테이블 및 열의 속성 보기

다양한 전체 텍스트 인덱싱 속성의 값을 얻기 위해 OBJECTPROPERTYEX와 같은 여러 Transact-SQL 함수를 사용할 수 있습니다. 이 정보는 전체 텍스트 검색을 관리하고 문제를 해결하는 데 유용합니다.

다음 표에서는 인덱싱된 테이블 및 열과 관련된 전체 텍스트 속성과 관련 Transact-SQL 함수를 나열합니다.

속성	설명	함수
FullTextTypeColumn	열의 문서 종류 정보를 보관하는 테이블의 TYPE COLUMN입니다.	COLUMNPROPERTY
IsFulltextIndexed	열에 대한 전체 텍스트 인덱싱 설정 여부를 나타냅니다.	COLUMNPROPERTY
IsFulltextKey	인덱스가 테이블의 전체 텍스트 키인지 여부입니다.	INDEXPROPERTY
TableFulltextBackgroundUpdateIndexOn	테이블에 전체 텍스트 백그라운드 업데이트 인덱싱이 있는지 여부입니다.	OBJECTPROPERTYEX
TableFulltextCatalogId	테이블에 대한 전체 텍스트 인덱스 데이터가 상주하는 전체 텍스트 카탈로그 ID입니다.	OBJECTPROPERTYEX
TableFulltextChangeTrackingOn	테이블의 전체 텍스트 변경 내용 추적이 활성화되어 있는지 여부입니다.	OBJECTPROPERTYEX
TableFulltextDocsProcessed	전체 텍스트 인덱싱이 시작된 이후에 처리된 행의 수입니다.	OBJECTPROPERTYEX
TableFulltextFailCount	전체 텍스트 검색이 인덱싱하지 않은 행의 수입니다.	OBJECTPROPERTYEX
TableFulltextItemCount	성공적으로 전체 텍스트 인덱싱된 행의 수입니다.	OBJECTPROPERTYEX
TableFulltextKeyColumn	전체 텍스트 고유 키 열의 열 ID입니다.	OBJECTPROPERTYEX
TableFullTextMergeStatus	테이블에 현재 병합 중인 전체 텍스트 인덱스가 있는지를 나타냅니다.	OBJECTPROPERTYEX
TableFulltextPendingChanges	처리할 보류 중인 변경 내용 추적 항목의 수입니다.	OBJECTPROPERTYEX
TableFulltextPopulateStatus	전체 텍스트 테이블의 채우기 상태입니다.	OBJECTPROPERTYEX
TableHasActiveFulltextIndex	테이블에 활성 전체 텍스트 인덱스가 있는지 여부입니다.	OBJECTPROPERTYEX

전체 텍스트 키 열에 대한 정보 얻기

일반적으로 CONTAINSTABLE 또는 FREETEXTTABLE 행 집합 반환 함수의 결과는 기본 테이블과 조인되어야 합니다. 이러한 경우 고유한 키 열 이름을 알아야 합니다. 지정된 고유 인덱스가 전체 텍스트 키로 사용되는지 여부를 확인할 수 있으며 전체 텍스트 키 열의 식별자를 가져올 수 있습니다.

지정된 고유 인덱스가 전체 텍스트 키 열로 사용되는지 여부를 결정합니다.

SELECT 문을 사용하여 INDEXPROPERTY 함수를 호출합니다. 함수 호출에서 OBJECT_ID 함수를 사용하여 테이블 이름(table_name)을 테이블 ID로 변환하고, 테이블의 고유 인덱스 이름을 지정한 다음, 다음과 같이 IsFulltextKey 인덱스 속성을 지정합니다:

SELECT INDEXPROPERTY(OBJECT_ID('table_name'), 'index_name',  'IsFulltextKey');

이 문은 인덱스가 전체 텍스트 키 열의 고유성을 적용하는 데 사용되는 경우 1을 반환하고, 그렇지 않으면 0을 반환합니다.

예시

다음 예제에서는 다음과 같이 PK_Document_DocumentNode 인덱스를 사용하여 전체 텍스트 키 열의 고유성을 적용하는지 여부를 확인합니다.

USE AdventureWorks2022;
GO
SELECT INDEXPROPERTY(OBJECT_ID('Production.Document'), 'PK_Document_DocumentNode',  'IsFulltextKey');

다음은 PK_Document_DocumentNode 인덱스가 전체 텍스트 키 열의 고유성을 적용하는 데 사용되는 경우 1을 반환하는 예제입니다. 그렇지 않은 경우 0 또는 null을 반환합니다. NULL은 잘못된 인덱스 이름이 사용 중이거나, 인덱스 이름이 테이블과 일치하지 않거나, 테이블이 존재하지 않음 등을 의미합니다.

전체 텍스트 키 열의 식별자 찾기

전체 텍스트를 사용하도록 설정된 테이블에는 해당 테이블에 고유 행을 강제 적용하는 데 사용되는 열(고유키 열)이 있습니다. OBJECTPROPERTYEX 함수에서 얻을 수 있는 TableFulltextKeyColumn 속성에는 고유 키 열의 열 ID가 포함됩니다.

이 식별자를 가져오려면 SELECT 문을 사용하여 OBJECTPROPERTYEX 함수를 호출하면 됩니다. 다음과 같이 OBJECT_ID 함수를 사용하여 테이블 이름(table_name)을 테이블 ID로 변환하고 TableFulltextKeyColumn 속성을 지정합니다.

SELECT OBJECTPROPERTYEX(OBJECT_ID('table_name'), 'TableFulltextKeyColumn' ) AS 'Column Identifier';

예제

다음 예제에서는 전체 텍스트 키 열 또는 NULL의 식별자를 반환합니다. NULL은 잘못된 인덱스 이름이 사용 중이거나, 인덱스 이름이 테이블과 일치하지 않거나, 테이블이 존재하지 않음 등을 의미합니다.

USE AdventureWorks2022;
GO
SELECT OBJECTPROPERTYEX(OBJECT_ID('Production.Document'), 'TableFulltextKeyColumn');
GO

다음 예제에서는 고유 키 열의 식별자를 사용하여 열의 이름을 가져오는 방법을 보여 있습니다.

USE AdventureWorks2022;
GO

DECLARE @key_column SYSNAME

SET @key_column = COL_NAME(OBJECT_ID('Production.Document'),
   OBJECTPROPERTYEX(OBJECT_ID('Production.Document'), 'TableFulltextKeyColumn'));

SELECT @key_column AS 'Unique Key Column';
GO

이 예에서는 Document 테이블의 고유 키 열 이름인 DocumentNode가 포함된 단일 행을 표시하는 Unique Key Column라는 결과 집합 열을 반환합니다. 이 쿼리에 잘못된 인덱스 이름이 포함되어 있으면 인덱스 이름이 테이블에 해당하지 않으며 테이블이 존재하지 않는 등 NULL을 반환합니다.

varbinary(max) 및 XML 열 인덱스

varbinary(max), varbinary또는 xml 열이 전체 텍스트 인덱싱된 경우 다른 전체 텍스트 인덱싱된 열과 마찬가지로 전체 텍스트 조건자(CONTAINS 및 FREETEXT) 및 함수(CONTAINSTABLE 및 FREETEXTTABLE)를 사용하여 이러한 열을 쿼리할 수 있습니다.

varbinary(max) 또는 varbinary 데이터 인덱싱

단일 varbinary(max) 또는 varbinary 열에 많은 문서 유형을 저장할 수 있습니다. SQL Server에서는 필터가 설치되어 있고 운영 체제에서 사용할 수 있는 문서 유형을 지원합니다. 각 문서의 문서 형식은 문서의 파일 확장명으로 식별됩니다. 예를 들어 .doc 파일 확장자의 경우 전체 텍스트 검색에서는 Microsoft Word 문서를 지원하는 필터를 사용합니다. 사용 가능한 문서 유형의 목록을 보려면 sys.fulltext_document_types 카탈로그 뷰를 쿼리하세요.

전체 텍스트 엔진은 운영 체제에 설치된 기존 필터를 사용할 수 있습니다. 운영 체제 필터, 단어 분리기, 형태소 분석기를 사용하려면 먼저 다음과 같이 서버 인스턴스에 로드해야 합니다.

EXEC sp_fulltext_service @action = 'load_os_resources', @value = 1;

varbinary(max) 열에 대한 전체 텍스트 인덱스를 만들려면 전체 텍스트 엔진이 varbinary(max) 열에 있는 문서의 파일 확장명에 액세스해야 합니다. 이 정보는 전체 텍스트 인덱스에서 varbinary(max) 열과 연결되어야 하는 형식 열이라는 테이블 열에 저장되어야 합니다. 문서를 인덱싱할 때 전체 텍스트 엔진은 형식 열의 파일 확장자를 사용하여 사용할 필터를 식별합니다.

인덱스 XML 데이터

xml 데이터 형식 열은 XML 문서와 조각만 저장하고 XML 필터만 문서에 사용됩니다. 따라서 형식 열은 필요하지 않습니다. xml 열에서 전체 텍스트 인덱스는 XML 요소의 내용은 인덱싱하지만 XML 태그는 무시합니다. 특성 값은 숫자 값이 아니면 전체 텍스트 인덱싱됩니다. 요소 태그는 토큰 경계로 사용됩니다. 여러 언어를 포함하는 올바른 형식의 XML 또는 HTML 문서와 조각이 지원됩니다.

xml 열에 대한 인덱싱 및 쿼리에 대한 자세한 내용은 XML 열로 전체 텍스트 검색 사용을 참조하세요.

테이블에 대해 전체 텍스트 인덱싱 사용 안 함 또는 다시 사용

SQL Server에서 사용자가 만든 모든 데이터베이스는 기본적으로 전체 텍스트가 활성화되어 있습니다. 또한 전체 텍스트 인덱스가 만들어지고 열이 인덱스로 추가되는 즉시 개별 테이블이 자동으로 전체 텍스트 인덱싱을 사용하도록 설정됩니다. 마지막 열이 전체 텍스트 인덱스에서 삭제되면 전체 텍스트 인덱싱에 대해 테이블이 자동으로 비활성화됩니다.

전체 텍스트 인덱스가 있는 테이블에서 SQL Server Management Studio를 사용하여 테이블에서의 전체 텍스트 인덱싱을 수동으로 해제하거나 다시 설정할 수 있습니다.

서버 그룹을 확장하고, 데이터베이스를 확장하고, 전체 텍스트 인덱싱을 사용하도록 설정할 테이블이 포함된 데이터베이스를 확장합니다.
테이블을 확장하고 전체 텍스트 인덱싱을 사용하지 않도록 설정하거나 다시 사용하도록 설정할 테이블을 마우스 오른쪽 단추로 클릭합니다.
전체 텍스트 인덱스를 선택한 다음 전체 텍스트 인덱스 사용 안 함 또는 전체 텍스트 인덱스 사용을 선택합니다.

테이블에서 전체 텍스트 인덱스 제거

개체 탐색기 삭제할 전체 텍스트 인덱스가 있는 테이블을 마우스 오른쪽 단추로 클릭합니다.
전체 텍스트 인덱스 삭제를 선택합니다.
메시지가 표시되면 확인을 선택하여 전체 텍스트 인덱스 삭제를 확인합니다.

다음을 통해 공유