AI_TRANSLATE - MaxCompute - Alibaba Cloud ドキュメントセンター

AI_TRANSLATE は、モデルを呼び出して入力テキストを翻訳し、翻訳されたテキストを返す MaxCompute の AI 関数です。

構文

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

パラメーター

model_name：必須。STRING 型の値。使用するモデルの名前を指定します。詳細については、「SQL AI 関数」をご参照ください。
version_name：必須。STRING 型の値。使用するモデルのバージョンを指定します。デフォルトのバージョンを呼び出すには、DEFAULT_VERSION を使用します。
input：必須。翻訳対象のテキストを含む文字列です。
target_language：必須。翻訳のターゲット言語を指定する文字列です。ISO-639 言語コード形式です。サポートされている言語コードは次のとおりです。
言語コード
言語
zh
中国語
en
英語
es
スペイン語
fr
フランス語
de
ドイツ語
ja
日本語
ko
韓国語
ru
ロシア語
ar
アラビア語
pt
ポルトガル語
model_parameters：任意。モデルパラメーターを JSON 形式で指定する文字列です。max_tokens、temperature、top_p などを指定できます。例：

'{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}'。
- max_tokens：1 回のモデル呼び出しで生成されるトークンの最大数です。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是一个快速且完全托管的大规模数据仓储计算平台。',
    'en'
) AS translated_text;

-- 結果
+-----------------+
| translated_text |
+-----------------+
| MaxCompute is a fast, fully managed, large-scale data warehousing and computing platform. |
+-----------------+

例 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	ポルトガル語