semantickeyphrasetable (Transact-SQL)

Article
05/23/2023

S'applique à : SQL Server

Retourne une table de zéro, une ou plusieurs lignes pour les expressions clés associées aux colonnes spécifiées de la table spécifiée.

Cette fonction d'ensemble de lignes peut uniquement être référencée dans la clause FROM d'une instruction SELECT comme tout nom de table standard.

Conventions de la syntaxe Transact-SQL

Syntaxe

SEMANTICKEYPHRASETABLE  
    (  
    table,  
    { column | (column_list) | * }  
     [ , source_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é.

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 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 source_key est omis, les résultats sont retournés pour toutes les lignes.

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
column_id	int	ID de la colonne à partir de laquelle l’expression clé actuelle a été extraite et indexée. Consultez les fonctions COL_NAME et COLUMNPROPERTY pour plus d'informations sur la récupération d'un nom de colonne à partir de column_id et inversement.
document_key	* Cette clé correspond au type de la clé unique dans la table source.	Valeur de clé unique du document ou de la ligne à partir de laquelle l'expression clé actuelle a été indexée.
keyphrase	NVARCHAR	Expression clé trouvée dans la colonne identifiée par column_id et associée au document spécifié par document_key.
score	REAL	Valeur relative de cette expression clé dans sa relation à toutes les autres expressions clés du même document dans la colonne indexée. 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 expressions clés dans des documents avec la recherche sémantique.

Métadonnées

Pour obtenir des informations et connaître l'état relatif à l'extraction d'expressions clés sémantiques 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.

Exemples

Exemple 1 : rechercher les expressions clés de niveau supérieur dans un document spécifique

L’exemple suivant extrait les 10 expressions clés de niveau supérieur du document spécifié par la variable @DocumentId dans la colonne Document de la table Production.Document de l’exemple de base de données AdventureWorks. La variable @DocumentId représente une valeur de la colonne clé de l’index de recherche en texte intégral. La fonction SEMANTICKEYPHRASETABLE récupère efficacement ces résultats en utilisant une recherche d'index au lieu d'une analyse de table. Cet exemple suppose que la colonne est configurée pour l'indexation de texte intégral et sémantique.

SELECT TOP(10) KEYP_TBL.keyphrase  
FROM SEMANTICKEYPHRASETABLE  
    (  
    Production.Document,  
    Document,  
    @DocumentId  
    ) AS KEYP_TBL  
ORDER BY KEYP_TBL.score DESC;

Exemple 2 : rechercher les documents de niveau supérieur qui contiennent une expression clé spécifique

L’exemple suivant récupère les 25 premiers documents qui contiennent l’expression clé « bracket » dans la colonne Document de la table Production.Document de l’exemple de base de données AdventureWorks. Cet exemple suppose que la colonne est configurée pour l'indexation de texte intégral et sémantique.

SELECT TOP (25) DOC_TBL.DocumentID, DOC_TBL.DocumentSummary  
FROM Production.Document AS DOC_TBL  
    INNER JOIN SEMANTICKEYPHRASETABLE  
    (  
    Production.Document,  
    Document  
    ) AS KEYP_TBL  
ON DOC_TBL.DocumentID = KEYP_TBL.document_key  
WHERE KEYP_TBL.keyphrase = 'Bracket'  
ORDER BY KEYP_TBL.Score DESC;

Partager via