semanticsimilaritydetailstable (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

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

Transact-SQL 構文表記規則

構文

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

引数

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

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

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

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

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

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

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

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

返されるテーブル

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

Column_name Type 説明
キーフレーズ NVARCHAR ソース ドキュメントと一致するドキュメントの類似性に寄与するキー フレーズ。
スコア REAL 2 つのドキュメント間で類似している他のすべてのキー フレーズとのリレーションシップにおける、このキー フレーズの相対値。

この値は [0.0, 1.0] の範囲内の小数値です。スコアの値が大きいほど類似性が高く、1.0 は完全に一致することを表します。

全般的な解説

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

メタデータ

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

セキュリティ

アクセス許可

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

例

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

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;