全部产品
Search
文档中心

MaxCompute:Operasi Sumber Daya

更新时间:Jul 02, 2025

Sumber daya merupakan konsep spesifik dalam MaxCompute. Untuk menjalankan pekerjaan menggunakan fungsi yang ditentukan pengguna (UDF) atau MapReduce, Anda harus mengunggah file sebagai sumber daya MaxCompute. Topik ini menjelaskan operasi umum pada sumber daya seperti menambahkan, melihat, mengunduh, dan menghapus sumber daya.

Tabel berikut menjelaskan operasi umum terkait sumber daya.

Operasi

Deskripsi

Dilakukan oleh

Platform Operasi

Tambahkan sumber daya

Menambahkan sumber daya ke Proyek MaxCompute.

Pengguna dengan izin Tulis pada sumber daya.

Buat alias untuk sumber daya

Membuat alias untuk sumber daya.

Pengguna dengan izin Tulis pada sumber daya.

Unduh sumber daya

Mengunduh sumber daya dari Proyek MaxCompute ke mesin lokal Anda.

Pengguna dengan izin Tulis pada sumber daya.

Lihat informasi sumber daya

Menampilkan detail informasi sumber daya.

Pengguna dengan izin Baca pada sumber daya.

Lihat daftar sumber daya

Menampilkan informasi sumber daya dalam proyek.

Pengguna dengan izin Daftar pada objek dalam proyek.

Hapus sumber daya

Menghapus sumber daya yang ada dari Proyek MaxCompute.

Pengguna dengan izin Hapus pada sumber daya.

Tambahkan sumber daya

Menambahkan sumber daya ke Proyek MaxCompute.

  • Batasan

    • MaxCompute tidak mendukung penambahan tabel eksternal sebagai sumber daya.

    • Ukuran maksimum file sumber daya adalah 2048 MB. Ukuran sumber daya yang dirujuk oleh satu pekerjaan SQL atau MapReduce tidak boleh melebihi 2048 MB.

  • Sintaksis

    add file <local_file> [as <alias>] [comment '<comment>'][-f];
    add archive <local_file> [as <alias>] [comment '<comment>'][-f];
    add table <table_name> [partition (<spec>)] [as <alias>] [comment '<comment>'][-f];
    add py|jar <localfile> [comment '<comment>'][-f];
  • Parameter

    • file|archive|table|py|jar: wajib. Jenis sumber daya.

    • local_file: wajib. Jalur file yang ingin ditambahkan. Nama file digunakan sebagai nama sumber daya, yang secara unik mengidentifikasi sumber daya tersebut.

    • table_name: wajib. Nama tabel di MaxCompute.

    • spec: wajib. Jika sumber daya yang ingin ditambahkan adalah tabel terpartisi, MaxCompute hanya mengambil partisi dalam tabel sebagai sumber daya, bukan seluruh tabel.

    • alias: opsional. Nama sumber daya. Jika parameter ini tidak ditentukan, nama file digunakan sebagai nama sumber daya. Paket JAR atau file skrip Python yang digunakan sebagai sumber daya tidak mendukung parameter ini.

    • comment: opsional. Komentar sumber daya.

    • -f: opsional. Jika nama sumber daya duplikat ada, sumber daya yang ada akan diganti. Jika opsi ini tidak ditentukan dan nama sumber daya duplikat ada, penambahan sumber daya akan gagal.

  • Contoh

    • Contoh 1: Menambahkan file sebagai sumber daya ke Proyek MaxCompute.

      add file banking.txt;

      Hasil berikut dikembalikan:

      OK: Resource 'banking.txt' have been created.
    • Contoh 2: Menambahkan tabel terpartisi dengan alias sale.res sebagai sumber daya ke MaxCompute.

      add table sale_detail partition (ds='20150602') as sale.res comment 'sale detail on 20150602' -f;

      Hasil berikut dikembalikan:

      OK: Resource 'sale.res' have been updated.
    • Contoh 3: Menambahkan file Python sebagai sumber daya ke MaxCompute.

      add py python.py [comment '<comment>'][-f];

      Hasil berikut dikembalikan:

      OK: Resource 'python.py' have been created.

Lihat informasi sumber daya

Menampilkan informasi detail sumber daya tertentu dalam proyek. Informasi tersebut mencakup nama sumber daya, pemilik, tipe sumber daya, ukuran sumber daya, waktu pembuatan, waktu modifikasi terakhir, serta nilai MD5 file sumber daya.

  • Sintaksis

    desc resource <resource_name>;
  • Parameter

    resource_name: wajib. Nama sumber daya yang ada.

  • Nilai Pengembalian

    • Name: nama sumber daya.

    • Owner: akun yang memiliki sumber daya.

    • Type: jenis sumber daya.

    • Comment: komentar sumber daya.

    • CreatedTime: waktu saat sumber daya dibuat.

    • LastModifiedTime: waktu saat sumber daya terakhir diperbarui.

    • LastUpdator: akun yang melakukan pembaruan terakhir.

    • Size: ukuran file sumber daya. Unit: MB.

    • Md5sum: nilai MD5 file sumber daya.

    Catatan

    Nama sumber daya MaxCompute bersifat case-insensitive. resource_A dan resource_a mewakili sumber daya yang sama.

  • Contoh

    -- Lihat informasi sumber daya topn_new.jar. 
    desc resource topn_new.jar;

    Hasil berikut dikembalikan:

    Name                                    topn_new.jar
    Owner                                   ALIYUN$****@test.aliyunid.com
    Type                                    JAR
    Comment                                 cloudopenapi
    CreatedTime                             2020-12-29 13:55:11
    LastModifiedTime                        2020-12-29 13:55:11
    LastUpdator
    Size                                    11438795
    Md5sum                                  8bcf6aabf****56c0

Lihat daftar sumber daya

Menampilkan informasi sumber daya dalam proyek. Informasi tersebut mencakup nama sumber daya, pemilik, waktu pembuatan, waktu modifikasi terakhir, dan tipe sumber daya.

  • Sintaksis

    list resources;
  • Contoh

    list resources;

    Hasil berikut dikembalikan:

    Resource Name         Owner                 Creation Time         Last Modified Time    Type          Last Updator Resource Size  Source         comment
    getaddr.jar           ALIYUN$****           2020-06-18 15:47:28   2020-06-18 15:47:28   jar           1353716                                    cloudopenapi
    ip.dat                ALIYUN$****           2020-06-18 15:49:46   2020-06-18 15:49:46   file          8525962                                    cloudopenapi
    2 resources

Buat alias untuk sumber daya

Membuat alias untuk sumber daya. Perintah alias dapat digunakan dalam kode MapReduce atau UDF untuk membaca sumber daya yang berbeda berdasarkan nama sumber daya tertentu tanpa perlu memodifikasi kode.

  • Sintaksis

    alias <alias>=<real>;
  • Parameter

    • alias: alias sumber daya.

    • real: nama sumber daya.

  • Contoh

    -- Tambahkan sumber daya res_20121208 dan res_20121209. 
    add table sale_detail partition (ds='20121208') as res_20121208;
    add table sale_detail partition (ds='20121209') as res_20121209;
    -- Tetapkan alias sumber daya res_20121208 menjadi resName dan panggil sumber daya ini. 
    alias resName=res_20121208;
    jar -resources resName -libjars work.jar  -classpath ./work.jar com.company.MainClass args ...;  
    -- Tetapkan alias sumber daya res_20121209 menjadi resName dan panggil sumber daya ini. 
    alias resName=res_20121209;
    jar -resources resName -libjars work.jar  -classpath ./work.jar com.company.MainClass args ...; 

Dalam contoh ini, alias resName merujuk pada tabel sumber daya yang berbeda dalam dua pekerjaan. Anda dapat membaca salinan data yang berbeda tanpa perlu memodifikasi kode.

Unduh sumber daya

Mengunduh sumber daya dari Proyek MaxCompute ke mesin lokal Anda. Tipe sumber daya harus FILE, JAR, ARCHIVE, atau PY. Tipe TABLE tidak didukung.

  • Sintaksis

    get resource <resource_name> <path>;
  • Parameter

    • resource_name: wajib. Nama sumber daya yang ingin diunduh.

    • path: wajib. Jalur tempat sumber daya disimpan di mesin lokal Anda.

  • Contoh

    get resource getaddr.jar D:\;

Hapus sumber daya

Menghapus sumber daya yang ada dari Proyek MaxCompute.

  • Sintaksis

    drop resource <resource_name>;
  • Parameter

    resource_name: nama sumber daya yang ingin dihapus.

  • Contoh

    drop resource getaddr.jar;

    Hasil berikut dikembalikan:

    Confirm to "drop resource getaddr.jar" (yes/no)? y
    OK