Procedimentos armazenados externos do Amazon RDS para Db2

É possível criar rotinas externas e registrá-las em bancos de dados do Amazon RDS para Db2 como procedimentos armazenados externos. No momento, o RDS para Db2 permite somente rotinas baseadas em Java para procedimentos armazenados externos.

Procedimentos armazenados externos baseados em Java

Procedimentos armazenados externos baseados em Java são rotinas externas do Java que você registra no banco de dados do RDS para Db2 como procedimentos armazenados externos.

Limitações para procedimentos armazenados externos baseados em Java

Antes de desenvolver a rotina externa, considere as seguintes limitações e restrições.

Para criar a rotina externa, use o Java Development Kit (JDK) fornecido pelo Db2. Consulte mais informações em Java software support for Db2 database products.

O programa Java pode criar arquivos somente no diretório /tmp, e o Amazon RDS não permite habilitar permissões executáveis ou de definição de ID de usuário (SUID) nesses arquivos. O programa Java também não pode usar chamadas de sistema de soquete nem as seguintes chamadas de sistema:

Consulte as restrições adicionais sobre rotinas externas para o Db2 em Restrictions on external routines na documentação do IBM Db2.

Configurar procedimentos armazenados externos baseados em Java

Para configurar um procedimento armazenado externo, crie um arquivo .jar com a rotina externa, instale-o no banco de dados do RDS para Db2 e, depois, registre-o como um procedimento armazenado externo.

Etapa 1: habilitar procedimentos armazenados externos

Para habilitar procedimentos armazenados externos, em um grupo de parâmetros personalizado associado à instância de banco de dados, defina o parâmetro db2_alternate_authz_behaviour como um dos seguintes valores:

Consulte mais informações sobre essa configuração em GRANT (database authorities) statement na documentação do IBM Db2.

É possível criar e modificar um grupo de parâmetros personalizado usando o AWS Management Console, a AWS CLI ou a API do Amazon RDS.

Etapa 2: instalar o arquivo .jar com a rotina externa

Depois de criar a rotina do Java, crie o arquivo .jar e execute db2 "call sqlj.install_jar('file:file_path',jar_ID)" para instalá-lo no banco de dados do RDS para Db2.

O exemplo a seguir mostra como criar uma rotina do Java e instalá-la em um banco de dados do RDS para Db2. O exemplo inclui um exemplo de código para uma rotina simples que pode ser usada para testar o processo. Esse exemplo faz as seguintes suposições:

Se você quiser experimentar o processo com o código de exemplo a seguir, copie-o e salve-o em um arquivo chamado 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;
}
}

O comando a seguir compila a rotina do Java.

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

O comando a seguir cria o arquivo .jar.

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

Os comandos a seguir se conectam ao banco de dados chamado MY_DB2_DATABASE e instalam o arquivo .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()"

Etapa 3: registrar o procedimento armazenado externo

Depois de instalar o arquivo .jar no banco de dados do RDS para Db2, registre-o como um procedimento armazenado executando o comando db2 CREATE PROCEDURE ou db2 REPLACE PROCEDURE.

O exemplo a seguir mostra como se conectar ao banco de dados e registrar a rotina do Java criada na etapa anterior como um procedimento armazenado.

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

Etapa 4: validar o procedimento armazenado externo

Use as etapas a seguir para testar o exemplo de procedimento armazenado externo que foi registrado na etapa anterior.