Perintah Tunnel Umum - MaxCompute

MaxCompute memungkinkan Anda menjalankan perintah Tunnel untuk mengunggah dan mengunduh data. Topik ini menjelaskan cara menggunakan perintah Tunnel untuk mengunggah dan mengunduh data.

Untuk informasi lebih lanjut tentang operasi Tunnel, lihat Perintah Tunnel. Tabel berikut menjelaskan operasi umum.

Operasi	Deskripsi	Peran	Platform Operasi
Unggah Data	Mengunggah data lokal ke tabel MaxCompute dalam mode tambahan.	Pengguna yang memiliki izin Alter pada tabel	Klien MaxCompute (odpscmd)
Unduh Data	Mengunduh data tabel MaxCompute atau hasil eksekusi instance tertentu ke direktori di mesin lokal Anda.	Pengguna yang memiliki izin Select untuk membaca data tabel	Klien MaxCompute (odpscmd)

Unggah Data

Mengunggah data lokal ke tabel MaxCompute dalam mode tambahan. Pengunggahan data ke MaxCompute tidak dikenakan biaya.

Batasan
- Anda hanya dapat mengunggah file atau direktori level-1 ke satu tabel atau satu partisi dalam tabel setiap kali.
- Untuk tabel terpartisi, Anda harus menentukan partisi tempat Anda ingin mengunggah data. Jika tabel memiliki beberapa tingkat partisi, Anda harus menentukan partisi tingkat terendah.

Sintaksis

Tunnel upload <path> [<project_name>.]<table_name>[/<pt_spc>];

Parameter
- path: wajib. Direktori dan nama file data yang ingin diunggah dari mesin lokal. Format default file data adalah TXT.
  File data dapat disimpan di direktori bin klien MaxCompute. Dalam hal ini, parameter path harus ditetapkan dalam format Nama File.Ekstensi Nama File. File data juga dapat disimpan di direktori lain, seperti folder test di drive D. Dalam hal ini, parameter path harus ditetapkan dalam format D:\test\Nama File.Ekstensi Nama File.
  Catatan
  Di macOS, nilai parameter path harus berupa jalur absolut. Misalnya, jika file data disimpan di direktori bin klien MaxCompute, parameter path harus ditetapkan dalam format /Users/nama pengguna/MaxCompute/bin/nama file.ekstensi nama file.
- project_name: opsional. Nama proyek tempat tabel tujuan berada. Parameter ini diperlukan saat mengakses tabel lintas proyek.
- table_name: wajib. Nama tabel tujuan.
- pt_spc: opsional. Partisi yang ditentukan dalam tabel terpartisi. Anda harus menentukan partisi tingkat terendah. Nilai parameter ini dalam format kolom_partisi1=nilai_kolom1, kolom_partisi2=nilai_kolom2....
Contoh
- Contoh 1: Unggah data dalam file log.txt ke tabel test_table proyek saat ini. File log.txt disimpan di folder bin klien MaxCompute. Contoh perintah:
```
Tunnel upload log.txt test_table;
```
- Contoh 2: Unggah data dalam file log.txt ke partisi p1="b1",p2="b2" dari tabel test_table di proyek test_project. Tabel tersebut memiliki dua tingkat partisi. File log.txt disimpan di folder test pada drive D. Contoh perintah:
```
Tunnel upload D:\test\log.txt test_project.test_table/p1="b1",p2="b2";
```

Unduh Data

Mengunduh data tabel MaxCompute atau hasil eksekusi instance tertentu ke direktori di mesin lokal. Data MaxCompute hanya dapat diunduh melalui Internet. Biaya unduhan dihitung berdasarkan ukuran data dengan rumus berikut: Biaya per unduhan = Jumlah data yang diunduh (GB) × Harga satuan unduhan (USD 0.1166/GB).

Batasan
- Anda hanya dapat mengunduh data dari satu tabel atau satu partisi ke satu file lokal setiap kali.
- Untuk tabel terpartisi, Anda harus menentukan partisi tempat Anda ingin mengunduh data. Jika tabel memiliki beberapa tingkat partisi, Anda harus menentukan partisi tingkat terendah.

Sintaksis

Tunnel download [<project_name>.]<table_name>[/<pt_spc>] <path>;

Parameter
- project_name: opsional. Nama proyek tempat tabel tujuan berada. Parameter ini diperlukan saat mengakses tabel lintas proyek.
- table_name: wajib. Nama tabel tujuan.
- pt_spc: opsional. Partisi yang ditentukan dalam tabel terpartisi. Anda harus menentukan partisi tingkat terendah. Nilai parameter ini dalam format kolom_partisi1=nilai_kolom1, kolom_partisi2=nilai_kolom2....
- path: wajib. Direktori dan nama file data yang diunduh. Format default file data yang diunduh adalah TXT.
  File data dapat disimpan di direktori bin klien MaxCompute. Dalam hal ini, parameter path harus ditetapkan dalam format Nama File.Ekstensi Nama File. File data juga dapat disimpan di direktori lain, seperti folder test di drive D. Dalam hal ini, parameter path harus ditetapkan dalam format D:\test\Nama File.Ekstensi Nama File.
Contoh
- Contoh 1: Unduh data dari tabel bertingkat dua test_project.test_table ke file test_table.txt. File test_table.txt disimpan di folder bin klien MaxCompute. Contoh perintah:
```
Tunnel download test_project.test_table/p1="b1",p2="b2" test_table.txt;
```
- Contoh 2: Unduh data dari tabel bertingkat dua test_project.test_table ke file test_table.txt. File test_table.txt disimpan di folder test pada drive D. Contoh perintah:
```
Tunnel download test_project.test_table/p1="b1",p2="b2" D:\test\test_table.txt;
```