semanticsimilaritydetailstable (Transact-SQL)

[アーティクル]
08/11/2023

コンテンツが意味的に似ている 2 つのドキュメント (ソースドキュメントと一致するドキュメント) に共通する、0 行、1 行、または複数行のキーフレーズのテーブルを返します。

この行セット関数は、SELECT ステートメントの FROM 句で参照できます

構文

SEMANTICSIMILARITYDETAILSTABLE  
    (  
    table,  
    source_column,  
    source_key,  
    matched_column,  
    matched_key  
    )

引数

テーブル
フルテキストインデックスとセマンティックインデックスが有効になっているテーブルの名前を指定します。

この名前は 1 から 4 部構成の名前にすることができますが、リモートサーバー名は使用できません。

source_column
類似性を比較されるコンテンツを含んだソース行の列の名前。

source_key
ソースドキュメントの行を表す一意のキー。

このキーは、可能であれば常に、ソーステーブル内の一意なフルテキストキーの型に、暗黙的に変換されます。キーは定数または変数として指定できますが、スカラーサブクエリの式または結果にすることはできません。無効なキーが指定された場合、行は返されません。

matched_column
類似性のために比較するコンテンツを含む、一致する行の列の名前。

matched_key
一致ドキュメントの行を表す一意のキー。

このキーは、可能であれば常に、ソーステーブル内の一意なフルテキストキーの型に、暗黙的に変換されます。キーは定数または変数として指定できますが、スカラーサブクエリの式または結果にすることはできません。

返されるテーブル

次の表では、この行セット関数が返すキーフレーズに関する情報について説明します。

Column_name	型	説明
keyphrase	NVARCHAR	ソースドキュメントと一致するドキュメントの類似性に寄与するキーフレーズ。
スコア	REAL	2 つのドキュメント間で類似している他のすべてのキーフレーズとのリレーションシップにおける、このキーフレーズの相対値。この値は [0.0, 1.0] の範囲内の小数値です。スコアの値が大きいほど類似性が高く、1.0 は完全に一致することを表します。

全般的な解説

詳細については、「セマンティック検索を使用した類似ドキュメントおよび関連ドキュメントの検索を参照してください。

Metadata

セマンティック類似性の抽出と作成に関する情報と状態については、次の動的管理ビューを照会します。

セキュリティ

アクセス許可

フルテキストおよびセマンティックインデックスが作成されたベーステーブルに対する SELECT 権限が必要です。

例

次の例では、AdventureWorks2022 サンプルデータベースの HumanResources.JobCandidate テーブル内の指定した候補間で最も高い類似性スコアを持つ 5 つのキーフレーズを取得します。 @CandidateId変数と@MatchedID変数は、フルテキストインデックスのキー列の値を表します。

SELECT TOP(5) KEY_TBL.keyphrase, KEY_TBL.score  
FROMSEMANTICSIMILARITYDETAILSTABLE  
    (  
    HumanResources.JobCandidate,  
    Resume, @CandidateID,  
    Resume, @MatchedID  
    ) AS KEY_TBL  
ORDER BY KEY_TBL.score DESC;

次の方法で共有