semanticsimilaritydetailstable (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne une table de zéro, une ou plusieurs lignes d'expressions clés communes à travers deux documents (document source et un document mis en correspondance) dont le contenu est similaire sémantiquement.

Cette fonction d’ensemble de lignes peut être référencée dans la clause FROM d’une instruction SELECT

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

table
Nom d'une table dont l'indexation sémantique et de texte intégral est activée.

Ce nom peut être en une à quatre parties, mais un nom de serveur distant n'est pas autorisé.

source_column
Nom de la colonne sur la ligne source qui contient le contenu dont la similarité doit être comparée.

source_key
Clé unique qui représente la ligne du document source.

Cette clé est convertie implicitement en type de clé unique de recherche en texte intégral dans la table source, dans la mesure du possible. La clé peut être spécifiée en tant que constante ou variable, mais il ne peut pas s'agir d'une expression ni du résultat d'une sous-requête scalaire. Si une clé non valide est spécifiée, aucune ligne n'est retournée.

matched_column
Nom de la colonne sur la ligne correspondante qui contient le contenu dont la similarité doit être comparée.

matched_key
Clé unique qui représente la ligne du document correspondant.

Cette clé est convertie implicitement en type de clé unique de recherche en texte intégral dans la table source, dans la mesure du possible. La clé peut être spécifiée en tant que constante ou variable, mais il ne peut pas s'agir d'une expression ni du résultat d'une sous-requête scalaire.

Table retournée

Le tableau suivant décrit les informations sur les expressions clés renvoyées par cette fonction d'ensemble de lignes.

Column_name Type Description
keyphrase NVARCHAR Expression clé qui contribue à la similarité entre le document source et le document correspondant.
score REAL Valeur relative de cette expression clé dans sa relation à toutes les autres expressions clés qui sont semblables dans les deux documents.

La valeur est une valeur décimale fractionnaire comprise dans la plage de [0.0, 1.0] dans laquelle un score élevé représente une pondération plus élevée, 1.0 étant le score parfait.

Remarques d'ordre général

Pour plus d’informations, consultez Rechercher des documents similaires et connexes avec la recherche sémantique.

Metadata

Pour obtenir des informations et connaître l'état relatif à l'extraction de ressemblance sémantique et au remplissage, interrogez les vues de gestion dynamique suivantes :

Sécurité

Autorisations

Requiert des autorisations SELECT sur la table de base sur laquelle les index sémantiques et de recherche en texte intégral ont été créés.

Examples

L’exemple suivant récupère les 5 expressions clés ayant le score de similarité le plus élevé entre les candidats spécifiés dans la table HumanResources.JobCandidate de l’exemple AdventureWorks2022 de base de données. Les @CandidateId variables et @MatchedID les variables représentent des valeurs de la colonne clé de l’index de recherche en texte intégral.

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;