AI_TRANSLATE(Transact-SQL)

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

AI_TRANSLATE 将输入文本翻译成目标语言。

Note

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

Syntax

Transact-SQL 语法约定

AI_TRANSLATE ( text, lang_code [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

文本消息

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

lang_code

翻译目标的语言代码。

支持的值:deenfriteselpl, , sv, , fi, 。 cs

失误

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

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

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

返回类型

返回带翻译文本的 nvarchar(max)。

Remarks

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

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

示例

答: 翻译成德语

SELECT ai_translate('The hotel was great', 'de') AS translation_de;

预期结果:Das Hotel war großartig.

B. 将复习文本翻译成多种语言

SELECT review_id,
       ai_translate(review_text, 'de') AS review_de,
       ai_translate(review_text, 'fr' ERROR ON ERROR) AS review_fr,
       ai_translate(review_text, 'es' DEFAULT 'N/A' ON ERROR) AS review_es
FROM dbo.hotel_reviews;

如果翻译成德语失败,第一个函数将返回 NULL 而非错误。

NULL ON ERROR 条款指示将文本翻译成法语的AI函数,如果任何输入值无法翻译,查询失败。 该 DEFAULT 'N/A' ON ERROR 条款指示将文本翻译成西班牙语的AI函数返回 N/A 每个无法处理的输入值。