Catatan penggunaan dan contoh Cloud Shell (odpscmd) - MaxCompute

MaxCompute terintegrasi dengan Alibaba Cloud Shell untuk menyediakan klien berbasis web berupa antarmuka baris perintah. Integrasi ini memungkinkan Anda menjalankan perintah odpscmd langsung dari browser tanpa perlu menginstal klien lokal. Topik ini mencakup hal-hal penting yang perlu diperhatikan serta memberikan contoh dasar untuk memulai penggunaan odpscmd di Cloud Shell.

Prasyarat

Jika Anda terhubung sebagai Pengguna RAM, pastikan pengguna tersebut memiliki izin AliyunCloudShellFullAccess. Untuk informasi lebih lanjut tentang pemberian izin, lihat Otorisasi Pengguna RAM.

Batasan

Catatan

Cloud Shell adalah alat baris perintah berbasis web yang disediakan oleh Alibaba Cloud. MaxCompute terintegrasi dengan Cloud Shell untuk menyediakan lingkungan klien yang telah dikonfigurasi sebelumnya, sehingga Anda dapat menggunakan odpscmd tanpa perlu melakukan instalasi manual. Untuk informasi selengkapnya tentang Cloud Shell, lihat Apa itu Cloud Shell?.

Batasan Cloud Shell

Item	Deskripsi
Jumlah VM	Hanya satu mesin virtual (VM) yang dapat dibuat dalam satu waktu, terlepas dari jumlah sesi Cloud Shell yang dibuka. Semua sesi Cloud Shell yang aktif secara otomatis terhubung ke VM tersebut.
Jumlah jendela sesi	Maksimal lima sesi dapat dibuka secara bersamaan.
Penghapusan VM karena tidak ada interaksi	Jika tidak ada operasi interaktif selama 30 menit atau semua sesi ditutup, VM akan dihapus dalam waktu 15 menit. Saat Anda memulai ulang Cloud Shell, VM baru akan dibuat.
Penghapusan VM saat masa berlaku habis	VM yang dibuat oleh Cloud Shell hanya berlaku selama 1 jam. Setelah masa berlaku VM habis, Cloud Shell akan langsung menghapus VM tersebut. Saat Anda memulai ulang Cloud Shell, VM baru akan dibuat.
Penyimpanan file	Cloud Shell menyediakan ruang penyimpanan sementara sebesar 10 GB. Anda dapat menyimpan file di direktori /home/shell. Namun, direktori ini akan direset ketika VM dihapus. Anda dapat memilih untuk memasang ruang penyimpanan tambahan, yang akan dimuat secara otomatis setiap kali Cloud Shell dimulai.
Larangan	Penggunaan jangka panjang atau proses berbahaya yang intensif komputasi dan jaringan tidak didukung. Dalam kasus tersebut, sesi mungkin dihentikan atau bahkan diblokir tanpa peringatan.

Wilayah yang didukung
Anda dapat menggunakan Cloud Shell untuk terhubung ke proyek MaxCompute di wilayah-wilayah berikut: Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), dan Tiongkok (Shenzhen).

Catatan penggunaan

Residensi dan keamanan data: Layanan Cloud Shell dan ruang penyimpanan sementaranya dihosting di wilayah Tiongkok (Shanghai). Saat Anda terhubung ke proyek MaxCompute di wilayah lain, data Anda akan ditransfer lintas wilayah ke Shanghai untuk diproses. Pastikan transfer data lintas wilayah ini sesuai dengan kebijakan residensi data organisasi Anda sebelum melanjutkan.

Mulai odpscmd di Cloud Shell

Masuk ke Konsol MaxCompute dan pilih wilayah di pojok kiri atas.
Pada halaman Workspace > Projects, klik Command Line di pojok kanan atas.
Pada kotak dialog Choose Project, pilih proyek yang ingin Anda kelola lalu klik OK.
Catatan
Jika muncul kotak dialog tentang pemasangan sistem file NAS, Anda dapat memasangnya sesuai kebutuhan. Untuk informasi selengkapnya, lihat (Opsional) Pasang sistem file NAS.
Setelah Cloud Shell (odpscmd) dimuat, antarmuka akan muncul seperti pada gambar berikut.

(Opsional) Pasang sistem file NAS

Cloud Shell menyediakan ruang penyimpanan sementara sebesar 10 GB. Ruang ini akan direset ketika mesin virtual dihapus. Untuk Penyimpanan persisten, Anda dapat memasang sistem file NAS, yang akan dimuat secara otomatis setiap kali Cloud Shell dimulai. Untuk memasang sistem file NAS, lakukan langkah-langkah berikut.

Pada jendela MaxCompute Cloud CMD, klik ikon , pilih Mount Storage Space, lalu sambungkan sistem file NAS.

Catatan

Pemasangan sistem file NAS dikenai biaya penyimpanan. Setelah selesai menggunakan sistem file tersebut, segera lepaskan. Untuk informasi selengkapnya tentang biaya penyimpanan NAS, lihat Ikhtisar penagihan.

Gunakan Cloud Shell (odpscmd)

Cloud Shell (odpscmd) untuk MaxCompute mendukung semua perintah SQL yang dapat dijalankan pada klien lokal. Bagian ini memberikan contoh cara menjalankan perintah SQL dan mentransfer data menggunakan Cloud Shell (odpscmd).

Jalankan perintah SQL

Untuk membuat tabel bernama result_table1, jalankan perintah berikut:

CREATE TABLE IF NOT EXISTS result_table1 (
 education STRING comment 'Education level',
 num BIGINT comment 'Number of people');

Setelah tabel dibuat, jalankan perintah berikut untuk melihatnya:

SHOW TABLES;

Transmisi data

Unggah file
1. Klik ikon dan pilih Upload untuk mengunggah file lokal. Topik ini menggunakan file result.txt sebagai contoh.
  Setelah unggahan selesai, tekan Ctrl+C untuk keluar dari lingkungan Cloud Shell (odpscmd). Kemudian, jalankan perintah ll untuk memverifikasi bahwa file telah diunggah dan melihat path filenya.
  Setelah memastikan file telah diunggah, jalankan perintah berikut untuk kembali ke lingkungan Cloud Shell (odpscmd):
```
cloudshell-odpscmd -p <project.name>
```
2. Jalankan perintah berikut untuk mengunggah file result.txt ke MaxCompute:
```
tunnel upload result.txt result_table1;
```
Unduh file
1. Jalankan perintah berikut untuk mengunduh tabel result_table1 dari MaxCompute ke Cloud Shell (odpscmd):
```
Tunnel download result_table1 result_table1.txt;
```
2. Klik ikon dan pilih Download untuk mengunduh file result_table1.txt ke komputer lokal Anda.
  Setelah unduhan selesai, hasilnya ditampilkan pada gambar berikut.