Stored procedure esterne per Amazon RDS per Db2

Puoi creare routine esterne e registrarle nei tuoi database Amazon RDS per Db2 come stored procedure esterne. Attualmente, RDS per Db2 supporta solo routine basate su Java per le stored procedure esterne.

Stored procedure esterne basate su Java

Le stored procedure esterne basate su Java sono routine Java esterne registrate nel database RDS per Db2 come stored procedure esterne.

Limitazioni per le stored procedure esterne basate su Java

Prima di sviluppare una routine esterna, considera le seguenti limitazioni e restrizioni.

Per creare una routine esterna, assicurati di utilizzare il Java Development Kit (JDK) fornito da Db2. Per ulteriori informazioni, consulta Java software support for Db2 database products.

Il tuo programma Java può creare file solo nella directory /tmp e Amazon RDS non supporta l’abilitazione delle autorizzazioni di esecuzione o Set User ID (SUID) su questi file. Inoltre, il tuo programma Java non può utilizzare le chiamate di sistema socket o le seguenti chiamate di sistema:

Per ulteriori restrizioni sulle routine esterne per Db2, consulta Restrictions on external routines nella documentazione di IBM Db2.

Configurazione di stored procedure esterne basate su Java

Per configurare una stored procedure esterna, crea un file .jar con la routine esterna, installalo nel database RDS per Db2, quindi registralo come stored procedure esterna.

Fase 1: abilitare le stored procedure esterne

Per abilitare le stored procedure esterne, in un gruppo di parametri associato all’istanza database, imposta il parametro db2_alternate_authz_behaviour su uno dei seguenti valori:

Per ulteriori informazioni su questa impostazione, consulta GRANT (database authorities) statement nella documentazione di IBM Db2.

Puoi creare e modificare un’istanza database utilizzando la Console di gestione AWS, la AWS CLI o l’API Amazon RDS.

Fase 2: installare il file .jar con la routine esterna

Dopo aver creato la routine Java, crea il file .jar ed esegui db2 "call sqlj.install_jar('file:file_path',jar_ID)" per installarlo nel database RDS per Db2.

L’esempio seguente mostra come creare una routine Java e installarla su un database RDS per Db2. L’esempio include un codice di esempio per una semplice routine da utilizzare per testare il processo. In questo esempio si presume quanto segue:

Se desideri provare il processo con il seguente codice di esempio, copialo e salvalo in un file denominato MYJAVASP.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;
}
}

Il comando seguente compila la routine Java.

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

Il comando seguente crea il file .jar.

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

I comandi seguenti effettuano la connessione al database denominato MY_DB2_DATABASE e installano il 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()"

Fase 3: registrare la stored procedure esterna

Dopo aver installato il file .jar nel database RDS per Db2, registralo come stored procedure eseguendo il comando db2 CREATE PROCEDURE o db2 REPLACE PROCEDURE.

L’esempio seguente mostra come connettersi al database e registrare la routine Java creata nel passaggio precedente come stored procedure.

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';

Fase 4: convalidare la stored procedure esterna

Utilizza la procedura seguente per testare la stored procedure esterna di esempio che è stata registrata nel passaggio precedente.