Externe gespeicherte Prozeduren für Amazon RDS for Db2

Sie können externe Routinen erstellen und sie bei Ihren Amazon RDS for Db2-Datenbanken als externe gespeicherte Prozeduren registrieren. Derzeit unterstützt RDS for Db2 nur Java-basierte Routinen für externe gespeicherte Prozeduren.

Java-basierte externe gespeicherte Prozeduren

Java-basierte externe gespeicherte Prozeduren sind externe Java-Routinen, die Sie bei Ihrer RDS for Db2-Datenbank als externe gespeicherte Prozeduren registrieren.

Einschränkungen für Java-basierte externe gespeicherte Prozeduren

Bevor Sie Ihre externe Routine entwickeln, sollten Sie die folgenden Einschränkungen und Einschränkungen berücksichtigen.

Stellen Sie sicher, dass Sie das von Db2 bereitgestellte Java Development Kit (JDK) verwenden, um Ihre externe Routine zu erstellen. Weitere Informationen finden Sie unter Java-Softwareunterstützung für Db2-Datenbankprodukte.

Ihr Java-Programm kann Dateien nur in dem /tmp Verzeichnis erstellen, und Amazon RDS unterstützt nicht die Aktivierung von ausführbaren Dateien oder Berechtigungen zum Festlegen von Benutzer-IDs (SUID) für diese Dateien. Ihr Java-Programm kann auch keine Socket-Systemaufrufen oder die folgenden Systemaufrufen verwenden:

Weitere Einschränkungen für externe Routinen für Db2 finden Sie in der Dokumentation unter Einschränkungen für externe Routinen. IBM Db2

Konfiguration von Java-basierten externen gespeicherten Prozeduren

Um eine externe gespeicherte Prozedur zu konfigurieren, erstellen Sie eine JAR-Datei mit Ihrer externen Routine, installieren Sie sie in Ihrer RDS for Db2-Datenbank und registrieren Sie sie dann als externe gespeicherte Prozedur.

Schritt 1: Aktivieren Sie externe gespeicherte Prozeduren

Um externe gespeicherte Prozeduren zu aktivieren, setzen Sie den Parameter in einer benutzerdefinierten Parametergruppe, die Ihrer DB-Instance zugeordnet ist, db2_alternate_authz_behaviour auf einen der folgenden Werte:

Weitere Informationen zu dieser Einstellung finden Sie in der IBM Db2 Dokumentation unter GRANT-Anweisung (Datenbankautoritäten).

Sie können eine benutzerdefinierte Parametergruppe mithilfe der AWS Management Console, der oder der Amazon RDS-API erstellen und ändern. AWS CLI

Schritt 2: Installieren Sie die JAR-Datei mit Ihrer externen Routine

Nachdem Sie Ihre Java-Routine erstellt haben, erstellen Sie die JAR-Datei und führen Sie sie anschließend aus, db2 "call sqlj.install_jar('file:file_path',jar_ID)" um sie in Ihrer RDS for Db2-Datenbank zu installieren.

Das folgende Beispiel zeigt Ihnen, wie Sie eine Java-Routine erstellen und sie in einer RDS for Db2-Datenbank installieren. Das Beispiel enthält Beispielcode für eine einfache Routine, mit der Sie den Prozess testen können. In diesem Beispiel werden die folgenden Annahmen getroffen:

Wenn Sie den Vorgang mit dem folgenden Beispielcode ausprobieren möchten, kopieren Sie ihn und speichern Sie ihn dann in einer Datei mit dem Namen. 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;
}
}

Der folgende Befehl kompiliert die Java-Routine.

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

Der folgende Befehl erstellt die JAR-Datei.

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

Mit den folgenden Befehlen wird eine Verbindung zur genannten Datenbank hergestellt MY_DB2_DATABASE und die JAR-Datei installiert.

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()"

Schritt 3: Registrieren Sie die externe gespeicherte Prozedur

Nachdem Sie die JAR-Datei in Ihrer RDS for Db2-Datenbank installiert haben, registrieren Sie sie als gespeicherte Prozedur, indem Sie den Befehl db2 CREATE PROCEDURE or db2 REPLACE PROCEDURE ausführen.

Das folgende Beispiel zeigt Ihnen, wie Sie eine Verbindung zur Datenbank herstellen und die im vorherigen Schritt erstellte Java-Routine als gespeicherte Prozedur registrieren.

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

Schritt 4: Überprüfen Sie die externe gespeicherte Prozedur

Verwenden Sie die folgenden Schritte, um das Beispiel für eine externe gespeicherte Prozedur zu testen, die im vorherigen Schritt registriert wurde.