Condividi tramite


semanticsimilaritytable (Transact-SQL)

Si applica a:SQL Server

Restituisce una tabella di zero, una o più righe per documenti il cui contenuto nelle colonne specificate è semanticamente simile a un determinato documento.

È possibile fare riferimento a questa funzione del set di righe nella clausola di un'istruzione FROMSELECT , ad esempio un nome di tabella normale.

Convenzioni relative alla sintassi Transact-SQL

Syntax

SEMANTICSIMILARITYTABLE
    (
      table
      , { column | (column_list) | * }
      , source_key
    )

Arguments

table

Nome di una tabella con indicizzazione full-text e semantica abilitata.

Questo nome può essere un nome da uno a quattro parti, ma non è consentito un nome server remoto.

column

Nome della colonna indicizzata per cui restituire risultati. Per la colonna deve essere abilitata l'indicizzazione semantica.

column_list

Indica diverse colonne, separate da una virgola e racchiuse tra parentesi. Per tutte le colonne deve essere abilitata l'indicizzazione semantica.

*

Indica che tutte le colonne per cui l'indicizzazione semantica è abilitata sono incluse.

source_key

Chiave univoca per la riga per richiedere risultati per una riga specifica.

Laddove possibile, la chiave viene convertita in modo implicito nel tipo della chiave univoca full-text nella tabella di origine. La chiave può essere specificata come costante o variabile, ma non può essere un'espressione o il risultato di una sottoquery scalare.

Tabella restituita

Nella tabella seguente vengono descritte le informazioni su documenti simili o correlati restituiti da questa funzione per i set di righe.

Se i risultati vengono richiesti per più di una colonna, i documenti corrispondenti vengono restituiti in base a ogni colonna.

Nome della colonna Type Description
source_column_id 1 int ID della colonna da cui è stato utilizzato un documento di origine per la ricerca di documenti simili.
matched_column_id 1 int ID della colonna da cui è stato trovato un documento simile.
matched_document_key *

Questa chiave corrisponde al tipo della chiave univoca nella tabella di origine.
Valore della chiave univoca di estrazione full-text e semantica della riga o del documento individuato come simile al documento specificato nella query.
score real Valore relativo per la somiglianza del documento nella sua relazione con tutti gli altri documenti simili. Il valore è un valore decimale frazionaria nell'intervallo di [0,0, 1,0] in cui un punteggio più alto rappresenta una corrispondenza più vicina e 1,0 è un punteggio perfetto.

1 Per informazioni dettagliate su come recuperare il nome di colonna da e viceversa, vedere le funzioni COL_NAME e column_id.

Remarks

Per altre informazioni, vedere Trovare documenti simili e correlati con la ricerca semantica.

Limitations

Non è possibile eseguire query tra colonne per documenti simili. La SEMANTICSIMILARITYTABLE funzione recupera solo documenti simili dalla stessa colonna della colonna di origine, identificata dall'argomento source_key .

Metadata

Per informazioni generali e sullo stato relative all'estrazione e al popolamento della somiglianza semantica, eseguire una query sulle DMV seguenti:

Permissions

Sono necessarie SELECT autorizzazioni per la tabella di base in cui sono stati creati gli indici full-text e semantici.

Examples

Nell'esempio seguente vengono recuperati i primi 10 candidati simili a un candidato specificato dalla HumanResources.JobCandidate tabella nel AdventureWorks2025 database di esempio.

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;