MaxCompute:AI_TRANSLATE

Syntaxe

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

Paramètres

• model_name : Obligatoire. Type STRING. Nom du modèle à utiliser. Pour plus d'informations, consultez la rubrique Fonctions SQL IA.

• version_name : Obligatoire. Type STRING. Version du modèle à utiliser. Pour appeler la version par défaut, saisissez DEFAULT_VERSION.

• input : Obligatoire. Type STRING. Texte à traduire.

• target_language : Obligatoire. Type STRING. Langue cible de la traduction, indiquée sous forme de code de langue ISO-639. Les codes de langue suivants sont pris en charge :

  Code de langue	Langue
  zh	Chinois
  en	Anglais
  es	Espagnol
  fr	Français
  de	Allemand
  ja	Japonais
  ko	Coréen
  ru	Russe
  ar	Arabe
  pt	Portugais

• model_parameters : Facultatif. Type STRING. Spécifie les paramètres du modèle, tels que max_tokens, temperature et top_p. Le format attendu est une chaîne JSON :

  '{"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}'.

  • max_tokens : Nombre maximal de jetons à générer lors d'un seul appel au modèle. Pour les modèles publics MaxCompute, la valeur par défaut est 4 096.

  • temperature : Valeur comprise entre 0 et 1 qui contrôle le caractère aléatoire de la sortie. Une valeur plus élevée produit des résultats plus créatifs et diversifiés, tandis qu'une valeur plus faible génère des sorties plus déterministes et conservatrices.

  • top_p : Valeur comprise entre 0 et 1 qui limite la plage des libellés candidats parmi lesquels le modèle peut choisir. Une valeur plus élevée permet une gamme plus large et une plus grande diversité, tandis qu'une valeur plus faible réduit la portée et produit des résultats plus ciblés.

Valeur renvoyée

Renvoie le texte traduit sous forme de valeur STRING.

• Si le paramètre input ou target_language n'est pas de type STRING, une erreur est renvoyée.

Exemples

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;

-- Result
+-------------------------------------------------------------------------------------------+
| translated_text                                                                           |
+-------------------------------------------------------------------------------------------+
| MaxCompute is a fast and fully managed computing platform for large-scale data warehousing. |
+-------------------------------------------------------------------------------------------+

-- Sample data
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');

-- Translate the same text into multiple target languages
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;

-- Results
+-----------------------------+------+-------------------------------+
| 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