Procédures stockées externes pour Amazon RDS pour DB2

Vous pouvez créer des routines externes et les enregistrer dans vos bases de données Amazon RDS pour DB2 en tant que procédures stockées externes. Actuellement, RDS pour 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 pour DB2 en tant que procédures stockées externes.

Limitations des 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 la section Support logiciel Java pour les produits de base de données DB2.

Votre programme Java peut créer des fichiers uniquement dans le /tmp répertoire, 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 la section Restrictions sur les routines externes dans la IBM Db2 documentation.

Configuration de 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 pour DB2, puis enregistrez-le en tant que procédure stockée externe.

Étape 1 : activer les procédures stockées externes

Pour activer les procédures stockées externes, dans un groupe de paramètres personnalisé 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 IBM Db2 documentation.

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

Étape 2 : installez le fichier .jar avec votre routine externe

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

L'exemple suivant montre comment créer une routine Java et l'installer sur une base de données RDS pour DB2. L'exemple inclut 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 puis 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 le 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 pour DB2, enregistrez-le en tant que procédure stockée en exécutant la db2 CREATE PROCEDURE commande or. 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 : Valider 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.