Procédures stockées externes pour Amazon RDS for Db2

Vous pouvez créer des routines externes et les enregistrer dans vos bases de données Amazon RDS for Db2 en tant que procédures stockées externes. Actuellement, RDS for Db2 ne prend en charge que les routines basées sur Java pour les procédures stockées externes.

Procédures stockées externes basées sur Java

Les procédures stockées externes basées sur Java sont des routines Java externes que vous enregistrez dans votre base de données RDS for Db2 en tant que procédures stockées externes.

Limites pour les procédures stockées externes basées sur Java

Avant de développer votre routine externe, tenez compte des limites et restrictions suivantes.

Pour créer votre routine externe, assurez-vous d’utiliser le kit de développement Java (JDK) fourni par Db2. Pour plus d’informations, consultez Support logiciel Java pour les produits de base de données Db2..

Votre programme Java peut créer des fichiers uniquement dans le répertoire /tmp et Amazon RDS ne prend pas en charge l’activation des autorisations d’exécution ou de définition d’un identifiant utilisateur (SUID) sur ces fichiers. Votre programme Java ne peut pas non plus utiliser les appels système socket ou les appels système suivants :

Pour des restrictions supplémentaires sur les routines externes pour Db2, consultez Restrictions sur les routines externes dans la documentation IBM Db2.

Configuration des procédures stockées externes basées sur Java

Pour configurer une procédure stockée externe, créez un fichier .jar avec votre routine externe, installez-le sur votre base de données RDS for Db2, puis enregistrez-le en tant que procédure stockée externe.

Étape 1 : activation des procédures stockées externes

Pour activer des procédures stockées externes, dans un groupe de paramètres personnalisés associé à votre instance de base de données, définissez le paramètre db2_alternate_authz_behaviour sur l’une des valeurs suivantes :

Pour plus d’informations sur ce paramètre, consultez l’instruction GRANT (autorités de base de données) dans la documentation IBM Db2.

Vous pouvez créer et modifier un groupe de paramètres personnalisés à l’aide de la AWS Management Console, de l’AWS CLI ou de l’API Amazon RDS.

Étape 2 : installation du fichier .jar avec votre routine externe

Après avoir créé votre routine Java, créez le fichier .jar, puis exécutez db2 "call sqlj.install_jar('file:file_path',jar_ID)" pour l’installer sur votre base de données RDS for Db2.

L’exemple suivant montre comment créer une routine Java et l’installer sur une base de données RDS for Db2. L’exemple comprend un exemple de code pour une routine simple que vous pouvez utiliser pour tester le processus. Cet exemple repose sur les hypothèses suivantes :

Si vous souhaitez essayer le processus avec l’exemple de code suivant, copiez-le et enregistrez-le dans un fichier nommé 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;
}
}

La commande suivante compile la routine Java.

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

La commande suivante crée un fichier .jar.

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

Les commandes suivantes se connectent à la base de données nommée MY_DB2_DATABASE et installent le fichier .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()"

Étape 3 : enregistrement de la procédure stockée externe

Après avoir installé le fichier .jar sur votre base de données RDS for Db2, enregistrez-le en tant que procédure stockée en exécutant la commande db2 CREATE PROCEDURE ou db2 REPLACE PROCEDURE.

L’exemple suivant montre comment se connecter à la base de données et enregistrer la routine Java créée à l’étape précédente en tant que procédure stockée.

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

Étape 4 : validation de la procédure stockée externe

Procédez comme suit pour tester l’exemple de procédure stockée externe enregistré à l’étape précédente.