sys.dm_fts_index_keywords(Transact-SQL)

지정된 테이블에 대한 전체 텍스트 인덱스 내용에 관한 정보를 반환합니다.

sys.dm_fts_index_keywords는 동적 관리 함수입니다.

[!참고]

더 낮은 수준의 전체 텍스트 인덱스 정보를 보려면 문서 수준에서 sys.dm_fts_index_keywords_by_document 동적 관리 함수를 사용하십시오.

구문

sys.dm_fts_index_keywords( DB_ID('database_name'), OBJECT_ID('table_name'))

인수

  • db_id('database_name')
    DB_ID() 함수에 대한 호출입니다. 이 함수는 데이터베이스 이름을 받아서 sys.dm_fts_index_keywords가 지정된 데이터베이스를 찾기 위해 사용하는 데이터베이스 ID를 반환합니다. database_name을 생략하면 현재 데이터베이스 ID가 반환됩니다.

  • object_id('table_name')
    OBJECT_ID() 함수에 대한 호출입니다. 이 함수는 테이블 이름을 받아서 검사할 전체 텍스트 인덱스를 포함하는 테이블의 테이블 ID를 반환합니다.

반환된 테이블

열 이름

데이터 형식

설명

keyword

nvarchar(4000)

전체 텍스트 인덱스에 저장되는 키워드의 16진수 표현입니다.

참고참고
OxFF는 파일 또는 데이터 집합의 끝을 나타내는 특수 문자입니다.

display_term

nvarchar(4000)

사람이 인식할 수 있는 키워드 형식입니다. 이 형식은 16진수 형식에서 파생됩니다.

참고참고
OxFF에 대한 display_term 값은 "END OF FILE"입니다.

column_id

int

현재 키워드가 전체 텍스트 인덱싱된 열의 ID입니다.

document_count

int

현재 용어가 들어 있는 문서 또는 행 수입니다.

주의

sys.dm_fts_index_keywords가 반환하는 정보는 특히 다음을 확인하는 데 유용합니다.

  • 키워드가 전체 텍스트 인덱스에 포함되어 있는지 여부

  • 지정된 키워드가 들어 있는 문서 또는 행 수

  • 전체 텍스트 인덱스의 가장 일반적인 키워드

    • document_count인 0xFF의 문서 수와 비교한 각 keyword_value의 document_count

    • 일반적으로 공통 키워드는 중지 단어로 선언하기에 적합합니다.

[!참고]

특정 문서에 대해 sys.dm_fts_index_keywords에서 반환되는 document_count는 sys.dm_fts_index_keywords_by_document 또는 CONTAINS 쿼리에서 반환된 수보다 덜 정확할 수 있습니다. 이 잠재적인 부정확성은 1% 미만일 것으로 예상됩니다. 이러한 부정확성은 인덱스 조각의 여러 행에 걸쳐 계속되거나 같은 행에 두 번 이상 나타나면 document_id가 두 번 계산될 수 있기 때문에 발생할 수 있습니다. 특정 문서에 대해 보다 정확한 수치를 얻으려면 sys.dm_fts_index_keywords_by_document 또는 CONTAINS 쿼리를 사용합니다.

사용 권한

전체 텍스트 인덱스가 적용되는 열에 대한 CREATE FULLTEXT CATALOG 및 SELECT 사용 권한이 필요합니다.

1. 상위 수준의 전체 텍스트 인덱스 내용 표시

다음 예에서는 AdventureWorks2008R2 예제 데이터베이스의 HumanResources.JobCandidate 테이블에 상위 수준의 전체 텍스트 인덱스 내용을 표시합니다. .

SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2008R2'), object_id('HumanResources.JobCandidate'))
GO