AI_TRANSLATE - MaxCompute

AI_TRANSLATE 是 MaxCompute 提供的 AI Function，通過調用模型將輸入的文本按照指定語言翻譯並返回。

命令格式

STRING AI_TRANSLATE(
  STRING <model_name>,
  STRING <version_name>,
  STRING <input>,
  STRING <target_language>
  [, STRING <model_parameters>]
);

參數說明

model_name：必填。STRING 類型。待使用的模型名，請參見SQL AI Function。
version_name：必填。STRING 類型。待使用的模型版本名。如果調用預設版本，支援直接輸入DEFAULT_VERSION。
input：必填。STRING類型。輸入的待翻譯的文本。
target_language：必填。STRING類型。翻譯成指定語言，採用 ISO-639 語言代碼。支援的語言代碼如下：
語言代碼
語言
zh
中文
en
英語
es
西班牙語
fr
法語
de
德語
ja
日語
ko
韓語
ru
俄語
ar
阿拉伯語
pt
葡萄牙語
model_parameters：選填。STRING 類型。支援指定模型調用相關參數 max_tokens、temperature、top_p，格式為
'{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}' 。參數說明如下：
- max_tokens：設定模型單次調用輸出 token 的最大數量，對於 MaxCompute 公用模型，預設值為 4096。
- temperature：介於 0 到 1 之間的值，用於控制模型輸出的隨機性強度。值越大，輸出越具創意和多樣性；值越低，輸出越確定和保守。
- top_p：介於 0 到 1 之間的值，用於限定模型選擇的備選標籤範圍。值越大，備選範圍越廣，多樣性越高；值越小，範圍越窄，結果越集中。

傳回值說明

返回 STRING 類型，翻譯後的文本。返回規則如下：

input 或 target_language 非 STRING 類型時，返回報錯。

使用樣本

樣本 1：將文本翻譯為指定語言

調用 MaxCompute 提供的公用模型 qwen3-max，將一段英文句子翻譯為中文。

-- 在SQL作業中使用模型計算服務
SET odps.task.major.version=sql_modelstudio;
SET odps.namespace.schema=true;

SELECT AI_TRANSLATE(
    bigdata_public_modelset.default.`qwen3-max`,
    DEFAULT_VERSION,
    'MaxCompute is a fast and fully managed computing platform for large-scale data warehousing.',
    'zh'
) AS translated_text;

-- 返回結果
+-----------------+
| translated_text |
+-----------------+
| MaxCompute 是一個快速、完全託管的大規模資料倉儲計算平台。 |
+-----------------+

樣本 2：將表資料翻譯為多種語言

調用 MaxCompute 提供的公用模型 Qwen3-4B-GGUF，在一次查詢中將同一段英文文本分別翻譯為中文、日語、法語和西班牙語。

-- 樣本資料
CREATE TABLE translation_tasks (
    source_text STRING,
    lang STRING
);

INSERT INTO translation_tasks VALUES
    ('Welcome to Alibaba Cloud.', 'zh'),
    ('Welcome to Alibaba Cloud.', 'ja'),
    ('Welcome to Alibaba Cloud.', 'fr'),
    ('Welcome to Alibaba Cloud.', 'es');

-- 將同一文本翻譯為多種目標語言
SET odps.sql.ai.treat.as.common.model=true;
SET odps.namespace.schema=true;

SELECT
    source_text,
    lang,
    AI_TRANSLATE(
        bigdata_public_modelset.default.`Qwen3-4B-GGUF`,
        DEFAULT_VERSION,
        source_text,
        lang
    ) AS translated_text
FROM translation_tasks;

-- 返回結果
+-----------------------------+------+-------------------------------+
| source_text                 | lang | translated_text               |
+-----------------------------+------+-------------------------------+
| Welcome to Alibaba Cloud.   | zh   | 歡迎來到阿里雲。                |
| Welcome to Alibaba Cloud.   | ja   | アリババクラウドへようこそ。       |
| Welcome to Alibaba Cloud.   | fr   | Bienvenue sur Alibaba Cloud.  |
| Welcome to Alibaba Cloud.   | es   | Bienvenido a Alibaba Cloud.   |
+-----------------------------+------+-------------------------------+

語言代碼	語言
zh	中文
en	英語
es	西班牙語
fr	法語
de	德語
ja	日語
ko	韓語
ru	俄語
ar	阿拉伯語
pt	葡萄牙語