AI_TRANSLATE

命令格式

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 类型时，返回报错。

使用示例

SET odps.sql.ai.treat.as.common.model=true;
SET odps.namespace.schema=true;

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

-- 返回结果
+-----------------------------------------------------------------------+
| translated_text                                                       |
+-----------------------------------------------------------------------+
| MaxCompute是一个快速且完全托管的大规模数据仓储计算平台。                     |
+-----------------------------------------------------------------------+

-- 示例数据
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.   |
+-----------------------------+------+-------------------------------+