sys.dm_fts_index_keywords_by_property(Transact-SQL)
지정된 테이블의 전체 텍스트 인덱스에 있는 속성 관련 내용을 모두 반환합니다. 해당 전체 텍스트 인덱스와 연결된 검색 속성 목록에서 등록한 모든 속성에 속하는 데이터가 모두 여기에 포함됩니다.
sys.dm_fts_index_keywords_by_property는 인덱싱 시 IFilter에서 내보낸 등록된 속성 및 인덱싱된 각 문서의 모든 속성에 대한 정확한 내용을 확인할 수 있는 동적 관리 함수입니다.
속성 관련 내용을 포함하여 모든 문서 수준 내용을 보려면
상위 수준의 전체 텍스트 인덱스 정보를 보려면
[!참고]
검색 속성 목록에 대한 자세한 내용은 검색 속성 목록을 사용하여 문서 속성 검색을 참조하십시오.
구문
sys.dm_fts_index_keywords_by_property
(
DB_ID('database_name'),
OBJECT_ID('table_name')
)
인수
db_id('database_name')
DB_ID() 함수에 대한 호출입니다. 이 함수는 데이터베이스 이름을 받아서 sys.dm_fts_index_keywords_by_property가 지정된 데이터베이스를 찾기 위해 사용하는 데이터베이스 ID를 반환합니다. database_name을 생략하면 현재 데이터베이스 ID가 반환됩니다.object_id('table_name')
OBJECT_ID() 함수에 대한 호출입니다. 이 함수는 테이블 이름을 받아서 검사할 전체 텍스트 인덱스가 들어 있는 테이블의 테이블 ID를 반환합니다.
반환된 테이블
열 |
데이터 형식 |
설명 |
|---|---|---|
keyword |
nvarchar(4000) |
전체 텍스트 인덱스 내에 저장되는 키워드의 16진수 표현입니다.
|
display_term |
nvarchar(4000) |
사람이 인식할 수 있는 키워드 형식입니다. 이 형식은 전체 텍스트 인덱스에 저장되는 내부 형식에서 파생됩니다.
|
column_id |
int |
현재 키워드가 전체 텍스트 인덱싱된 열의 ID입니다. |
document_id |
int |
현재 단어가 전체 텍스트 인덱싱된 문서 또는 행의 ID입니다. 이 ID는 해당 문서 또는 행의 전체 텍스트 키 값과 일치합니다. |
property_id |
int |
OBJECT_ID('table_name') 매개 변수에 지정한 테이블의 전체 텍스트 인덱스에 있는 검색 속성의 내부 속성 ID입니다. 지정된 속성이 검색 속성 목록에 추가되면 전체 텍스트 엔진이 속성을 등록하고 속성 목록에 고유한 내부 속성 ID를 할당합니다. 지정된 검색 속성 목록에 고유한 내부 속성 ID이며 정수입니다. 지정된 속성이 여러 검색 속성 목록에 대해 등록된 경우 검색 속성 목록마다 서로 다른 내부 속성 ID가 할당될 수 있습니다.
속성 ID와 속성 이름 간의 연결을 보려면 |
주의
이 동적 관리 뷰에서는 다음과 같은 정보를 확인할 수 있습니다.
지정된 DocID에 대해 지정된 속성에 저장되는 내용
지정된 속성이 인덱싱된 문서 간에 공통적으로 적용되는 정도
지정된 속성이 실제로 문서에 포함되어 있는지 여부. 이 정보는 지정된 검색 속성에 대한 쿼리에서 찾으려는 문서가 반환되지 않는 경우에 유용합니다.
권장한 대로 전체 텍스트 키 열이 integer 데이터 형식이면 document_id가 기본 테이블의 전체 텍스트 키 값에 직접 매핑됩니다.
반대로 전체 텍스트 키 열이 integer 이외의 데이터 형식을 사용하면 document_id가 기본 테이블의 전체 텍스트 키를 나타내지 않습니다. 이 경우 dm_fts_index_keywords_by_property에서 반환된 기본 테이블의 행을 식별하려면 이 뷰를 sp_fulltext_keymappings에서 반환된 결과와 조인해야 합니다. 이 뷰를 조인하려면 먼저 저장 프로시저의 출력을 임시 테이블에 저장해야 합니다. 그런 다음 dm_fts_index_keywords_by_property의 document_id 열을 이 저장 프로시저에서 반환된 DocId 열과 조인할 수 있습니다. 삽입할 때 timestamp 열에서 값을 받을 수 없습니다. 이러한 값은 SQL Server에서 자동으로 생성됩니다. 따라서 timestamp 열을 varbinary(8) 열로 변환해야 합니다. 다음 예에서는 이 단계를 보여 줍니다. 이 예에서 table_id는 테이블 ID, database_name은 데이터베이스 이름, table_name은 테이블 이름을 각각 나타냅니다.
USE database_name;
GO
CREATE TABLE #MyTempTable
(
docid INT PRIMARY KEY ,
[key] INT NOT NULL
);
DECLARE @db_id int = db_id(N'database_name');
DECLARE @table_id int = OBJECT_ID(N'table_name');
INSERT INTO #MyTempTable EXEC sp_fulltext_keymappings @table_id;
SELECT * FROM sys.dm_fts_index_keywords_by_property
( @db_id, @table_id ) kbd
INNER JOIN #MyTempTable tt ON tt.[docid]=kbd.document_id;
GO
사용 권한
전체 텍스트 인덱스가 적용되는 열에 대한 SELECT 권한 및 CREATE FULLTEXT CATALOG 권한이 필요합니다.
예
다음 예에서는 AdventureWorks 예제 데이터베이스 Production.Document 테이블의 전체 텍스트 인덱스에 있는 Author 속성에서 키워드를 반환합니다. 이 예에서는 sys.dm_fts_index_keywords_by_property에서 반환되는 테이블에 대해 별칭 KWBPOP를 사용합니다. 또한 내부 조인을 사용하여 sys.registered_search_properties 및 sys.fulltext_indexes의 열을 결합합니다.
-- Once the full-text index is configured to support property searching
-- on the Author property, return any keywords indexed for this property.
USE AdventureWorks;
GO
SELECT KWBPOP.* FROM
sys.dm_fts_index_keywords_by_property( DB_ID(),
object_id('Production.Document') ) AS KWBPOP
INNER JOIN
sys.registered_search_properties AS RSP ON(
(KWBPOP.property_id = RSP.property_id)
AND (RSP.property_name = 'Author') )
INNER JOIN
sys.fulltext_indexes AS FTI ON(
(FTI.[object_id] = object_id('Production.Document'))
AND (RSP.property_list_id = FTI.property_list_id) );
GO
참고 항목
참조
sp_fulltext_keymappings(Transact-SQL)
sys.dm_fts_index_keywords_by_document(Transact-SQL)
sys.dm_fts_index_keywords(Transact-SQL)
sys.registered_search_properties(Transact-SQL)
sys.registered_search_property_lists(Transact-SQL)