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

적용 대상:SQL ServerAzure SQL 데이터베이스Azure SQL Managed Instance

이 글은 SQL Server 데이터베이스 엔진에서 전체 텍스트 인덱스를 생성, 채우기 및 관리하는 방법을 설명합니다. 전체 텍스트 인덱스는 표 내 문자 기반 열에 대한 키워드 및 언어 검색을 지원합니다.

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

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

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

전체 텍스트 인덱스 채우기

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

  • 전체 모집단
  • 변경 사항 추적을 기반으로 한 모집단
  • 타임스탬프를 기반으로 하는 증가하는 인구

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

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

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

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

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

참고

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

  1. SQL Server Management Studio의 개체 탐색기에서 서버를 확장합니다.

  2. 데이터베이스를 확장한 다음 전체 텍스트 인덱스가 포함된 데이터베이스를 확장합니다.

  3. 테이블을 확장합니다.

  4. 전체 텍스트 인덱스가 정의된 테이블을 마우스 오른쪽 단추로 클릭하고 전체 텍스트 인덱스를 선택한 다음 전체 텍스트 인덱스 상황에 맞는 메뉴에서 속성을 선택합니다. 이 동작은 전체 텍스트 인덱스 속성 대화상자를 엽니다.

  5. 페이지 선택 창에서 다음 페이지 중 하나를 선택하세요:

    페이지 설명
    일반 전체 텍스트 인덱스의 기본 속성을 표시합니다. 이 속성에는 여러 변경 가능한 속성과 데이터베이스 이름, 테이블 이름, 전체 텍스트 키 칼럼 이름 등 변경이 불가능한 많은 속성이 포함됩니다. 수정할 가능한 속성은 다음과 같습니다.

    전체 텍스트 인덱스 중지 목록

    전체 텍스트 인덱싱 사용

    변경 내용 추적

    검색 속성 목록
    열 전체 텍스트 인덱싱에 사용할 수 있는 테이블 열을 표시합니다. 선택한 열 또는 열들이 전체 텍스트로 인덱싱되어 있습니다. 이때 전체 텍스트 인덱스에 포함하려는 만큼 사용 가능한 열을 선택할 수 있습니다. 자세한 내용은 전체 텍스트 인덱스 채우기를 참조하세요.
    일정 이 페이지를 사용하여 전체 텍스트 인덱스 채우기에 대한 증분 테이블 채우기를 시작하는 SQL Server 에이전트 작업에 대한 일정을 만들거나 관리할 수 있습니다. 자세한 내용은 전체 텍스트 인덱스 채우기를 참조하세요.

    참고: Full-Text 인덱스 속성 대화상자를 종료한 후, 새로 생성된 일정은 SQL Server 에이전트 작업(database_name에서 점분적 테이블 인구 시작)과 연관됩니다.table_name).
  6. 확인을 선택하여 변경 내용을 저장하고 전체 텍스트 인덱스 속성 대화 상자를 종료합니다.

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

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

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

속성 설명 함수
FullTextTypeColumn TYPE COLUMN 열의 문서 유형 정보를 담고 있는 테이블에 있습니다. COLUMNPROPERTY
IsFulltextIndexed (전체 텍스트 색인이 적용됨) 열이 전체 텍스트 색인화가 활성화되었는지 여부를 지정합니다. COLUMNPROPERTY
IsFulltextKey (전체 텍스트 키 여부) 인덱스가 테이블의 전체 텍스트 키인지 여부입니다. INDEXPROPERTY
TableFulltextBackgroundUpdateIndexOn 테이블에 전체 텍스트 백그라운드 업데이트 인덱싱이 있는지 여부입니다. OBJECTPROPERTYEX
TableFulltextCatalogId 테이블에 대한 전체 텍스트 인덱스 데이터가 상주하는 전체 텍스트 카탈로그 ID입니다. OBJECTPROPERTYEX
TableFulltextChangeTrackingOn 테이블의 전체 텍스트 변경 내용 추적이 활성화되어 있는지 여부입니다. OBJECTPROPERTYEX
테이블전체문서처리됨 전체 텍스트 인덱싱이 시작된 이후에 처리된 행의 수입니다. OBJECTPROPERTYEX
TableFulltextFailCount 전체 텍스트 검색이 인덱싱하지 않은 행의 수입니다. OBJECTPROPERTYEX
TableFulltextItemCount 성공적으로 전체 텍스트 인덱싱된 행의 수입니다. OBJECTPROPERTYEX
테이블전체텍스트키칼럼 전체 텍스트 고유 키 열의 열 ID입니다. OBJECTPROPERTYEX
테이블전체텍스트병합상태 테이블에 현재 병합 중인 전체 텍스트 인덱스가 있는지를 나타냅니다. OBJECTPROPERTYEX
테이블전체텍스트대기중인변경사항 처리할 보류 중인 변경 내용 추적 항목의 수입니다. 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 AdventureWorks2025;
GO

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

이 예시는 인덱스가 PK_Document_DocumentNode 전체 텍스트 키 열의 유일성을 강제할 경우 1을 반환합니다. 그렇지 않으면 0 또는 NULL를 반환합니다. NULL 즉, 잘못된 인덱스 이름을 사용하고 있고, 인덱스 이름이 테이블과 일치하지 않으며, 테이블이 존재하지 않는다는 식입니다.

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

각 전체 텍스트 지원 테이블은 테이블에 고유한 행을 강제하는 열( 고유 키 열)을 가지고 있습니다. OBJECTPROPERTYEX 함수에서 가져온 TableFulltextKeyColumn 속성에는 고유 키 열의 열 ID가 포함됩니다.

이 식별자를 얻으려면 OBJECTPROPERTYEX 함수를 호출하는 SELECT 문을 사용하세요. 함수를 OBJECT_ID 사용해 테이블 이름(table_name)을 테이블 ID로 변환하고 다음과 같이 속성을 지정합니다 TableFulltextKeyColumn :

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

예제

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

USE AdventureWorks2025;
GO

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

다음 예시는 고유 키 열의 식별자를 사용하여 열 이름을 얻는 방법을 보여줍니다.

USE AdventureWorks2025;
GO

DECLARE @key_column AS 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)와 함수(CONTAINSTABLEFREETEXTTABLE와 )를 사용하여 쿼리할 수 있습니다.

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

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

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

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

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

인덱스 XML 데이터

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

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

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

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

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

  1. 서버 그룹을 확장하고, 데이터베이스를 확장하고, 전체 텍스트 인덱싱을 사용하도록 설정할 테이블이 포함된 데이터베이스를 확장합니다.

  2. 테이블을 확장하고 전체 텍스트 인덱싱을 사용하지 않도록 설정하거나 다시 사용하도록 설정할 테이블을 마우스 오른쪽 단추로 클릭합니다.

  3. 전체 텍스트 인덱스를 선택한 다음 전체 텍스트 인덱스 사용 안 함 또는 전체 텍스트 인덱스 사용을 선택합니다.

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

  1. 개체 탐색기 삭제할 전체 텍스트 인덱스가 있는 테이블을 마우스 오른쪽 단추로 클릭합니다.

  2. 전체 텍스트 인덱스 삭제를 선택합니다.

  3. 메시지가 표시되면 확인을 선택하여 전체 텍스트 인덱스 삭제를 확인합니다.