MaxCompute:Mengelola koneksi proyek

Prasyarat

Anda telah berhasil menginstal MaxCompute Studio.

Langkah 1: Membuat proyek MaxCompute Studio

1. Jalankan IntelliJ IDEA. Dari menu utama, pilih File > New > Project.

2. Di panel navigasi kiri kotak dialog New Project, pilih MaxCompute Studio, lalu klik Next.

3. Masukkan Project name, lalu klik Finish untuk membuat proyek.

   Catatan

   Jika sudah ada proyek yang terbuka, Anda akan diminta apakah ingin membuka proyek baru di jendela saat ini. Klik This Window untuk menutup proyek yang ada dan membuka proyek baru.

Langkah 2: Membuat koneksi proyek MaxCompute

1. Dari menu utama, pilih View > Tool Windows > Project Explorer.

2. Di pojok kiri atas, klik +, lalu pilih Add project from accessId/Key.

3. Di kotak dialog Add MaxCompute project, konfigurasikan parameter pada tab Connection.

   Parameter yang perlu dikonfigurasi adalah Properties File, AK Account, AccessKey ID (wajib), AccessKey Secret (wajib), Project Name (wajib), dan Endpoint (wajib).

   Catatan

   • Klik ikon di pojok kiri bawah kotak dialog untuk melihat dokumentasi daring.

   • Jika terjadi error timeout, klik tab Setting dan modifikasi parameter sinkronisasi data:

     • sync one table timeout(s): Timeout untuk sinkronisasi tabel. Default: 5s.

     • sync one function timeout(s): Timeout untuk sinkronisasi user-defined function (UDF). Default: 30s.

   • Isi parameter secara otomatis dari file konfigurasi.

     Parameter	Deskripsi
     Properties File	Unggah file konfigurasi odps_config.ini untuk client MaxCompute (odpscmd). Untuk informasi lebih lanjut, lihat Instal dan konfigurasi client MaxCompute. File ini menginisialisasi parameter AccessKey ID, AccessKey Secret, Project Name, dan Endpoint.
     AK Account	Akun Alibaba Cloud yang digunakan untuk menghubungkan ke proyek MaxCompute. Klik + di sebelah kanan lalu pilih akun yang sudah ada di halaman Accounts. Catatan Jika tidak ada akun yang terdaftar, di halaman Accounts, klik + > Aliyun Account By AccessKey untuk menambahkan akun baik secara otomatis dari file konfigurasi maupun secara manual. Untuk informasi lebih lanjut tentang cara mengonfigurasi akun, lihat Opsi konfigurasi akun.

   • Konfigurasi parameter secara manual.

     Parameter	Deskripsi
     AccessKey ID	ID AccessKey yang digunakan untuk menghubungkan ke proyek MaxCompute.
     AccessKey Secret	AccessKey Secret yang digunakan untuk menghubungkan ke proyek MaxCompute.
     Project Name	Nama proyek MaxCompute target. Catatan Parameter ini menentukan nama proyek MaxCompute yang sudah ada, bukan ruang kerja DataWorks. Anda dapat login ke Konsol MaxCompute lalu buka halaman Workspace > Projects untuk melihat daftar nama proyek MaxCompute Anda atau membuat proyek baru.
     Endpoint	Titik akhir dari wilayah tempat proyek MaxCompute berada. Perhatikan bahwa jika Anda menghubungkan dari luar jaringan internal Alibaba Cloud (misalnya dari komputer lokal Anda), Anda harus menggunakan titik akhir publik.

4. Setelah menyelesaikan konfigurasi, klik OK. Panel Project Explorer di sebelah kiri akan menampilkan informasi proyek MaxCompute, termasuk tabel, view, user-defined function (UDF), dan sumber dayanya.

Langkah 3: Memodifikasi koneksi proyek MaxCompute

1. Di panel Project Explorer, klik kanan proyek MaxCompute yang ingin dimodifikasi, lalu pilih Modify project properties.

2. Di kotak dialog Modify MaxCompute project, modifikasi konfigurasi proyek tersebut.

Pemecahan Masalah

Beberapa error umum berikut mungkin terjadi setelah Anda mengonfigurasi parameter pada tab Connection dan mengklik OK:

• Error: Test connection fail: ODPS-0420111: Project not found - '<project_name>'. atau Test connection fail:ODPS-0130013:Authorization exception - Authorization Failed [4002], You don't exist in project <project_name>. Context ID:<context ID>. --->Tips: Principal:ALIYUN$<account_name> | RAM$[<account_name>:]<RAM_user_name>;.

  • Kemungkinan penyebab:

    • Proyek target tidak ada atau nama proyek salah.

    • Akun Alibaba Cloud atau Pengguna RAM yang terkait dengan ID AccessKey belum ditambahkan ke proyek target.

  • Solusi:

    • Login ke Konsol MaxCompute. Di halaman Workspace > Projects, peroleh nama yang benar dari proyek MaxCompute tersebut, lalu modifikasi parameter Project Name.

    • Jika pengguna lain perlu menghubungkan ke proyek tersebut, Pemilik proyek harus menambahkan mereka. Untuk informasi lebih lanjut, lihat Menambahkan akun Alibaba Cloud (tingkat proyek) atau Menambahkan Pengguna RAM (tingkat proyek).

• Error: Test connection fail: connect timed out, the possible reason is that the endpoint '<endpoint>' is wrong, please check your endpoint.

  • Kemungkinan penyebab: Anda memasukkan nilai yang salah untuk parameter Endpoint. Misalnya, Anda menghubungkan dari komputer lokal melalui internet publik tetapi menentukan titik akhir jaringan internal.

  • Solusi: Rujuk dokumentasi Endpoints dan pilih titik akhir yang sesuai dengan wilayah proyek Anda dan lingkungan jaringan Anda.

• Error: Test connection fail: The specified project or table name is not valid or missing. .

  • Kemungkinan penyebab: Titik akhir digunakan untuk layanan MaxCompute, sedangkan titik akhir saluran data digunakan untuk layanan MaxCompute Tunnel. Kemungkinan besar Anda menentukan titik akhir saluran data untuk parameter Endpoint.

  • Solusi: Rujuk dokumentasi Endpoints. Pilih titik akhir yang sesuai dengan wilayah proyek Anda dan lingkungan jaringan Anda. Jangan gunakan titik akhir saluran data.