All Products
Search

This Product

    MaxCompute:Operasi Tunnel

    Document Center

    MaxCompute:Operasi Tunnel

    Last Updated:Jun 16, 2026

    MaxCompute memungkinkan Anda menggunakan perintah Tunnel untuk mengunggah dan mengunduh data.

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

    Type

    Description

    Role

    Entry point

    Upload data

    Mengunggah data dari file lokal ke tabel MaxCompute dalam mode append.

    Pengguna yang memiliki izin Alter pada tabel tersebut.

    MaxCompute client

    Download data

    Mengunduh data dari tabel MaxCompute atau hasil eksekusi instans tertentu ke file lokal.

    Pengguna yang memiliki izin Select pada tabel tersebut.

    Upload data

    Anda dapat mengunggah data dari file lokal ke tabel MaxCompute dalam mode append. Pengunggahan data tidak dikenai biaya.

    • Limitations

      • Anda dapat mengunggah file atau direktori level-1. Setiap operasi unggah hanya dapat menargetkan satu tabel atau satu partition dalam tabel.

      • Jika Anda mengunggah data ke tabel partisi, Anda harus menentukan partisi tersebut. Untuk tabel dengan beberapa level partisi, Anda harus menentukan partisi tingkat terendah.

    • Syntax

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

    • Parameters

      • path: Wajib. Jalur dan nama file sumber data. Secara default, file data berformat TXT. Jalur dan nama file hanya boleh berisi huruf Inggris, angka, dan garis bawah (_). Karakter Cina dan spasi tidak didukung. Jika jalur berisi karakter Cina pada sistem dengan locale non-UTF-8, seperti LANG=C, MaxCompute client (odpscmd) akan menampilkan error "File not found". Untuk mengatasi masalah ini, gunakan jalur yang hanya berisi karakter Inggris atau atur locale sistem Anda ke encoding UTF-8, misalnya export LANG=en_US.UTF-8.

        Anda dapat menentukan jalur file dengan dua cara: Jika file berada di direktori bin MaxCompute client, atur parameter path menjadi filename.extension. Jika file berada di direktori lain, seperti D:\test, atur parameter path ke jalur mutlak, misalnya D:\test\filename.extension. Tool baris perintah Tunnel tidak memiliki batas ukuran file dan mendukung pengunggahan file besar. Untuk mengoptimalkan pengunggahan file besar, Anda dapat menggunakan parameter -bs untuk menyesuaikan ukuran setiap blok data. Nilai default-nya adalah 100 MiB.

        Catatan

        Pada macOS, nilai path harus berupa jalur mutlak. Misalnya, jika file Anda berada di direktori bin MaxCompute client, atur parameter path ke jalur mutlak, seperti /Users/username/MaxCompute/bin/filename.extension.

      • project_name: Opsional. Nama proyek yang berisi tabel tujuan. Parameter ini wajib jika Anda mengakses tabel di proyek berbeda.

      • table_name: Wajib. Nama tabel tujuan.

      • pt_spc: Opsional. Partisi tujuan. Anda harus menentukan partisi tingkat terendah. Nilainya harus dalam format partition_col1=col1_value1, partition_col2=col2_value1....

    • Examples

      • Contoh 1: Unggah data dari file log.txt ke tabel test_table di proyek saat ini. File log.txt disimpan di direktori bin MaxCompute client.

        Tunnel upload log.txt test_table;

      • Contoh 2: Unggah data dari file log.txt ke partisi p1="b1",p2="b2" tabel test_table. Tabel tersebut merupakan tabel partisi dua level di proyek test_project. File log.txt disimpan di folder test pada drive D.

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

    Download data

    Mengunduh data dari tabel MaxCompute atau hasil eksekusi instans tertentu ke file lokal. Anda akan dikenai biaya untuk pengunduhan data melalui Internet berdasarkan jumlah data yang diunduh. Biaya dihitung sebagai berikut: Biaya unduh = Data yang diunduh (GB) × Harga (0,1166 USD/GB).

    • Limitations

      • Setiap pengunduhan hanya dapat mengekspor data dari satu tabel atau satu partisi ke satu file.

      • Jika Anda mengunduh data dari tabel partisi, Anda harus menentukan partisi tersebut. Untuk tabel dengan beberapa level partisi, Anda harus menentukan partisi tingkat terendah.

    • Syntax

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

    • Parameters

      • project_name: Opsional. Nama proyek yang berisi tabel sumber. Parameter ini wajib jika Anda mengakses tabel di proyek berbeda.

      • table_name: Wajib. Nama tabel sumber.

      • pt_spc: Opsional. Partisi sumber. Anda harus menentukan partisi tingkat terendah. Nilainya harus dalam format partition_col1=col1_value1, partition_col2=col2_value1....

      • path: Wajib. Jalur tujuan dan nama file untuk file data yang diunduh. Secara default, file data yang diunduh berformat TXT.

        Ada dua opsi untuk jalur penyimpanan file data. Anda dapat mengunduh file langsung ke direktori bin MaxCompute client. Dalam hal ini, atur parameter path menjadi filename.extension. Atau, Anda dapat mengunduh file ke jalur lain, seperti folder test pada drive D. Dalam hal ini, atur parameter path menjadi D:\test\filename.extension.

    • Examples

      • Contoh 1: Unduh data dari tabel test_project.test_table (tabel partisi dua level) ke file test_table.txt. File test_table.txt berada di direktori bin MaxCompute client. Perintahnya sebagai berikut.

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

      • Contoh 2: Unduh data dari tabel test_project.test_table, tabel partisi dua level, ke file test_table.txt di folder test pada drive D. Perintahnya sebagai berikut.

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