Procedimientos almacenados externos de Amazon RDS para Db2

Puede crear rutinas externas y registrarlas en sus bases de datos de Amazon RDS para Db2 como procedimientos almacenados externos. Actualmente, RDS para Db2 solo admite rutinas basadas en Java para procedimientos almacenados externos.

Procedimientos almacenados externos basados en Java

Los procedimientos almacenados externos basados en Java son rutinas Java externas que se registran en la base de datos de RDS para Db2 como procedimientos almacenados externos.

Limitaciones de los procedimientos almacenados externos basados en Java

Antes de desarrollar su rutina externa, tenga en cuenta las siguientes limitaciones y restricciones.

Para crear su rutina externa, asegúrese de utilizar el kit de desarrollo de Java (JDK) proporcionado por Db2. Para obtener más información, consulte Java software support for Db2 database products.

Su programa Java solo puede crear archivos en el directorio /tmp y Amazon RDS no permite habilitar permisos ejecutables ni permisos de definición de ID de usuario (SUID) en estos archivos. Su programa Java tampoco puede usar llamadas al sistema de sockets ni las siguientes llamadas al sistema:

Para conocer las restricciones adicionales en las rutinas externas de Db2, consulte Restrictions on external routines en la documentación de IBM Db2.

Configuración de procedimientos almacenados externos basados en Java

Para configurar un procedimiento almacenado externo, cree un archivo .jar con su rutina externa, instálelo en la base de datos de RDS para Db2 y, a continuación, regístrelo como procedimiento almacenado externo.

Paso 1: habilite los procedimientos almacenados externos

Para habilitar los procedimientos almacenados externos, establezca el parámetro db2_alternate_authz_behaviour en uno de los valores siguientes en un grupo de parámetros personalizado asociado a la instancia de base de datos:

Para obtener más información sobre esta configuración, consulte GRANT (database authorities) statement en la documentación de IBM Db2.

Puede crear y modificar una instancia de base de datos mediante la AWS Management Console, la AWS CLI o la API de Amazon RDS.

Paso 2: instale el archivo .jar con la rutina externa

Tras crear la rutina de Java, cree el archivo .jar y, a continuación, ejecute db2 "call sqlj.install_jar('file:file_path',jar_ID)" para instalarlo en la base de datos de RDS para Db2.

En el siguiente ejemplo, se muestra cómo crear una rutina de Java e instalarla en una base de datos de RDS para Db2. En el ejemplo, se incluye un código de ejemplo para una rutina sencilla que puede utilizar para probar el proceso. En este ejemplo, se da por supuesto lo siguiente:

Si desea probar el proceso con el siguiente código de ejemplo, cópielo y guárdelo en un archivo denominado 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;
}
}

El siguiente comando compila la rutina de Java.

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

El siguiente comando crea el archivo .jar.

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

Los siguientes comandos se conectan a la base de datos denominada MY_DB2_DATABASE e instalan el archivo .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()"

Paso 3: registre el procedimiento almacenado externo

Tras instalar el archivo .jar en la base de datos de RDS para Db2, regístrelo como procedimiento almacenado ejecutando el comando db2 CREATE PROCEDURE o db2 REPLACE PROCEDURE.

El siguiente ejemplo muestra cómo conectarse a la base de datos y registrar la rutina de Java creada en el paso anterior como un procedimiento almacenado.

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

Paso 4: valide el procedimiento almacenado externo

Utilice los siguientes pasos para probar el procedimiento almacenado externo de ejemplo que se registró en el paso anterior.