MaxCompute：Koneksi menggunakan client lokal (odpscmd)

Penagihan

Anda tidak dikenai biaya untuk menghubungkan ke proyek menggunakan client MaxCompute. Namun, operasi yang Anda lakukan melalui client tersebut dapat menimbulkan biaya MaxCompute. Misalnya, jika Anda menggunakan client untuk mengirimkan kueri SQL dan perintah write, perintah SQL tersebut mengonsumsi sumber daya komputasi saat dijalankan di MaxCompute, dan data yang ditulis menempati storage space. Hal ini menghasilkan biaya komputasi dan penyimpanan. Untuk informasi selengkapnya tentang penagihan MaxCompute, lihat Item yang dikenai biaya dan metode penagihan.

Instal dan konfigurasikan klien MaxCompute

Client mendukung edisi tipe data MaxCompute V2.0 mulai dari V0.27.0. Kami merekomendasikan penggunaan tipe data baru. Untuk daftar tipe data yang didukung, lihat Edisi tipe data.

Ikuti langkah-langkah berikut:

1. Unduh paket instalasi client MaxCompute (GitHub).

   Catatan

   • Klik tautan untuk membuka halaman rilis client dan unduh versi terbaru paket instalasi client MaxCompute (odpscmd_public.zip).

   • Jika Anda tidak dapat mengunduh paket dari tautan di atas, coba klik paket instalasi client MaxCompute (OSS) untuk mengunduhnya. Jika tautan GitHub gagal, kami sarankan Anda mencari solusi di mesin pencari.

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

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

   Pada file odps_config.ini, baris yang diawali tanda pagar (#) merupakan komentar. Tabel berikut menjelaskan parameter-parameter tersebut.

   Parameter	Diperlukan	Deskripsi	Contoh
   project_name	Ya	Nama proyek MaxCompute target yang ingin Anda akses. Jika Anda membuat ruang kerja dalam mode standar, perhatikan perbedaan antara nama proyek untuk lingkungan produksi dan lingkungan pengembangan (_dev) saat mengonfigurasi parameter project_name. Untuk informasi selengkapnya, lihat Perbedaan antar 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, Anda dapat menemukan nama proyek MaxCompute Anda.	doc_test_dev
   access_id	Ya	ID AccessKey Akun Alibaba Cloud atau Pengguna RAM Anda. Anda dapat membuka halaman AccessKey Management untuk mendapatkan ID AccessKey tersebut.	Tidak ada
   access_key	Ya	Rahasia AccessKey yang sesuai dengan ID AccessKey.	Tidak ada
   end_point	Ya	Titik akhir layanan MaxCompute. Konfigurasikan titik akhir berdasarkan wilayah dan jenis koneksi jaringan yang Anda pilih saat membuat proyek MaxCompute. Untuk informasi tentang titik akhir berbagai wilayah dan jaringan, lihat Endpoints. Penting Titik akhir ini digunakan untuk layanan MaxCompute, sedangkan titik akhir Tunnel digunakan untuk layanan MaxCompute Tunnel. Masukkan titik akhir layanan MaxCompute di sini. Jika titik akhir dikonfigurasi salah, akan terjadi error akses. Pastikan titik akhir tersebut benar.	http://service.cn-hangzhou.maxcompute.aliyun.com/api
   log_view_host	Tidak	Alamat Logview. Kami merekomendasikan Anda mengonfigurasi parameter ini. Jika tidak dikonfigurasi, Anda tidak dapat dengan cepat menemukan masalah ketika pekerjaan gagal. Anda dapat menggunakan alamat ini untuk melihat informasi waktu proses detail suatu pekerjaan, yang menjadi dasar untuk troubleshooting. Nilainya tetap di http://logview.odps.aliyun.com.	http://logview.odps.aliyun.com
   https_check	Tidak	Menentukan apakah akses HTTPS diaktifkan untuk mengenkripsi permintaan saat mengakses proyek MaxCompute. Nilai yang valid: True: Menggunakan HTTPS. False: Menggunakan HTTP. Nilai default: False.	True
   data_size_confirm	Tidak	Ukuran maksimum data masukan dalam GB. Parameter ini tidak memiliki batasan rentang nilai. Kami merekomendasikan Anda mengatur parameter ini ke 100 GB.	100
   update_url	Tidak	Parameter cadangan yang dapat Anda abaikan.	Tidak ada
   use_instance_tunnel	Tidak	Menentukan apakah akan menggunakan InstanceTunnel untuk mengunduh hasil eksekusi pernyataan SQL. Nilai valid: True: Gunakan InstanceTunnel untuk mengunduh hasil eksekusi pernyataan SQL. False: Jangan gunakan InstanceTunnel untuk mengunduh hasil eksekusi pernyataan SQL. Nilai default: False.	True
   instance_tunnel_max_record	Tidak	Jumlah maksimum catatan yang dapat dikembalikan client untuk hasil eksekusi SQL. Jika Anda mengatur use_instance_tunnel ke True, Anda harus mengonfigurasi parameter ini. Nilai maksimum adalah 10000.	10000
   tunnel_endpoint	Tidak	Titik akhir publik layanan Tunnel. Jika Anda tidak mengonfigurasi titik akhir Tunnel, Tunnel secara otomatis mengarahkan traffic ke titik akhir Tunnel yang sesuai dengan jaringan tempat layanan MaxCompute berada. Jika Anda mengonfigurasi titik akhir Tunnel, titik akhir yang dikonfigurasi tersebut akan digunakan, dan routing otomatis tidak dilakukan. Untuk informasi tentang titik akhir Tunnel berbagai wilayah dan jaringan, lihat Endpoints.	http://dt.cn-hangzhou.maxcompute.aliyun.com
   set.<key>	Tidak	Mengatur properti proyek MaxCompute. Untuk informasi selengkapnya tentang properti, lihat Properties.	set.odps.sql.decimal.odps2=true

   Pastikan informasi di atas dikonfigurasi dengan benar. Konfigurasi yang salah akan menyebabkan koneksi ke proyek gagal.

Jalankan klien MaxCompute

1. Buat proyek MaxCompute.

2. Jika Anda menggunakan Pengguna RAM untuk menjalankan client MaxCompute, gunakan Akun Alibaba Cloud Anda untuk menambahkan Pengguna RAM tersebut ke proyek MaxCompute target. Untuk informasi selengkapnya tentang menambahkan anggota ruang kerja, lihat Berikan izin kepada pengguna lain.

3. Jalankan client MaxCompute menggunakan salah satu metode berikut:

   Metode 1: Gunakan file skrip dalam paket instalasi

   Pada folder bin direktori instalasi client MaxCompute, klik ganda file odpscmd.bat untuk Windows atau file odpscmd untuk macOS untuk menjalankan client MaxCompute. Jika informasi berikut dikembalikan, Anda telah berhasil terhubung ke proyek MaxCompute.

   Metode 2: Gunakan jendela command-line sistem operasi Anda

   Pada jendela command-line sistem operasi Anda, buka direktori bin path instalasi client MaxCompute. Jalankan perintah odpscmd untuk Windows atau sh odpscmd untuk Linux atau macOS untuk menjalankan client MaxCompute. Jika informasi berikut dikembalikan, Anda telah berhasil terhubung ke proyek MaxCompute.

   Catatan

   Jika Anda menjalankan sh odpscmd di Ubuntu, akan muncul error. Coba jalankan perintah ./odpscmd untuk menjalankan client.

   

   Jika Anda menjalankan client MaxCompute dari jendela command-line sistem operasi, Anda dapat menentukan parameter untuk menjalankan perintah. Untuk informasi selengkapnya tentang parameter tersebut, lihat Parameter startup.

Operasi terkait pada client MaxCompute

...\odpscmd\bin>odpscmd -h

odps@project_name>whoami;

odps@project_name>quit;
-- Perintah ini setara dengan perintah berikut.
odps@project_name>q;

Referensi

Setelah Anda masuk ke klien MaxCompute, Anda dapat menjalankan perintah SQL di proyek MaxCompute. Untuk informasi lebih lanjut, lihat Gunakan klien MaxCompute.

Untuk informasi selengkapnya tentang sintaks perintah yang didukung client MaxCompute, lihat Perintah umum atau Perintah dan fungsi SQL.

Tanya Jawab

Setelah mengonfigurasi file odps_config.ini, error umum berikut dapat terjadi saat Anda menjalankan client MaxCompute:

Parameter startup

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 jendela Shell atau Windows Command Prompt, Anda mungkin perlu menggunakan nilai kembali dinamis dari perintah odpscmd -e <SQL_statement>. Variabel Shell mendapatkan nilai kembali dinamis ini lalu menggunakannya dalam pekerjaan selanjutnya di Shell. Dalam skenario ini, nilai kembali tidak boleh berisi informasi tambahan seperti informasi waktu proses atau header tabel. Untuk memudahkan pemanggilan Shell, atur parameter use_instance_tunnel dalam file odps_config.ini ke false untuk menonaktifkan layanan Instance Tunnel. Kemudian, jalankan perintah set odps.sql.select.output.format={"needHeader":false,"fieldDelim":" "}; untuk menyembunyikan header tabel.

--Jalankan perintah berikut di Windows Command Prompt.
...\odpscmd\bin>odpscmd -e "set odps.sql.select.output.format={""needHeader"":false,""fieldDelim"":"" ""};select * from noheader;" >D:\test.txt
--Hasil disimpan di D:\test.txt.

--Jalankan perintah berikut di jendela Shell.
/Users/.../odpscmd/bin/odpscmd -e "set odps.sql.select.output.format={\"needHeader\":false,\"fieldDelim\":\"\"};select * from noheader;" >/Users/A/temp/test.txt 
--Hasil disimpan di /Users/A/temp/test.txt.
--Hasil berikut dikembalikan.
1
2
3

Riwayat pembaruan versi

Tabel berikut menjelaskan pembaruan versi terbaru client MaxCompute. Untuk informasi selengkapnya, klik tautan versi yang sesuai.

Untuk informasi selengkapnya tentang versi client MaxCompute dan pembaruan fitur terkait, lihat GitHub.