AI_ANALYZE_SENTIMENT (Transact-SQL)

Gilt für:SQL-Analyseendpunkt in Microsoft Fabric und Warehouse in Microsoft Fabric

Die AI_ANALYZE_SENTIMENT Funktion analysiert den Eingabetext und gibt eines dieser Sentiment-Labels zurück: positive, , negative, mixedoder neutral.

Note

  • AI_ANALYZE_SENTIMENT befindet sich in der Vorschau.
  • AI_ANALYZE_SENTIMENTist nur im SQL-Analytics-Endpunkt und im Warehouse in Microsoft Fabric verfügbar.

Syntax

Transact-SQL-Syntaxkonventionen

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

Arguments

text

Ein Ausdruck eines Charaktertyps, zum Beispiel nvarchar, varchar, nchar oder char.

EIN FEHLER

Die Klausel ON ERROR steuert, wie eine KI-Funktion mit Verarbeitungsfehlern umgeht.

  • NULL ON ERROR gibt zurück, NULL wenn die Funktion einen Wert nicht verarbeiten kann. Das ist das Standardverhalten und muss nicht explizit angegeben werden.
  • ERROR ON ERROR führt dazu, dass die gesamte Abfrage fehlschlägt, wenn während der Verarbeitung eines Eingabewerts ein Fehler auftritt.
  • DEFAULT <value> ON ERROR gibt den angegebenen Standardwert zurück, anstatt NULL wenn ein Fehler auftritt.

Fehler können durch Sicherheitsprüfungen der Responsible AI, Eingabegrößenbeschränkungen, vorübergehende Serviceprobleme oder andere Verarbeitungsfehler verursacht werden.

Rückgabetypen

Gibt nvarchar mit einem der folgenden Werte zurück:

  • positive
  • negative
  • mixed
  • neutral

Bemerkungen

KI-Funktionen kehren zurück, NULL wenn das KI-Modell den Text nicht verarbeiten kann. Häufige Gründe sind:

  • Verantwortungsvolle KI-Regeln blockieren unangemessene Inhalte im Eingabetext.
  • Eingabetext überschreitet Tokengrenzwerte. Das aktuelle Modell unterstützt bis zu 15 KB Text.

Beispiele

A. Analysiere Gefühle in einer Zeichenkette

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

Erwartetes Ergebnis: positive

B. Analysieren Sie die Stimmung aus einer Tabellenspalte

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

Die optionale ERROR ON ERROR Klausel führt dazu, dass die Abfrage fehlschlägt, wenn kein Eingabewert verarbeitet werden kann.

Verwandte Inhalte

  • Last updated on