semanticsimilaritydetailstable (Transact-SQL)

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

この行セット関数は、標準のテーブル名のように、SELECT ステートメントの FROM 句で参照できます。

Transact-SQL 構文表記規則

構文

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

引数

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

  この名前は、1 部から 4 部の構成の名前にできますが、リモート サーバー名は許可されません。

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

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

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

• matched_column
  類似性を比較されるコンテンツを含んだ一致行の列の名前。

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

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

返されるテーブル

次の表に、この行セット関数から返されるキー フレーズに関する情報を示します。

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

全般的な解説

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

メタデータ

セマンティックな類似性の抽出および作成の詳細と状態については、次の動的管理ビューに対してクエリを実行してください。

• sys.dm_db_fts_index_physical_stats (Transact-SQL)

• sys.dm_fts_semantic_similarity_population (Transact-SQL)

セキュリティ

権限

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

使用例

次の例では、AdventureWorks2012 サンプル データベースの 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;