Catatan dan contoh penggunaan odpscmd di Cloud Shell - MaxCompute

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

Prasyarat

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

Batasan

Catatan

Cloud Shell adalah tool command-line berbasis web yang disediakan oleh Alibaba Cloud yang memungkinkan Anda menggunakan odpscmd tanpa instalasi manual. Untuk informasi selengkapnya, lihat Apa itu Cloud Shell?.

Batasan Cloud Shell

Batas	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 akan dihapus 15 menit kemudian. Memulai ulang Cloud Shell akan membuat mesin virtual baru.
Kedaluwarsa	Setiap mesin virtual memiliki masa aktif 1 jam. Setelah kedaluwarsa, Cloud Shell akan segera menghapusnya. Memulai ulang Cloud Shell akan membuat mesin virtual baru.
Penyimpanan file	Cloud Shell menyediakan 10 GB storage space temporary di folder /home/shell. Ruang ini akan direset saat mesin virtual dihapus. Untuk penyimpanan persisten, mount bucket. Bucket akan dimuat secara otomatis setiap kali Cloud Shell dimulai.
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

Layanan Cloud Shell dan ruang penyimpanan sementaranya berada di wilayah Tiongkok (Shanghai) secara default, terlepas dari lokasi Anda menjalankan odpscmd. Jika proyek Anda berada di wilayah lain, transfer data lintas wilayah akan terjadi, yang dapat menimbulkan risiko keamanan data. Gunakan dengan hati-hati.

Masuk ke lingkungan odpscmd

Login ke MaxCompute console dan pilih wilayah di pojok kiri atas.
Pada panel navigasi kiri, pilih Manage Configurations > Projects.
Pada halaman 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 pemasangan 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 seperti 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 akan direset saat mesin virtual dihapus. Untuk penyimpanan persisten, mount sistem file NAS, yang akan dimuat secara otomatis oleh Cloud Shell setiap kali Anda memulai sesi.

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

Catatan

Pemasangan sistem file NAS dikenai biaya penyimpanan NAS. Lepaskan kaitan storage space tersebut jika sudah tidak diperlukan. Untuk informasi lebih lanjut mengenai biaya penyimpanan NAS, lihat Billing overview.

Gunakan odpscmd di Cloud Shell

odpscmd di Cloud Shell mendukung semua perintah SQL yang tersedia di client lokal. Contoh berikut menunjukkan cara menjalankan perintah SQL dan mentransfer data.

Jalankan perintah SQL

Buat tabel result_table1:

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 tersebut.

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 tersebut ada, jalankan perintah berikut untuk kembali ke lingkungan odpscmd:

cloudshell-odpscmd -p <project.name>

Unggah file result.txt ke MaxCompute:
```
tunnel upload result.txt result_table1;
```

Unduh file
1. Unduh tabel MaxCompute result_table1 ke Cloud Shell:
```
Tunnel download result_table1 result_table1.txt;
```
2. Klik ikon lalu pilih Download untuk menyimpan file result_table1.txt ke komputer lokal Anda.