semanticsimilaritytable (Transact-SQL)

Articolo
05/24/2023

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.

A questa funzione del set di righe è possibile fare riferimento nella clausola FROM di un'istruzione SELECT come normale nome di tabella.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

table
Nome di una tabella per cui è abilitata l'indicizzazione full-text e semantica.

Questo nome può essere costituito da una a quattro parti, ma non è consentito un nome di 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	int	ID della colonna da cui è stato utilizzato un documento di origine per la ricerca di documenti simili. Vedere le funzioni COL_NAME e COLUMNPROPERTY per informazioni dettagliate su come recuperare il nome di colonna da column_id e viceversa.
matched_column_id	int	ID della colonna da cui è stato trovato un documento simile. Vedere le funzioni COL_NAME e COLUMNPROPERTY per informazioni dettagliate su come recuperare il nome di colonna da column_id e viceversa.
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.
Punteggio	REAL	Valore relativo per la somiglianza del documento nella sua relazione con tutti gli altri documenti simili. Il valore è un valore decimale frazionario compreso nell'intervallo [0.0, 1.0], dove un punteggio maggiore rappresenta una corrispondenza più vicina e 1.0 costituisce un punteggio perfetto.

Osservazioni generali

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

Limitazioni e restrizioni

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

Metadati

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

Sicurezza

Autorizzazioni

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

Esempi

Nell'esempio seguente vengono recuperati i primi 10 candidati simili a un candidato specificato dalla tabella HumanResources.JobCandidate nel AdventureWorks2022 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;