semantickeyphrasetable (Transact-SQL)

Si applica a: SQL Server

Restituisce una tabella con zero, una o più righe per le frasi chiave associate alle colonne indicate nella tabella specificata.

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

Convenzioni relative alla sintassi Transact-SQL

Sintassi

SEMANTICKEYPHRASETABLE  
    (  
    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. Se si omette source_key, vengono restituiti risultati per tutte le righe.

Tabella restituita

Nella tabella seguente vengono descritte le informazioni sulle frasi chiave restituite da questa funzione per i set di righe.

Nome della colonna	Tipo	Descrizione
column_id	int	ID della colonna da cui è stata estratta e indicizzata la frase chiave corrente. Vedere le funzioni COL_NAME e COLUMNPROPERTY per informazioni dettagliate su come recuperare il nome di colonna da column_id e viceversa.
document_key	* Questa chiave corrisponde al tipo della chiave univoca nella tabella di origine.	Valore della chiave univoca del documento o della riga da cui è stata indicizzata la frase chiave corrente.
keyphrase	NVARCHAR	Frase chiave trovata nella colonna identificata da column_id e associato con il documento specificato da document_key.
Punteggio	REAL	Valore relativo per la frase chiave nella sua relazione con tutte le altre frasi chiave nello stesso documento presente nella colonna indicizzata. Il valore è un valore decimale frazionario compreso nell'intervallo [0.0, 1.0], dove un punteggio maggiore rappresenta un peso maggiore e 1.0 costituisce il punteggio perfetto.

Osservazioni generali

Per altre informazioni, vedere Trovare frasi chiave nei documenti con ricerca semantica.

Metadati UFX

Per informazioni generali e sullo stato relative all'estrazione e al popolamento semantici di frasi chiave, eseguire una query sulle DMV seguenti:

• sys.dm_db_fts_index_physical_stats (Transact-SQL)

• sys.dm_fts_index_population (Transact-SQL)

Sicurezza

Autorizzazioni

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

Esempi

Esempio 1: trovare le principali frasi chiave in un documento specifico

L'esempio seguente recupera le prime 10 frasi chiave dal documento specificato tramite la variabile @DocumentId nella colonna Document della tabella Production.Document del database di esempio AdventureWorks. La variabile @DocumentId rappresenta un valore della colonna chiave dell'indice full-text. La funzione SEMANTICKEYPHRASETABLE recupera in modo efficiente questi risultati tramite una ricerca nell'indice anziché un'analisi della tabella. In questo esempio si presuppone che la colonna venga configurata per l'indicizzazione full-text e semantica.

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

Esempio 2: trovare i documenti principali che contengono una frase chiave specifica

Nell'esempio seguente vengono recuperati i primi 25 documenti che contengono la frase chiave "Bracket" dalla colonna Documento della tabella Production.Document del database di esempio AdventureWorks. In questo esempio si presuppone che la colonna venga configurata per l'indicizzazione full-text e semantica.

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;