Condividi tramite

semanticsimilaritytable (Transact-SQL)

  • Articolo

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.

Icona di collegamento a un argomento Convenzioni della 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 colonna

Tipo

Descrizione

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.

score

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 ulteriori informazioni, vedere Trovare documenti simili e correlati tramite 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 come 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 database di esempio AdventureWorks2012.

SELECT TOP(10) KEY_TBL.matched_document_key AS Candidate_ID
FROMSEMANTICSIMILARITYTABLE
    (
    HumanResources.JobCandidate,
    Resume,
    @CandidateID
    ) AS KEY_TBL
ORDER BY KEY_TBL.score DESC;