Catatan dan contoh penggunaan odpscmd di Cloud Shell - MaxCompute

MaxCompute terintegrasi dengan Cloud Shell untuk menyediakan lingkungan client berbasis cloud, sehingga Anda dapat menggunakan odpscmd tanpa perlu menginstalnya secara manual. Topik ini mencakup catatan dan contoh penggunaan odpscmd di Cloud Shell.

Prasyarat

Jika Anda masuk ke odpscmd di Cloud Shell sebagai pengguna RAM, pengguna tersebut harus memiliki izin AliyunCloudShellFullAccess. Untuk informasi selengkapnya, lihat Resource Access Management (RAM).

Batasan

Catatan

Cloud Shell adalah alat command-line berbasis web yang disediakan oleh Alibaba Cloud. MaxCompute menyediakan lingkungan client berbasis cloud melalui Cloud Shell, sehingga Anda dapat menggunakan odpscmd tanpa instalasi manual. Untuk informasi selengkapnya tentang Cloud Shell, lihat Apa itu Cloud Shell?.

Batasan Cloud Shell

Batasan	Deskripsi
Mesin virtual	Hanya satu mesin virtual yang berjalan dalam satu waktu. Semua jendela sesi terhubung ke mesin tersebut secara otomatis.
Jendela sesi	Anda dapat membuka hingga lima jendela sesi.
Timeout tidak aktif	Setelah 30 menit tidak aktif atau ketika semua jendela sesi ditutup, sesi akan berhenti. Mesin virtual dihapus 15 menit kemudian. Menjalankan ulang Cloud Shell akan membuat mesin virtual baru.
Kedaluwarsa	Setiap mesin virtual memiliki masa aktif 1 jam. Setelah kedaluwarsa, Cloud Shell segera menghapusnya. Menjalankan ulang Cloud Shell akan membuat mesin virtual baru.
File storage	Cloud Shell menyediakan 10 GB storage space temporary di folder /home/shell. Ruang penyimpanan ini direset saat mesin virtual dihapus. Untuk penyimpanan persisten, mount bucket. Bucket tersebut dimuat secara otomatis setiap kali Cloud Shell dijalankan.
Penggunaan yang dilarang	Tugas yang intensif komputasi, intensif jaringan, tugas berjalan lama, dan proses berbahaya dilarang. Pelanggaran dapat menyebabkan sesi Anda dihentikan atau dinonaktifkan tanpa pemberitahuan.

Batasan wilayah

Saat ini, Anda hanya dapat menggunakan Cloud Shell untuk terhubung ke MaxCompute di wilayah-wilayah berikut: Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), dan Tiongkok (Shenzhen).

Catatan penggunaan

Terlepas dari wilayah tempat Anda menjalankan odpscmd untuk MaxCompute, layanan Cloud Shell dan ruang penyimpanan sementaranya berada di wilayah Tiongkok (Shanghai) secara default. Jika Proyek Anda berada di wilayah yang berbeda, penggunaan fitur ini akan mengakibatkan transfer data lintas wilayah, yang dapat menimbulkan risiko keamanan data. Gunakan dengan hati-hati.

Masuk ke lingkungan odpscmd

Login 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 prompt tentang memasang sistem file NAS, Anda dapat memasangnya sesuai kebutuhan. Untuk informasi selengkapnya, lihat (Opsional) Mount a NAS file system.

Setelah odpscmd dimuat di Cloud Shell, output-nya mirip dengan berikut:

inflating: odpscmd_pub/plugins/cupid/lib/jackson-core-2.9.5.jar
inflating: odpscmd_pub/plugins/cupid/lib/odps-console-cupid-public-0.43.1-public.jar
inflating: odpscmd_pub/plugins/cupid/plugin.ini
inflating: odpscmd_pub/plugins/volume2/lib/odps-console-volume2-0.43.1-public.jar
inflating: odpscmd_pub/plugins/volume2/lib/odps-sdk-volumefs-0.43.1-public.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-shaded-protobuf_3_7-1.1.1.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-annotations-3.3.3.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-auth-3.3.3.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-common-3.3.3.jar
/home/shell
Aliyun ODPS Command Line Tool
Version 0.43.1-public
@Copyright 2020 Alibaba Cloud Computing Co., Ltd. All rights reserved.
Connecting to http://service.odps.aliyun.com/api, project: xxx
Endpoint: http://service.odps.aliyun.com/api
Project: xxx
Schema: default
Quota: default in region N/A
Timezone: Asia/Shanghai
Connected!
xxx (default)>

(Opsional) Mount NAS

Cloud Shell menyediakan ruang penyimpanan sementara sebesar 10 GB yang direset saat mesin virtual dihapus. Untuk penyimpanan persisten, Anda dapat memasang sistem file NAS, yang secara otomatis dimuat oleh Cloud Shell setiap kali Anda memulai sesi. Langkah-langkah berikut menjelaskan cara memasang sistem file NAS.

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

Catatan

Pemasangan sistem file NAS dikenai biaya penyimpanan NAS. Lepaskan ikatan ruang penyimpanan tersebut jika sudah tidak diperlukan. Untuk informasi selengkapnya tentang biaya penyimpanan NAS, lihat Billing overview.

Gunakan odpscmd di Cloud Shell

odpscmd di Cloud Shell mendukung semua perintah SQL yang dapat dijalankan oleh client lokal. Bagian berikut menunjukkan cara menggunakan odpscmd untuk menjalankan perintah SQL dan mentransfer data.

Jalankan perintah SQL

Buat tabel result_table1. Berikut adalah contoh perintahnya.

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;

Transfer data

Unggah file

Klik ikon lalu pilih Upload untuk mentransfer file lokal. Topik ini menggunakan file result.txt sebagai contoh.

Setelah unggahan selesai, tekan Ctrl+c untuk keluar dari lingkungan Cloud Shell (odpscmd), lalu jalankan perintah ll untuk memeriksa apakah unggahan berhasil dan melihat path file.

shell@Alicloud:~$ ll
total 24
drwxr-xr-x 3 shell shell 4096 Jul 19 08:21 ./
drwxr-xr-x 1 root  root  4096 Jul 19 08:00 ../
-rw------- 1 shell shell  292 Jul 19 08:22 .bash_history
drwx------ 3 shell shell 4096 Jul 19 08:00 .config/
-rw-r--r-- 1 shell shell  325 Jul 19 08:15 .odpscmd.history
-rw-r--r-- 1 shell shell   30 Jul 19 08:21 result.txt
-rw-r--r-- 1 shell shell    0 Jul 19 08:09 whoami
shell@Alicloud:~$

Setelah memastikan file tersedia, jalankan perintah berikut untuk kembali ke lingkungan odpscmd:

cloudshell-odpscmd -p <project.name>

Unggah file result.txt ke MaxCompute. Berikut adalah contoh perintahnya.
```
tunnel upload result.txt result_table1;
```

Unduh file
1. Berikut adalah contoh perintah untuk mengunduh tabel MaxCompute result_table1 ke Cloud Shell (odpscmd).
```
Tunnel download result_table1 result_table1.txt;
```
2. Klik ikon lalu pilih Download untuk menyimpan file result_table1.txt ke komputer lokal Anda.