Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
S'applique à :
SQL Server
Retourne une table de zéro, une ou plusieurs lignes pour les documents dont le contenu dans la colonne spécifiée est sémantiquement similaire à un document spécifié.
Cette fonction d’ensemble de lignes peut être référencée dans la FROM clause d’une SELECT instruction comme un nom de table standard.
Conventions de la syntaxe Transact-SQL
Syntax
SEMANTICSIMILARITYTABLE
(
table
, { column | (column_list) | * }
, source_key
)
Arguments
table
Nom d’une table sur laquelle l’indexation sémantique et le texte intégral sont activés.
Ce nom peut être un nom en quatre parties, mais un nom de serveur distant n’est pas autorisé.
column
Nom de la colonne indexée pour laquelle les résultats doivent être retournés L'indexation sémantique doit être activée pour la colonne.
column_list
Indique plusieurs colonnes, séparées par une virgule et placées entre parenthèses. L'indexation sémantique doit être activée pour toutes les colonnes.
*
Indique que toutes les colonnes pour lesquelles l'indexation sémantique est activée sont incluses.
source_key
Clé unique de la ligne, pour demander des résultats d'une ligne spécifique.
La 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 sous la forme d’une constante ou d’une variable, mais ne peut pas être une expression ou le résultat d’une sous-requête scalaire.
Table retournée
Le tableau suivant décrit les informations sur les documents similaires ou associés renvoyés par cette fonction d'ensemble de lignes.
Les documents correspondants sont retournés colonne par colonne si les résultats sont demandés pour plusieurs colonnes.
| Nom de colonne | Type | Description |
|---|---|---|
source_column_id
1 |
int | ID de la colonne depuis laquelle un document source a été utilisé pour rechercher des documents similaires. |
matched_column_id
1 |
int | ID de la colonne depuis laquelle un document similaire a été trouvé. |
matched_document_key |
*Cette clé correspond au type de la clé unique dans la table source. |
Valeur de la clé unique de l'extraction sémantique et de recherche en texte intégral du document ou de la ligne considéré(e) comme similaire au document spécifié dans la requête. |
score |
real | Valeur relative de ressemblance pour ce document dans sa relation à tous les autres documents similaires. La valeur est une valeur décimale fractionnaire dans la plage de [0,0, 1,0] où un score plus élevé représente une correspondance plus proche, et 1,0 est un score parfait. |
1 Consultez les fonctions COL_NAME et COLUMNPROPERTY pour plus d’informations sur la façon de récupérer le nom de colonne et column_id inversement.
Remarks
Pour plus d’informations, consultez Rechercher des documents similaires et connexes avec la recherche sémantique.
Limitations
Vous ne pouvez pas interroger plusieurs colonnes pour des documents similaires. La SEMANTICSIMILARITYTABLE fonction récupère uniquement des documents similaires à partir de la même colonne que la colonne source, qui est identifiée par l’argument source_key .
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 :
Permissions
Nécessite SELECT des autorisations sur la table de base sur laquelle les index de recherche en texte intégral et sémantique ont été créés.
Examples
L’exemple suivant récupère les 10 premiers candidats similaires à un candidat spécifié dans la HumanResources.JobCandidate table de l’exemple AdventureWorks2025 de base de données.
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;