MaxCompute:Koneksi menggunakan client lokal (odpscmd)

Harga

Menghubungkan ke proyek MaxCompute menggunakan client gratis. Namun, operasi yang Anda jalankan melalui client tersebut dapat dikenai biaya MaxCompute. Misalnya, mengirimkan kueri SQL atau perintah write akan mengonsumsi sumber daya komputasi. Menulis data juga menggunakan ruang penyimpanan. Anda akan dikenai biaya untuk komputasi dan penyimpanan. Untuk detailnya, lihat Item dan metode penagihan.

Instal dan konfigurasikan client MaxCompute

Mulai dari v0.27.0, client mendukung tipe data MaxCompute V2.0 yang baru. Kami merekomendasikan penggunaan tipe data baru ini. Untuk daftar tipe data yang didukung, lihat Tipe data MaxCompute V2.0.

Ikuti langkah-langkah berikut:

1. Unduh paket client MaxCompute (GitHub).

   Catatan

   • Buka halaman rilis client melalui tautan di atas. Unduh paket client MaxCompute terbaru (odpscmd_public.zip).

   • Jika tautan di atas gagal, coba unduh paket client MaxCompute (OSS). Untuk masalah akses GitHub, cari solusinya di mesin pencari.

2. Ekstrak paket yang telah diunduh. Anda akan mendapatkan folder bin, conf, lib, dan plugins.

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

   File odps_config.ini menggunakan simbol hash (#) untuk komentar. Tabel berikut menjelaskan parameter-parameternya.

   Parameter	Wajib	Deskripsi	Contoh
   project_name	Ya	Nama proyek MaxCompute yang ingin Anda akses. Jika Anda membuat ruang kerja dalam mode standar, pastikan untuk membedakan antara nama proyek produksi dan pengembangan (_dev) saat mengonfigurasi project_name. Lihat Perbedaan antara mode ruang kerja. Login ke Konsol MaxCompute, lalu pilih wilayah di pojok kiri atas. Pada panel navigasi di sebelah kiri, pilih Manage Configurations > Projects. Pada halaman Projects, temukan nama proyek MaxCompute Anda.	doc_test_dev
   access_id	Ya	ID AccessKey Akun Alibaba Cloud atau Pengguna RAM Anda. Buka halaman AccessKey management untuk mendapatkan ID AccessKey Anda.	None
   access_key	Ya	Rahasia AccessKey yang sesuai dengan ID AccessKey Anda.	None
   end_point	Ya	Titik akhir untuk layanan MaxCompute. Atur berdasarkan wilayah dan jenis jaringan yang Anda pilih saat membuat proyek MaxCompute. Untuk daftar titik akhir berdasarkan wilayah dan jaringan, lihat Endpoint. Penting Titik akhir ini digunakan untuk layanan MaxCompute. Gunakan titik akhir Tunnel untuk layanan MaxCompute Tunnel. Masukkan titik akhir MaxCompute di sini. Titik akhir yang salah menyebabkan error koneksi. Periksa kembali entri Anda.	http://service.cn-hangzhou.maxcompute.aliyun.com/api
   log_view_host	Tidak	URL LogView. Kami merekomendasikan pengaturan parameter ini. Tanpa parameter ini, Anda tidak dapat dengan cepat menemukan masalah saat pekerjaan gagal. Anda dapat menggunakan URL ini untuk melihat informasi runtime pekerjaan secara detail dan memecahkan masalah error. Nilainya tetap: http://logview.odps.aliyun.com.	http://logview.odps.aliyun.com
   https_check	Tidak	Apakah akan mengaktifkan HTTPS untuk mengenkripsi permintaan ke proyek MaxCompute Anda. Nilai yang valid: True: Gunakan HTTPS. False: Gunakan HTTP. Default: False.	True
   data_size_confirm	Tidak	Ukuran maksimum data masukan dalam GB. Tidak ada batasan. Kami merekomendasikan 100 GB.	100
   update_url	Tidak	Parameter cadangan. Abaikan untuk saat ini.	None
   use_instance_tunnel	Tidak	Apakah akan menggunakan InstanceTunnel untuk mengunduh hasil kueri SQL. Nilai yang valid: True: Mengunduh hasil eksekusi SQL menggunakan InstanceTunnel. False: InstanceTunnel tidak digunakan untuk mengunduh hasil eksekusi SQL. Default: False.	True
   instance_tunnel_max_record	Tidak	Jumlah maksimum catatan yang dikembalikan untuk hasil kueri SQL. Atur jika use_instance_tunnel bernilai True. Maksimum: 10000.	10000
   tunnel_endpoint	Tidak	Titik akhir publik untuk layanan Tunnel. Jika Anda tidak mengatur titik akhir Tunnel, Tunnel secara otomatis merutekan ke titik akhir Tunnel untuk wilayah dan jaringan layanan MaxCompute Anda. Jika Anda mengatur titik akhir Tunnel, Tunnel menggunakan titik akhir tersebut dan tidak melakukan auto-routing. Untuk titik akhir Tunnel berdasarkan wilayah dan jaringan, lihat Endpoint.	http://dt.cn-hangzhou.maxcompute.aliyun.com
   set.<key>	Tidak	Atur properti untuk proyek MaxCompute Anda. Untuk daftar properti lainnya, lihat Property list.	set.odps.sql.decimal.odps2=true

   Pastikan semua pengaturan sudah benar. Pengaturan yang salah menyebabkan kegagalan koneksi.

Jalankan client MaxCompute

1. Buat proyek MaxCompute.

2. Jika Anda menggunakan Pengguna RAM untuk menjalankan client MaxCompute, tambahkan Pengguna RAM tersebut ke proyek MaxCompute target menggunakan Akun Alibaba Cloud Anda. Untuk detailnya, lihat Berikan izin kepada pengguna lain.

3. Jalankan client MaxCompute dengan salah satu cara berikut:

   Metode 1: File skrip dalam paket instalasi

   Di folder bin di bawah path instalasi client MaxCompute Anda, klik ganda odpscmd.bat (Windows) atau odpscmd (macOS). Ini akan menjalankan client MaxCompute. Anda akan melihat pesan berikut jika koneksi berhasil.

   Metode 2: Jendela command-line sistem

   Di jendela command-line sistem Anda, buka direktori bin di bawah path instalasi client MaxCompute Anda. Lalu jalankan odpscmd (Windows) atau sh odpscmd (Linux atau macOS). Ini akan menjalankan client MaxCompute. Anda akan melihat pesan berikut jika koneksi berhasil.

   Catatan

   Di Ubuntu, menjalankan sh odpscmd menghasilkan error. Coba gunakan ./odpscmd sebagai gantinya.

   

   Jika Anda menjalankan client MaxCompute dari command line sistem, Anda dapat meneruskan argumen untuk menjalankan perintah. Untuk daftar argumen lengkap, lihat Startup parameters.

Operasi terkait

...\odpscmd\bin>odpscmd -h

odps@project_name>whoami;

odps@project_name>quit;
-- Equivalent to:
odps@project_name>q;

Referensi

Setelah login ke client MaxCompute, Anda dapat menjalankan perintah SQL di proyek MaxCompute Anda. Lihat Gunakan MaxCompute dengan client.

Untuk sintaks perintah lengkap, lihat Common commands atau SQL commands and functions.

FAQ

Setelah mengonfigurasi file odps_config.ini dan menjalankan client MaxCompute, error umum meliputi:

Startup parameters

Usage: odpscmd [OPTION]...
where options include the following:
    --help                                  (-h)for help
    --config=<config_file>                  specify another config file
    --project=<prj_name>                    use project
    --endpoint=<http://host:port>           set endpoint
    -k <n>                                  will skip begining queries and start from specified position
    -r <n>                                  set retry times
    -f <"file_path;">                       execute command in file
    -e <"command;[command;]...">            execute command, include sql command

Di shell atau Windows command prompt, Anda mungkin perlu menangkap nilai kembali dinamis dari odpscmd -e <SQL statement> ke dalam variabel shell. Lalu gunakan variabel tersebut dalam tugas lanjutan. Untuk menghindari output tambahan seperti informasi runtime atau header tabel, atur parameter odps_config.ini use_instance_tunnel ke false. Ini akan menonaktifkan Instance Tunnel. Lalu jalankan set odps.sql.select.output.format={"needHeader":false,"fieldDelim":" "}; untuk menyembunyikan header tabel.

-- Run in Windows command prompt.
...\odpscmd\bin>odpscmd -e "set odps.sql.select.output.format={""needHeader"":false,""fieldDelim"":"" ""};select * from noheader;" >D:\test.txt
-- Output saves to D:\test.txt.

-- Run in shell.
/Users/.../odpscmd/bin/odpscmd -e "set odps.sql.select.output.format={\"needHeader\":false,\"fieldDelim\":\"\"};select * from noheader;" >/Users/A/temp/test.txt 
-- Output saves to /Users/A/temp/test.txt.
-- Output:
1
2
3

Riwayat versi

Tabel berikut mencantumkan pembaruan terbaru untuk client MaxCompute. Klik tautan setiap versi untuk detail lengkapnya.

Untuk versi dan pembaruan fitur lainnya, lihat GitHub.