全部产品
Search
文档中心

MaxCompute:Gunakan UDF untuk mengakses sumber daya di VPC

更新时间:Jul 02, 2025

Secara default, MaxCompute tidak mengizinkan akses ke sumber daya di virtual private cloud (VPC) menggunakan fungsi yang ditentukan pengguna (UDF). Untuk menggunakan UDF dalam mengakses sumber daya di VPC, Anda harus menetapkan koneksi jaringan antara MaxCompute dan VPC. Topik ini menjelaskan cara menggunakan UDF untuk mengakses sumber daya di VPC.

Prasyarat

Pastikan persyaratan berikut terpenuhi:

Informasi latar belakang

Sebelum menggunakan UDF untuk mengakses sumber daya di VPC, Anda harus menetapkan koneksi jaringan antara MaxCompute dan VPC. Untuk detail lebih lanjut, lihat Proses Koneksi Jaringan. Setelah menetapkan koneksi jaringan, tambahkan set odps.session.networklink=<networklink_name>; sebelum pernyataan SQL yang akan dieksekusi. Kemudian, kirimkan perintah SET bersama dengan pernyataan SQL untuk memanggil UDF. networklink_name menentukan nama koneksi jaringan yang telah ditetapkan.

Batasan

Skema koneksi VPC hanya didukung di wilayah China (Beijing), China (Shanghai), China (Zhangjiakou), China (Hangzhou), China (Shenzhen), China (Hong Kong), Singapura, Jerman (Frankfurt), dan AS (Virginia). Oleh karena itu, Anda hanya dapat menggunakan UDF untuk mengakses sumber daya yang ditempatkan di VPC di wilayah-wilayah tersebut.

Langkah 1: Tetapkan koneksi jaringan

Masuk ke Konsol MaxCompute. Di sudut kiri atas konsol, pilih wilayah. Di panel navigasi di sebelah kiri, pilih Tenants > Network Connection untuk menetapkan koneksi jaringan antara MaxCompute dan VPC yang diinginkan. Untuk informasi lebih lanjut, lihat Akses melalui VPC (koneksi khusus).

Langkah 2: Panggil UDF untuk mengakses sumber daya di VPC

  1. Instal dan jalankan klien MaxCompute.

  2. Daftarkan UDF.

    1. Unduh file udf-3.jar.

    2. Simpan file JAR yang diunduh di direktori bin dari klien MaxCompute lokal Anda, lalu unggah sebagai sumber daya. Contoh perintah adalah sebagai berikut:

      Catatan

      Jika file JAR berada di direktori lain, Anda harus menambahkan jalur spesifik sebelum nama file.

      add jar udf-3.jar;
    3. Daftarkan UDF. Contoh perintah:

      create FUNCTION t_telnet as 'com.ali.odps.udf.Telnet' USING 'udf-3.jar';
  3. Eksekusi pernyataan SQL untuk memanggil UDF.

    set odps.sql.type.system.odps2=true;
    -- Tentukan nama koneksi jaringan yang Anda tetapkan berdasarkan skema koneksi VPC. Pengaturan ini hanya berlaku untuk sesi saat ini.
    set odps.session.networklink=testLink;
    -- Eksekusi pernyataan SQL berikut untuk memanggil UDF untuk mengakses sumber daya di VPC:
    select t_telnet("172.16.xxx.xxx",<Nomor port>,<Periode timeout>); 

    Jika True dikembalikan, koneksi jaringan telah ditetapkan dan UDF dapat dipanggil. Jika kesalahan dikembalikan, periksa apakah informasi koneksi jaringan dikonfigurasi dengan benar.