AI_ANALYZE_SENTIMENT (Transact-SQL)

Gäller för:SQL-analysslutpunkt i Microsoft Fabric och Warehouse i Microsoft Fabric

Funktionen AI_ANALYZE_SENTIMENT analyserar inmatningstext och returnerar en av dessa sentimentetiketter: positive, negative, mixed, eller neutral.

Note

  • AI_ANALYZE_SENTIMENT är i förhandsversion.
  • AI_ANALYZE_SENTIMENTfinns endast i SQL analytics endpoint och Warehouse i Microsoft Fabric.

Syntax

Transact-SQL syntaxkonventioner

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

Arguments

text

Ett uttryck för en karaktärstyp, till exempel nvarchar, varchar, nchar eller char.

PÅ MISSTAG

Klausulen ON ERROR styr hur en AI-funktion hanterar bearbetningsfel.

  • NULL ON ERROR returnerar NULL när funktionen inte kan bearbeta ett värde. Detta är standardbeteendet och behöver inte specificeras uttryckligen.
  • ERROR ON ERROR gör att hela frågan misslyckas om ett fel uppstår under bearbetningen av något indatavärde.
  • DEFAULT <value> ON ERROR returnerar det angivna standardvärdet istället för NULL när ett fel uppstår.

Fel kan orsakas av säkerhetskontroller för Responsible AI , begränsningar av inmatningsstorlek, problem med tillfällig service eller andra bearbetningsfel.

Returtyper

Returnerar nvarchar med ett av följande värden:

  • positive
  • negative
  • mixed
  • neutral

Remarks

AI-funktioner återvänder NULL om AI-modellen inte kan bearbeta texten. Vanliga orsaker är:

  • Ansvarsfulla AI-regler blockerar olämpligt innehåll i inmatningstexten.
  • Indatatexten överskrider tokengränserna. Den aktuella modellen stöder upp till 15 kB text.

Examples

A. Analysera sentiment i en sträng

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

Förväntat resultat: positive

B. Analysera sentimentet från en tabellkolumn

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

Den valfria ERROR ON ERROR klausulen gör att frågan misslyckas om något indatavärde inte kan bearbetas.