MaxCompute：Catatan Penggunaan

• UPLOAD: Mengunggah data lokal ke tabel MaxCompute. Anda hanya dapat mengunggah file ke satu tabel atau satu partisi dalam tabel setiap kali. Untuk tabel terpartisi, Anda harus menentukan partisi tempat Anda ingin mengunggah data. Untuk tabel dengan partisi multi-level, Anda harus menentukan partisi tingkat terendah. Untuk informasi lebih lanjut, lihat Unggah.

• DOWNLOAD: Mengunduh data tabel MaxCompute atau hasil kueri instance tertentu ke direktori lokal. Anda hanya dapat mengunduh data dari satu tabel atau partisi ke satu file lokal setiap kali. Untuk tabel terpartisi, Anda harus menentukan partisi dari mana Anda ingin mengunduh data. Untuk tabel dengan partisi multi-level, Anda harus menentukan partisi tingkat terendah. Untuk informasi lebih lanjut, lihat Unduh.

• RESUME: Melanjutkan pengunggahan file ketika terjadi kesalahan karena pemutusan jaringan atau layanan Tunnel bermasalah. Anda tidak dapat menggunakan perintah ini untuk melanjutkan pengunduhan data. Untuk informasi lebih lanjut, lihat Lanjutkan.

• SHOW: Menampilkan informasi tugas historis. Untuk informasi lebih lanjut, lihat Tampilkan.

• PURGE: Membersihkan direktori sesi. Log dari tiga hari terakhir dihapus secara default. Untuk informasi lebih lanjut, lihat Pembersihan.

• HELP: Meminta informasi bantuan. Alias perintah didukung.

• UPSERT: Menggunakan semantik UPDATE dan INSERT untuk menulis data. Perintah ini dapat digunakan untuk menulis data hanya ke tabel Transaksi Tabel 2.0.

  Jika tidak ada data yang cocok ditemukan di tabel tujuan, data baru akan dimasukkan ke dalam tabel. Jika data yang akan ditulis sudah ada, data akan diperbarui di tabel.

Sebelum mengunggah data tabel, Anda harus mendapatkan file data data.txt yang berisi data tabel yang ingin Anda unggah. Jalur penyimpanan adalah d:\data.txt. Contoh berikut menunjukkan data dalam file tersebut.

shopx,x_id,100
shopy,y_id,200
shopz,z_id

Untuk mengunggah dan mengunduh data tabel, lakukan langkah-langkah berikut:

1. Di klien MaxCompute, jalankan pernyataan berikut untuk membuat tabel terpartisi bernama sale_detail dan tambahkan partisi ke tabel tersebut.

   CREATE TABLE IF NOT EXISTS sale_detail(
         shop_name     STRING,
         customer_id   STRING,
         total_price   DOUBLE)
   PARTITIONED BY (sale_date STRING,region STRING);
   
   alter table sale_detail add partition (sale_date='201312', region='hangzhou');

2. Jalankan perintah UPLOAD untuk mengunggah file data.txt ke tabel sale_detail.

   • Pernyataan contoh

     tunnel upload d:\data.txt sale_detail/sale_date=201312,region=hangzhou -s false;

   • Hasil yang dikembalikan

     Upload session: 20230505xxxxxxxxxxxb0b02dbb6bd
     Start upload:d:\data.txt
     Using \r\n to split records
     Upload in strict schema mode: true
     Total bytes:42   Split input to 1 blocks
     2023-05-05 10:11:35     upload block: '1'
     ERROR: column mismatch -,expected 3 columns, 2 columns found, please check data or delimiter

     Catatan

     Data gagal diimpor karena file data.txt berisi data kotor. Sistem mengembalikan ID sesi dan pesan kesalahan.

3. Jalankan pernyataan berikut untuk memverifikasi pengunggahan data.

   • Pernyataan contoh

     select * from sale_detail where sale_date='201312';

   • Hasil yang dikembalikan

     ID = 20230505xxxxxxxxxxxvc61z5
     +-----------+-------------+-------------+-----------+--------+
     | shop_name | customer_id | total_price | sale_date | region |
     +-----------+-------------+-------------+-----------+--------+
     +-----------+-------------+-------------+-----------+--------+

     Catatan

     Data gagal diimpor karena file data.txt berisi data kotor. Akibatnya, tabel kosong.

4. Jalankan perintah SHOW untuk meminta ID sesi di mana pengunggahan data gagal.

   • Pernyataan contoh

     tunnel show history;

   • Hasil yang dikembalikan

     20230505xxxxxxxxxxxb0b02dbb6bd  failed  'upload d:\data.txt sale_detail/sale_date=201312,region=hangzhou -s false'

5. Ubah isi file data.txt menjadi informasi berikut:

   shopx,x_id,100
   shopy,y_id,200

6. Jalankan perintah RESUME untuk melanjutkan pengunggahan data. 20230505xxxxxxxxxxxb0b02dbb6bd adalah ID sesi di mana pengunggahan data gagal.

   • Pernyataan contoh

     tunnel resume 20230505xxxxxxxxxxxb0b02dbb6bd --force;

   • Hasil yang dikembalikan

     start resume
     20230505xxxxxxxxxxxb0b02dbb6bd
     Upload session: 20230505xxxxxxxxxxxb0b02dbb6bd
     Start upload:d:\data.txt
     Using \r\n to split records
     Upload in strict schema mode: true
     Resume 1 blocks 
     2023-05-05 10:32:39     upload block: '1'
     2023-05-05 10:32:40     upload block complete, block id: 1
     upload complete, average speed is 0 bytes/s
     OK

7. Jalankan pernyataan berikut untuk memverifikasi pengunggahan data:

   • Pernyataan contoh

     select * from sale_detail where sale_date='201312';

   • Hasil yang dikembalikan

     ID = 20230505xxxxxxxxxxxx7afc9qcg
      +-----------+-------------+-------------+-----------+--------+
      | shop_name | customer_id | total_price | sale_date | region |
      +-----------+-------------+-------------+-----------+--------+
      | shopx     | x_id        | 100.0       | 201312    | hangzhou|
      | shopy     | y_id        | 200.0       | 201312    | hangzhou|
      +-----------+-------------+-------------+-----------+--------+

8. Jalankan perintah DOWNLOAD untuk mengunduh data dari tabel sale_detail ke file result.txt.

   Catatan

   Lokasi lokal path tempat data diunduh dinamai berdasarkan aturan berikut:

   • Anda dapat langsung menyimpan file ke direktori bin klien MaxCompute. Dalam hal ini, Anda harus mengatur parameter path ke nilai dalam format Nama File.Ekstensi File.

   • Anda juga dapat menyimpan file ke direktori lain. Misalnya, Anda dapat menyimpan file ke folder test di drive D. Dalam hal ini, Anda harus mengatur parameter path ke nilai dalam format D:\test\Nama File.Ekstensi File.

   • Jika file di lokasi lokal memiliki nama yang sama dengan file yang ingin Anda simpan, file yang ada akan ditimpa oleh file baru.

   tunnel download sale_detail/sale_date=201312,region=hangzhou result.txt;

9. Periksa apakah file result.txt berisi konten berikut. Jika file berisi konten berikut, pengunduhan data berhasil.

   Catatan

   File yang diunduh hanya berisi nilai kolom non-kunci partisi.

   shopx,x_id,100.0
   shopy,y_id,200.0