semanticsimilaritytable(Transact-SQL)

아티클
08/11/2023

적용 대상:SQL Server

지정된 열의 내용이 지정된 문서와 의미상 유사한 0개 이상의 문서 행으로 구성된 테이블을 반환합니다.

이 행 집합 함수는 일반 테이블 이름과 같은 SELECT 문의 FROM 절에서 참조할 수 있습니다.

구문

SEMANTICSIMILARITYTABLE  
    (  
    table,  
    { column | (column_list) | * },  
    source_key  
    )

인수

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

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

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

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

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

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

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

반환된 테이블

다음 표에서는 이 행 집합 함수가 반환하는 유사하거나 관련된 문서에 대해 설명합니다.

일치하는 문서는 둘 이상의 열에서 결과를 요청하는 경우 열별로 반환됩니다.

Column_name	Type	설명
source_column_id	int	원본 문서를 사용하여 유사한 문서를 찾은 열의 ID입니다. column_id 열 이름을 검색하는 방법에 대한 자세한 내용은 COL_NAME 및 COLUMNPROPERTY 함수를 참조하세요.
matched_column_id	int	비슷한 문서를 찾은 열의 ID입니다. column_id 열 이름을 검색하는 방법에 대한 자세한 내용은 COL_NAME 및 COLUMNPROPERTY 함수를 참조하세요.
matched_document_key	* 이 키는 원본 테이블의 고유 키 형식과 일치합니다.	쿼리에서 지정된 문서와 유사한 것으로 확인된 문서나 행의 전체 텍스트 및 의미 체계 추출 고유 키 값입니다.
점수	REAL	다른 모든 유사한 문서와의 관계에서 이 문서의 유사성에 대한 상대 값입니다. 이 값은 [0.0, 1.0] 범위의 소수 10진수 값입니다. 점수가 높을수록 유사성이 높으며 1.0이 최대 점수입니다.

일반적인 주의 사항

자세한 내용은 의미 체계 검색을 사용하여 유사 문서 및 관련 문서 찾기를 참조하세요.

제한 사항

유사한 문서의 열 간에는 쿼리할 수 없습니다. SEMANTICSIMILARITYTABLE 함수는 source_key 인수로 식별되는 원본 열과 동일한 열에서 유사한 문서만 검색합니다.

메타데이터

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

보안

사용 권한

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

예

다음 예제에서는 샘플 데이터베이스의 HumanResources.JobCandidate 테이블에서 AdventureWorks2022 지정된 후보와 비슷한 상위 10명의 후보를 검색합니다.

SELECT TOP(10) KEY_TBL.matched_document_key AS Candidate_ID  
FROM SEMANTICSIMILARITYTABLE  
    (  
    HumanResources.JobCandidate,  
    Resume,  
    @CandidateID  
    ) AS KEY_TBL  
ORDER BY KEY_TBL.score DESC;