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: 必須。STRING。翻訳するテキスト。
target_language: 必須。STRING。翻訳のターゲット言語を ISO-639 言語コードで指定します。次の言語コードがサポートされています：
言語コード
言語
zh
中国語
en
英語
es
スペイン語
fr
フランス語
de
ドイツ語
ja
日本語
ko
韓国語
ru
ロシア語
ar
アラビア語
pt
ポルトガル語
model_parameters: オプション。STRING。`max_tokens`、`temperature`、`top_p` などのモデルパラメーターを指定します。フォーマットは JSON 文字列です：
'{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}'。max_tokens: 1 回のモデル呼び出しで生成されるトークンの最大数。MaxCompute のパブリックモデルの場合、デフォルト値は 4,096 です。
temperature: 0 から 1 までの値で、出力のランダム性をコントロールします。値が高いほど、より創造的で多様な出力になり、値が低いほど、より決定論的で保守的な出力になります。
top_p: 0 から 1 までの値で、モデルが選択できる候補ラベルの範囲を制限します。値が高いほど、範囲が広がり多様性が増し、値が低いほど、範囲が狭まり、より焦点の合った結果が生成されます。
戻り値
翻訳されたテキストを STRING 値として返します。
`input` または `target_language` パラメーターが STRING でない場合、エラーが返されます。
例
例 1：テキストを指定された言語に翻訳
MaxCompute が提供するqwen3.7-max パブリックモデルを呼び出して、英文を中国語に翻訳します。
SET odps.namespace.schema=true;
SELECT AI_TRANSLATE(
bigdata_public_modelset.default.`qwen3.7-max`,
DEFAULT_VERSION,
'MaxCompute is a fast and fully managed computing platform for large-scale data warehousing.',
'zh'
) AS translated_text;
-- 結果
+-------------------------------------------------------------------------------------------+
| translated_text |
+-------------------------------------------------------------------------------------------+
| MaxCompute is a fast and fully managed computing platform for large-scale data warehousing. |
+-------------------------------------------------------------------------------------------+例 2：テーブルデータを複数の言語に翻訳
MaxCompute が提供する deepseek-v4-pro パブリックモデルを呼び出し、単一のクエリで同じ英語のテキストを中国語、日本語、フランス語、スペイン語に翻訳します。
-- サンプルデータ
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.namespace.schema=true;
SELECT
source_text,
lang,
AI_TRANSLATE(
bigdata_public_modelset.default.`deepseek-v4-pro`,
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. |
| Welcome to Alibaba Cloud. | ja | アリババクラウドへようこそ。 |
| Welcome to Alibaba Cloud. | fr | Bienvenue sur Alibaba Cloud. |
| Welcome to Alibaba Cloud. | es | Bienvenido a Alibaba Cloud. |
+-----------------------------+------+-------------------------------+よくある質問
パブリックモデルの一般的な問題のトラブルシューティング
現象：モデルコンピューティングサービスでサポートされているパブリックモデルを呼び出すと、次のエラーメッセージが返されます。
FAILED: ODPS-0130071:[1,8] Semantic analysis exception - inference quota status check failed, error message: region cn-shanghai not found in inference quota原因：現在のプロジェクトが配置されているリージョン、たとえば中国 (上海) でモデルコンピューティングサービスが有効になっていません。その結果、AI 推論リソースを呼び出すことができません。
ソリューション：Alibaba Cloud 管理コンソールに移動して、プロジェクトが配置されているリージョンのモデルコンピューティングサービスを有効にします。詳細については、「MaxCompute モデルコンピューティングサービスの購入と使用」をご参照ください。