AI_ANALYZE_SENTIMENT(Transact-SQL)

适用于:Microsoft Fabric 中的 SQL 分析终结点和 Microsoft Fabric 中的仓库

AI_ANALYZE_SENTIMENT函数分析输入文本,返回以下情感标签之一:positivenegativemixedneutral

Note

  • AI_ANALYZE_SENTIMENT 处于预览状态。
  • AI_ANALYZE_SENTIMENT仅在 Microsoft Fabric 的 SQL 分析端点和仓库中提供。

Syntax

Transact-SQL 语法约定

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

Arguments

文本消息

一个字符类型的 表达 式,例如 nvarcharvarcharncharchar

失误

ON ERROR 条款控制AI函数如何处理处理错误。

  • NULL ON ERROR 当函数无法处理某个值时返回 NULL 。 这是默认行为,不需要明确说明。
  • ERROR ON ERROR 如果在处理任何输入值时发生错误,整个查询都会失败。
  • DEFAULT <value> ON ERROR 返回指定的默认值,而不是 NULL 在错误发生时返回。

错误可能由 负责任的人工智能 安全检查、输入大小限制、暂时性服务问题或其他处理失败引起。

返回类型

返回 nvarchar 的值如下之一:

  • positive
  • negative
  • mixed
  • neutral

Remarks

如果AI模型无法处理文本,AI功能会返回 NULL 。 常见原因包括:

  • 负责任的AI规则会 屏蔽输入文本中的不当内容。
  • 输入文本超过令牌限制。 当前模型最多支持 15 KB 文本。

示例

答: 分析串中的情感

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 子句会导致查询失败。