Prosedur tersimpan eksternal untuk Amazon RDS untuk Db2

Anda dapat membuat rutinitas eksternal dan mendaftarkannya dengan database Amazon RDS untuk Db2 Anda sebagai prosedur tersimpan eksternal. Saat ini, RDS untuk Db2 hanya mendukung rutinitas berbasis Java untuk prosedur tersimpan eksternal.

Prosedur tersimpan eksternal berbasis Java

Prosedur tersimpan eksternal berbasis Java adalah rutinitas Java eksternal yang Anda daftarkan dengan RDS Anda untuk database Db2 sebagai prosedur tersimpan eksternal.

Batasan untuk prosedur tersimpan eksternal berbasis Java

Sebelum Anda mengembangkan rutinitas eksternal Anda, pertimbangkan batasan dan batasan berikut.

Untuk membuat rutinitas eksternal Anda, pastikan untuk menggunakan Java Development Kit (JDK) yang disediakan oleh Db2. Untuk informasi selengkapnya, lihat dukungan perangkat lunak Java untuk produk database Db2.

Program Java Anda dapat membuat file hanya di /tmp direktori, dan Amazon RDS tidak mendukung pengaktifan izin executable atau Set User ID (SUID) pada file-file ini. Program Java Anda juga tidak dapat menggunakan panggilan sistem soket atau panggilan sistem berikut:

Untuk pembatasan tambahan pada rutinitas eksternal untuk Db2, lihat Pembatasan rutinitas eksternal dalam dokumentasi. IBM Db2

Mengkonfigurasi prosedur tersimpan eksternal berbasis Java

Untuk mengkonfigurasi prosedur tersimpan eksternal, buat file.jar dengan rutinitas eksternal Anda, instal pada database RDS untuk Db2 Anda, dan kemudian daftarkan sebagai prosedur tersimpan eksternal.

Langkah 1: Aktifkan prosedur tersimpan eksternal

Untuk mengaktifkan prosedur tersimpan eksternal, dalam grup parameter kustom yang terkait dengan instans DB Anda, setel parameter db2_alternate_authz_behaviour ke salah satu nilai berikut:

Untuk informasi selengkapnya tentang pengaturan ini, lihat pernyataan GRANT (otoritas database) dalam IBM Db2 dokumentasi.

Anda dapat membuat dan mengubah grup parameter kustom dengan menggunakan AWS Management Console, AWS CLI, atau Amazon RDS API.

Langkah 2: Instal file.jar dengan rutinitas eksternal Anda

Setelah Anda membuat rutinitas Java Anda, buat file.jar dan kemudian jalankan db2 "call sqlj.install_jar('file:file_path',jar_ID)" untuk menginstalnya pada database RDS untuk Db2 Anda.

Contoh berikut menunjukkan cara membuat rutin Java dan menginstalnya pada database RDS untuk Db2. Contoh termasuk kode sampel untuk rutinitas sederhana yang dapat Anda gunakan untuk menguji proses. Contoh ini membuat asumsi berikut:

Jika Anda ingin mencoba proses dengan kode contoh berikut, salin dan kemudian simpan ke file bernamaMYJAVASP.java.

import java.sql.*;
public class MYJAVASP
{
public static void my_JAVASP (String inparam) throws SQLException, Exception
{
try
{
// Obtain the calling context's connection details.
Connection myConn = DriverManager.getConnection("jdbc:default:connection");
String myQuery = "INSERT INTO TEST.TEST_TABLE VALUES (?, CURRENT DATE)";
PreparedStatement myStmt = myConn.prepareStatement(myQuery);
myStmt.setString(1, inparam);
myStmt.executeUpdate();
}
catch (SQLException sql_ex)
{
throw sql_ex;
}
catch (Exception ex)
{
throw ex;
}
}

Perintah berikut mengkompilasi rutin Java.

~/sqllib/java/jdk64/bin/javac MYJAVASP.java

Perintah berikut membuat file.jar.

~/sqllib/java/jdk64/bin/jar cvf MYJAVASP.jar MYJAVASP.class

Perintah berikut terhubung ke database bernama MY_DB2_DATABASE dan menginstal file.jar.

db2 "connect to MY_DB2_DATABASE user master_username using master_password" 

db2 "call sqlj.install_jar('file:/tmp/MYJAVASP.jar','MYJAVASP')"
db2 "call sqlj.refresh_classes()"

Langkah 3: Daftarkan prosedur tersimpan eksternal

Setelah Anda menginstal file.jar pada RDS Anda untuk database Db2, daftarkan sebagai prosedur tersimpan dengan menjalankan perintah or. db2 CREATE PROCEDURE db2 REPLACE PROCEDURE

Contoh berikut menunjukkan cara menghubungkan ke database dan mendaftarkan rutinitas Java yang dibuat pada langkah sebelumnya sebagai prosedur tersimpan.

db2 "connect to MY_DB2_DATABASE user master_username using master_password"

create procedure TESTSP.MYJAVASP (in input char(6))
specific myjavasp
dynamic result sets 0
deterministic
language java
parameter style java
no dbinfo
fenced
threadsafe
modifies sql data
program type sub
external name 'MYJAVASP!my_JAVASP';

Langkah 4: Validasi prosedur tersimpan eksternal

Gunakan langkah-langkah berikut untuk menguji sampel prosedur tersimpan eksternal yang terdaftar pada langkah sebelumnya.