AI_TRANSLATE（Transact-SQL）

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

AI_TRANSLATE 將輸入文字翻譯成目標語言。

Note

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

Syntax

Transact-SQL 語法慣例

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

Arguments

收發簡訊

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

lang_code

翻譯目標的語言代碼。

支援值：de， en， fritesel， ， pl， ， sv， fi， 。 cs

失誤

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

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

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

傳回類型

回傳 nvarchar（max） 並附有翻譯文字。

Remarks

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

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

Examples

答： 翻譯成德文

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 。

相關內容

  • Last updated on