AI_ANALYZE_SENTIMENT (Transact-SQL)

Si applica a:Endpoint di analisi SQL in Microsoft Fabric e Warehouse in Microsoft Fabric

La AI_ANALYZE_SENTIMENT funzione analizza il testo in input e restituisce una di queste etichette di sentimento: positive, negative, mixed, o neutral.

Note

  • AI_ANALYZE_SENTIMENT è in anteprima.
  • AI_ANALYZE_SENTIMENTè disponibile solo nell'endpoint SQL Analytics e nel Warehouse in Microsoft Fabric.

Syntax

Convenzioni relative alla sintassi Transact-SQL

AI_ANALYZE_SENTIMENT ( text [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

text

Un'espressione di un tipo di carattere, ad esempio nvarchar, varchar, nchar o char.

ERRORE

La ON ERROR clausola controlla come una funzione IA gestisce gli errori di elaborazione.

  • NULL ON ERROR ritorna NULL quando la funzione non riesce a elaborare un valore. Questo è il comportamento predefinito e non deve essere specificato esplicitamente.
  • ERROR ON ERROR fa fallire l'intera query se si verifica un errore durante l'elaborazione di qualsiasi valore di input.
  • DEFAULT <value> ON ERROR restituisce il valore predefinito specificato invece di NULL quando si verifica un errore.

Gli errori possono essere causati da controlli di sicurezza Responsible AI , limiti di dimensione degli input, problemi di servizio transitori o altri fallimenti di elaborazione.

Tipi restituiti

Restituisce nvarchar con uno dei seguenti valori:

  • positive
  • negative
  • mixed
  • neutral

Remarks

Le funzioni IA tornano NULL se il modello IA non riesce a processare il testo. I motivi comuni includono:

  • Le regole di IA responsabile bloccano contenuti inappropriati nel testo di input.
  • Il testo di input supera i limiti dei token. Il modello corrente supporta fino a 15 KB di testo.

Examples

A. Analizza il sentimento in una stringa

SELECT ai_analyze_sentiment('This hotel was great!') AS sentiment;

Risultato previsto: positive

B. Analizza il sentiment da una colonna di tabella

SELECT review_id,
       ai_analyze_sentiment(review_text ERROR ON ERROR) AS sentiment
FROM dbo.hotel_reviews;

La clausola opzionale ERROR ON ERROR fa fallire la query se non può essere elaborato alcun valore di input.

Contenuti correlati

  • Last updated on