semantickeyphrasetable(Transact-SQL)

아티클
11/24/2024

적용 대상: SQL Server

지정된 테이블의 지정된 열과 연결된 키 구에 대해 행이 0개, 하나 이상인 테이블을 반환합니다.

SELECT 문의 FROM 절에서 일반 테이블 이름처럼 이 행 집합 함수를 참조할 수 있습니다.

구문

SEMANTICKEYPHRASETABLE  
    (  
    table,  
    { column | (column_list) | * }  
     [ , source_key ]  
    )

인수

table
전체 텍스트 및 의미 체계 인덱싱을 사용하도록 설정된 테이블의 이름입니다.

이 이름은 1~4부로 구성될 수 있지만 원격 서버 이름은 허용되지 않습니다.

column
결과를 반환할 인덱싱된 열의 이름입니다. 열에 의미 체계 인덱싱이 활성화되어 있어야 합니다.

column_list
쉼표로 구분되고 괄호로 묶인 여러 열을 나타냅니다. 모든 열에는 의미 체계 인덱싱을 사용하도록 설정해야 합니다.

*
의미 체계 인덱싱을 사용하도록 설정된 모든 열이 포함됨을 나타냅니다.

source_key
특정 행에 대한 결과를 요청하기 위한 행의 고유 키입니다.

키는 가능하면 소스 테이블의 전체 텍스트 고유 키 형식으로 암시적으로 변환됩니다. 키는 상수 또는 변수로 지정할 수 있지만 식이나 스칼라 하위 쿼리의 결과일 수는 없습니다. source_key 생략하면 모든 행에 대해 결과가 반환됩니다.

반환된 테이블

다음 표에서는 이 행 집합 함수가 반환하는 핵심 구에 대한 정보를 설명합니다.

Column_name	Type	설명
column_id	int	현재 키 구를 추출하고 인덱싱한 열의 ID입니다. column_id 열 이름을 검색하는 방법에 대한 자세한 내용은 COL_NAME 및 COLUMNPROPERTY 함수를 참조하세요.
document_key	* 이 키는 원본 테이블의 고유 키 형식과 일치합니다.	현재 키 구가 인덱싱된 문서 또는 행의 고유 키 값입니다.
keyphrase	NVARCHAR	column_id 식별되고 document_key 지정한 문서와 연결된 열에 있는 핵심 구입니다.
점수	REAL	동일한 문서의 인덱싱된 열에 있는 다른 모든 키 구를 기준으로 한 이 키 구의 상대적 값입니다. 값은 [0.0, 1.0] 범위의 소수 값입니다. 여기서 높은 점수는 더 높은 가중치를 나타내고 1.0은 완벽한 점수입니다.

일반적인 주의 사항

자세한 내용은 의미 체계 검색을 사용하여 문서에서 핵심 구 찾기를 참조하세요.

메타데이터

의미 체계 핵심 구 추출 및 모집단에 대한 정보 및 상태는 다음 동적 관리 뷰를 쿼리합니다.

보안

사용 권한

전체 텍스트 및 의미 체계 인덱스를 만든 기본 테이블에 대한 SELECT 권한이 필요합니다.

예제

예제 1: 특정 문서에서 주요 핵심 구 찾기

다음 예제에서는 AdventureWorks 예제 데이터베이스에 있는 Production.Document 테이블의 Document 열에서 @DocumentId 변수를 통해 지정된 문서에서 상위 10개의 키 구를 검색합니다. @DocumentId 변수는 전체 텍스트 인덱스의 키 열에서 값을 나타냅니다. SEMANTICKEYPHRASETABLE 함수는 테이블 검색 대신 인덱스 검색을 사용하여 이러한 결과를 효율적으로 검색합니다. 이 예에서는 열이 전체 텍스트 및 의미 체계 인덱싱에 대해 구성되어 있는 것으로 가정합니다.

SELECT TOP(10) KEYP_TBL.keyphrase  
FROM SEMANTICKEYPHRASETABLE  
    (  
    Production.Document,  
    Document,  
    @DocumentId  
    ) AS KEYP_TBL  
ORDER BY KEYP_TBL.score DESC;

예 2: 특정 키 구가 포함된 상위 문서 찾기

다음 예제에서는 AdventureWorks 예제 데이터베이스에 있는 Production.Document 테이블의 Document 열에서 키 구 "Bracket"이 포함된 상위 25개의 문서를 검색합니다. 이 예에서는 열이 전체 텍스트 및 의미 체계 인덱싱에 대해 구성되어 있는 것으로 가정합니다.

SELECT TOP (25) DOC_TBL.DocumentID, DOC_TBL.DocumentSummary  
FROM Production.Document AS DOC_TBL  
    INNER JOIN SEMANTICKEYPHRASETABLE  
    (  
    Production.Document,  
    Document  
    ) AS KEYP_TBL  
ON DOC_TBL.DocumentID = KEYP_TBL.document_key  
WHERE KEYP_TBL.keyphrase = 'Bracket'  
ORDER BY KEYP_TBL.Score DESC;

다음을 통해 공유