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 |
Menambahkan sumber daya ke Proyek MaxCompute. | Pengguna dengan izin Tulis pada sumber daya. | ||
Membuat alias untuk sumber daya. | Pengguna dengan izin Tulis pada sumber daya. | ||
Mengunduh sumber daya dari Proyek MaxCompute ke mesin lokal Anda. | Pengguna dengan izin Tulis pada sumber daya. | ||
Menampilkan detail informasi sumber daya. | Pengguna dengan izin Baca pada sumber daya. | ||
Menampilkan informasi sumber daya dalam proyek. | Pengguna dengan izin Daftar pada objek dalam proyek. | ||
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.
CatatanNama 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