All Products
Search

This Product

    MaxCompute:AI_TRANSLATE

    Document Center

    MaxCompute:AI_TRANSLATE

    Last Updated:Jul 25, 2026

    AI_TRANSLATE adalah fungsi AI MaxCompute yang memanggil model untuk menerjemahkan teks input ke dalam bahasa tertentu.

    Sintaksis 

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

    Parameter

    • model_name: Wajib diisi. STRING. Nama model yang akan digunakan. Untuk informasi selengkapnya, lihat Fungsi AI SQL.

    • version_name: Wajib diisi. STRING. Versi model yang akan digunakan. Untuk memanggil versi default, masukkan DEFAULT_VERSION.

    • input: Wajib diisi. STRING. Teks yang akan diterjemahkan.

    • target_language: Wajib diisi. STRING. Bahasa target untuk terjemahan, ditentukan sebagai kode bahasa ISO-639. Kode bahasa berikut didukung:

      Kode bahasa

      Bahasa

      zh

      Chinese

      en

      English

      es

      Spanish

      fr

      French

      de

      German

      ja

      Japanese

      ko

      Korean

      ru

      Russian

      ar

      Arabic

      pt

      Portuguese

    • model_parameters: Opsional. STRING. Menentukan parameter model seperti max_tokens, temperature, dan top_p. Formatnya berupa string JSON:

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

      • max_tokens: Jumlah maksimum token yang dihasilkan dalam satu panggilan model. Untuk model publik MaxCompute, nilai default-nya adalah 4.096.

      • temperature: Nilai antara 0 dan 1 yang mengontrol tingkat keacakan output. Nilai yang lebih tinggi menghasilkan output yang lebih kreatif dan beragam, sedangkan nilai yang lebih rendah menghasilkan output yang lebih deterministik dan konservatif.

      • top_p: Nilai antara 0 dan 1 yang membatasi rentang label kandidat yang dapat dipilih oleh model. Nilai yang lebih tinggi memungkinkan rentang yang lebih luas dan variasi yang lebih besar, sedangkan nilai yang lebih rendah mempersempit rentang dan menghasilkan output yang lebih fokus.

    Nilai kembalian

    Mengembalikan teks terjemahan sebagai nilai STRING.

    • Jika parameter input atau target_language bukan tipe STRING, sistem akan mengembalikan error.

    Contoh

    Contoh 1: Menerjemahkan teks ke bahasa tertentu

    Memanggil model publik qwen3.7-max yang disediakan oleh MaxCompute untuk menerjemahkan kalimat berbahasa Inggris ke dalam bahasa Chinese.

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

    Contoh 2: Menerjemahkan data tabel ke beberapa bahasa

    Memanggil model publik deepseek-v4-pro yang disediakan oleh MaxCompute untuk menerjemahkan teks berbahasa Inggris yang sama ke dalam bahasa Chinese, Japanese, French, dan Spanish dalam satu kueri.

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

    FAQ

    Penyelesaian masalah umum dengan model publik

    Gejala: Saat Anda memanggil model publik yang didukung oleh layanan komputasi model, pesan error berikut dikembalikan.

    FAILED: ODPS-0130071:[1,8] Semantic analysis exception - inference quota status check failed, error message: region cn-shanghai not found in inference quota

    Penyebab: Layanan komputasi model belum diaktifkan untuk wilayah tempat proyek Anda berada, misalnya China (Shanghai). Akibatnya, sumber daya Inferensi AI tidak dapat dipanggil.

    Solusi: Buka Konsol Manajemen Alibaba Cloud untuk mengaktifkan layanan komputasi model di wilayah tempat proyek Anda berada. Untuk informasi selengkapnya, lihat Pembelian dan penggunaan layanan komputasi model MaxCompute.