AI_ANALYZE_SENTIMENT(Transact-SQL)

適用於:Microsoft Fabric 中的 SQL 分析端點與 Microsoft Fabric 中的倉庫

該AI_ANALYZE_SENTIMENT函數分析輸入文字,並回傳以下其中一個情感標籤:positive、negativemixed或neutral。

Note

  • AI_ANALYZE_SENTIMENT 處於預覽狀態。
  • AI_ANALYZE_SENTIMENT僅在 SQL 分析端點及 Microsoft Fabric 中的 Warehouse 中提供。

Syntax

Transact-SQL 語法慣例

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

Arguments

收發簡訊

一個字元類型的 表達式 ,例如 nvarchar、 varchar、 nchar 或 char。

失誤

這個 ON ERROR 條款控制 AI 函式如何處理處理錯誤。

  • NULL ON ERROR 當函式無法處理某個值時,會回傳 NULL 。 這是預設行為,不需要特別說明。
  • ERROR ON ERROR 若在處理任何輸入值時發生錯誤,會導致整個查詢失敗。
  • DEFAULT <value> ON ERROR 回傳指定的預設值,而非 NULL 錯誤發生時。

錯誤可能由 負責任的 AI 安全檢查、輸入大小限制、短暫服務問題或其他處理失敗所引起。

傳回類型

回傳 nvarchar 的值如下:

  • positive
  • negative
  • mixed
  • neutral

Remarks

如果 AI 模型無法處理文字,AI 功能會回傳 NULL 。 常見原因包括:

  • 負責任的 AI 規則會 封鎖輸入文字中的不當內容。
  • 輸入文字超過字符限制。 目前型號最多支援 15 KB 的文字。

Examples

答: 分析一串的情感

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

預期結果:positive

B. 從表格欄位分析情感

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

若無法處理任何輸入值,則可選 ERROR ON ERROR 子句會導致查詢失敗。