全部产品
Search
文档中心

MaxCompute:Instal dan mulai klien MaxCompute

更新时间:Jul 02, 2025

Klien MaxCompute (odpscmd) berjalan langsung di komputer lokal Anda dan menyediakan cara sederhana serta efisien untuk menjalankan perintah serta mengelola layanan MaxCompute. Topik ini menjelaskan cara menginstal dan memulai klien MaxCompute. Setelah klien dimulai, proyek MaxCompute akan terhubung.

Prasyarat

Sebelum menginstal klien MaxCompute, pastikan kondisi berikut terpenuhi:

  • Java 8 atau versi lebih baru telah diinstal pada mesin tempat Anda ingin menginstal klien MaxCompute.

  • Proyek MaxCompute telah dibuat.

    Untuk informasi lebih lanjut tentang cara membuat proyek MaxCompute, lihat Buat Proyek MaxCompute.

  • Pengguna RAM dari klien MaxCompute telah ditambahkan ke proyek MaxCompute target.

    Untuk informasi lebih lanjut tentang cara menambahkan anggota ke ruang kerja DataWorks, lihat Berikan Izin kepada Pengguna RAM.

Batasan

Klien MaxCompute V0.28.0 dan versi lebih baru mendukung Java Development Kit (JDK) 1.8 dan JDK 1.9. Klien MaxCompute dengan versi lebih lama dari V0.28.0 hanya mendukung JDK 1.8. Versi klien dapat dilihat di CLI setelah Anda memulai klien MaxCompute. Untuk informasi lebih lanjut tentang cara memulai klien MaxCompute, lihat Jalankan Klien MaxCompute.

Instal dan konfigurasikan klien MaxCompute

Catatan

Klien MaxCompute V0.27.0 dan versi lebih baru mendukung edisi tipe data MaxCompute V2.0. Kami merekomendasikan penggunaan edisi tipe data MaxCompute V2.0. Untuk informasi lebih lanjut tentang tipe data yang didukung oleh edisi tipe data MaxCompute V2.0, lihat Edisi Tipe Data MaxCompute V2.0.

Untuk menginstal dan mengonfigurasi klien MaxCompute, ikuti langkah-langkah berikut:

  1. Unduh paket instalasi klien MaxCompute dari GitHub.

    Catatan
    • Anda dapat mengklik tautan di atas untuk mengunduh paket instalasi klien MaxCompute versi terbaru odpscmd_public.zip di halaman yang muncul.

    • Jika Anda tidak dapat mengunduh paket setelah mengklik tautan di atas, klik Paket Instalasi Klien MaxCompute untuk mengunduh paket.

  2. Ekstrak paket yang diunduh untuk mendapatkan folder bin, conf, lib, dan plugins.

  3. Buka folder conf dan konfigurasikan file odps_config.ini.

    Dalam file odps_config.ini, baris yang dimulai dengan tanda pagar (#) adalah komentar. Tabel berikut menjelaskan parameter dalam file odps_config.ini.

    Parameter

    Wajib

    Deskripsi

    Contoh

    project_name

    Ya

    Nama proyek MaxCompute yang ingin Anda akses.

    Jika Anda membuat ruang kerja dalam mode standar, perhatikan perbedaan nama proyek antara lingkungan produksi dan lingkungan pengembangan (_dev) saat Anda mengonfigurasi parameter project_name. Untuk informasi lebih lanjut, lihat Perbedaan antara ruang kerja dalam mode dasar dan ruang kerja dalam mode standar.

    Untuk mendapatkan nama proyek MaxCompute, lakukan langkah-langkah berikut: Masuk ke Konsol MaxCompute. Di bilah navigasi atas, pilih wilayah. Di panel navigasi sebelah kiri, pilih Workspace > Projects. Pada halaman Projects, lihat nama proyek MaxCompute.

    doc_test_dev

    access_id

    Ya

    ID AccessKey akun Alibaba Cloud atau pengguna RAM Anda.

    Anda dapat mengklik foto profil di sudut kanan atas konsol MaxCompute dan memilih Manajemen AccessKey untuk mendapatkan ID AccessKey.

    Tidak ada

    access_key

    Ya

    Rahasia AccessKey yang sesuai dengan ID AccessKey.

    Tidak ada

    end_point

    Ya

    Dapatkan titik akhir proyek MaxCompute.

    Anda harus mengonfigurasi parameter ini berdasarkan wilayah dan metode koneksi jaringan yang Anda pilih saat membuat proyek MaxCompute. Untuk informasi lebih lanjut tentang titik akhir yang sesuai dengan wilayah dan jenis koneksi jaringan yang berbeda, lihat Titik Akhir.

    Penting
    • Nilai parameter ini adalah titik akhir MaxCompute, yang digunakan untuk mengakses MaxCompute bukan MaxCompute Tunnel.

    • Jika Anda menentukan titik akhir yang tidak valid, kesalahan akan terjadi saat Anda mengakses proyek MaxCompute.

    http://service.cn-hangzhou.maxcompute.aliyun.com/api

    log_view_host

    Tidak

    Uniform Resource Locator (URL) LogView. Anda dapat melihat informasi waktu proses rinci pekerjaan menggunakan URL ini. Informasi ini membantu Anda menyelesaikan kesalahan pekerjaan.

    Catatan

    Kami merekomendasikan Anda mengonfigurasi parameter ini. Jika Anda tidak mengonfigurasi parameter ini, Anda tidak dapat mengidentifikasi penyebab kesalahan pekerjaan.

    http://logview.odps.aliyun.com

    https_check

    Tidak

    Menentukan apakah akan mengaktifkan akses HTTPS. Jika akses HTTPS diaktifkan, permintaan untuk mengakses proyek MaxCompute dienkripsi. Nilai yang valid:

    • True: Akses HTTPS diaktifkan.

    • False: Akses HTTP diaktifkan.

    Nilai default: False.

    True

    data_size_confirm

    Tidak

    Ukuran maksimum data masukan. Unit: GB. Anda dapat mengatur parameter ini ke nilai apa pun. Kami merekomendasikan Anda mengatur parameter ini ke 100.

    100

    update_url

    Tidak

    Parameter cadangan.

    Tidak ada

    use_instance_tunnel

    Tidak

    Menentukan apakah akan menggunakan InstanceTunnel untuk mengunduh hasil eksekusi pernyataan SQL. Nilai yang valid:

    • True: InstanceTunnel digunakan untuk mengunduh hasil eksekusi pernyataan SQL.

    • False: InstanceTunnel tidak digunakan untuk mengunduh hasil eksekusi pernyataan SQL.

    Nilai default: False.

    True

    instance_tunnel_max_record

    Tidak

    Jumlah maksimum hasil eksekusi SQL yang dapat dikembalikan oleh klien. Jika parameter use_instance_tunnel diatur ke True, Anda harus mengonfigurasi parameter ini. Nilai maksimum: 10000.

    10000

    tunnel_endpoint

    Tidak

    Titik akhir publik MaxCompute Tunnel. Jika Anda tidak mengonfigurasi parameter ini, lalu lintas secara otomatis dirutekan ke titik akhir Tunnel yang sesuai dengan jaringan tempat MaxCompute berada. Jika Anda mengonfigurasi parameter ini, lalu lintas dirutekan ke titik akhir yang ditentukan dan perutean otomatis tidak dilakukan.

    Untuk informasi lebih lanjut tentang titik akhir Tunnel yang sesuai dengan setiap wilayah dan jaringan, lihat Titik Akhir.

    http://dt.cn-hangzhou.maxcompute.aliyun.com

    set.<key>

    Tidak

    Properti proyek MaxCompute.

    Untuk informasi lebih lanjut tentang properti proyek MaxCompute, lihat Properti.

    set.odps.sql.decimal.odps2=true

    Catatan

    Pastikan pengaturan parameter di atas valid. Pengaturan yang tidak valid akan mengakibatkan kegagalan koneksi proyek.

Mulai klien MaxCompute

Anda dapat memulai klien MaxCompute menggunakan salah satu metode berikut:

Metode 1: Mulai klien MaxCompute menggunakan file skrip dari paket instalasi

Di folder bin di direktori instalasi klien MaxCompute, klik dua kali file odpscmd.bat untuk sistem operasi Windows (OS) atau file odpscmd untuk macOS untuk memulai klien MaxCompute. Jika informasi seperti gambar berikut ditampilkan, proyek MaxCompute berhasil terhubung.image.png

Metode 2: Mulai klien MaxCompute menggunakan CLI sistem

Di CLI sistem, masuk ke folder bin di direktori instalasi klien MaxCompute dan jalankan perintah odpscmd untuk sistem operasi Windows atau jalankan perintah sh odpscmd untuk sistem operasi macOS atau Linux untuk memulai klien MaxCompute. Jika informasi seperti gambar berikut ditampilkan, proyek MaxCompute berhasil terhubung.

Catatan

Kesalahan dikembalikan saat Anda menjalankan perintah sh odpscmd di Ubuntu. Anda dapat menjalankan perintah ./odpscmd untuk memulai klien MaxCompute.

image.png

Jika Anda memulai klien MaxCompute menggunakan CLI sistem, Anda dapat menentukan parameter untuk menjalankan perintah. Untuk informasi lebih lanjut, lihat Tentukan Parameter Startup.

Apa yang harus dilakukan selanjutnya

Setelah memulai klien MaxCompute, Anda dapat melakukan operasi berikut:

  • Buat tabel di proyek MaxCompute yang terhubung. Untuk informasi lebih lanjut tentang cara membuat tabel, lihat Buat Tabel.

  • Impor data ke tabel yang dibuat. Untuk informasi lebih lanjut, lihat Impor Data ke Tabel.

  • Unggah sumber daya seperti file dan paket JAR. Untuk informasi lebih lanjut, lihat Operasi Sumber Daya.

Referensi