All Products
Search
Document Center

MaxCompute:Operasi Tunnel

Last Updated:Mar 27, 2026

MaxCompute menggunakan Tunnel untuk mengunggah dan mengunduh data. Topik ini menjelaskan cara menggunakan Tunnel untuk melakukan operasi tersebut.

MaxCompute memungkinkan Anda menjalankan perintah Tunnel untuk mengunggah dan mengunduh data. Untuk daftar lengkap perintah Tunnel, lihat Perintah Tunnel.

OperasiDeskripsiIzin yang diperlukanAlat
Unggah dataMengunggah data lokal ke tabel MaxCompute dalam mode appendAlter pada tabel tujuanClient MaxCompute (odpscmd)
Unduh dataMengunduh data tabel atau hasil eksekusi instans ke mesin lokal AndaSelect pada tabel sumberClient MaxCompute (odpscmd)

Unggah data

Data lokal dapat diunggah ke tabel MaxCompute dalam mode append. Pengunggahan data ke MaxCompute tidak dikenai biaya.

Batasan

  • Unggah hanya satu file atau direktori tingkat pertama ke satu tabel atau satu partisi dalam satu operasi.

  • Untuk tabel partisi, tentukan partisi target. Jika tabel memiliki beberapa level partisi, tentukan partisi pada level terendah.

Sintaks

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

Parameter

ParameterWajibDeskripsi
pathYaPath ke file data lokal. Format file default: TXT.
project_nameTidakNama proyek yang memiliki tabel tujuan. Diperlukan untuk akses lintas proyek.
table_nameYaNama tabel tujuan.
pt_spcTidakSpesifikasi partisi untuk tabel partisi. Format: partition_col1=col1_value1, partition_col2=col2_value1.... Harus menunjuk ke partisi tingkat terendah.

Format path berdasarkan OS

OSFormat path
Windows (file di direktori bin)Nama file.ekstensi
Windows (file di direktori lain)D:\test\Nama file.ekstensi
macOSPath absolut wajib digunakan. Contoh: /Users/username/MaxCompute/bin/nama file.ekstensi

Contoh

Contoh 1: Unggah ke tabel non-partisi

Unggah log.txt (di direktori bin client MaxCompute) ke test_table di proyek saat ini:

Tunnel upload log.txt test_table;

Contoh 2: Unggah ke tabel partisi lintas proyek (Windows)

Unggah log.txt dari D:\test\ ke partisi p1="b1",p2="b2" dari test_table di test_project:

Tunnel upload D:\test\log.txt test_project.test_table/p1="b1",p2="b2";

Unduh data

Unduh data dari tabel MaxCompute atau hasil eksekusi instans tertentu ke direktori di mesin lokal Anda.

Penting

Pengunduhan dikenai biaya berdasarkan jumlah data yang ditransfer. Biaya = data yang diunduh (GB) × USD 0,1166/GB. Data hanya dapat diunduh melalui Internet.

Batasan

  • Unduh data hanya dari satu tabel atau satu partisi ke satu file lokal dalam satu operasi.

  • Untuk tabel partisi, tentukan partisi sumber. Jika tabel memiliki beberapa level partisi, tentukan partisi pada level terendah.

Sintaks

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

Parameter

ParameterWajibDeskripsi
project_nameTidakNama proyek yang memiliki tabel sumber. Diperlukan untuk akses lintas proyek.
table_nameYaNama tabel sumber.
pt_spcTidakSpesifikasi partisi untuk tabel partisi. Format: partition_col1=col1_value1, partition_col2=col2_value1.... Harus menunjuk ke partisi tingkat terendah.
pathYaPath file yang diunduh di mesin lokal Anda. Format file default: TXT.

Contoh

Contoh 1: Unduh ke direktori client MaxCompute

Unduh data dari partisi p1="b1",p2="b2" dari test_project.test_table ke test_table.txt di direktori bin client MaxCompute:

Tunnel download test_project.test_table/p1="b1",p2="b2" test_table.txt;

Contoh 2: Unduh ke direktori kustom (Windows)

Unduh data partisi yang sama ke D:\test\test_table.txt:

Tunnel download test_project.test_table/p1="b1",p2="b2" D:\test\test_table.txt;