Amazon RDS for Db2 の外部ストアドプロシージャ

外部ルーチンを作成し、外部ストアドプロシージャとして Amazon RDS for Db2 データベースに登録できます。現在、RDS for Db2 は外部ストアドプロシージャ用の Java ベースのルーチンのみをサポートしています。

Java ベースの外部ストアドプロシージャ

Java ベースの外部ストアドプロシージャは、外部ストアドプロシージャとして RDS for Db2 データベースに登録する外部 Java ルーチンです。

Java ベースの外部ストアドプロシージャの制限

外部ルーチンを開発する前に、次の制限を考慮してください。

外部ルーチンを作成するには、Db2 が提供する Java 開発キット (JDK) を必ず使用してください。詳細については、「Java software support for Db2 database products」を参照してください。

Java プログラムは /tmp ディレクトリにのみファイルを作成でき、Amazon RDS はこれらのファイルに対する実行権限や Set User ID (SUID) 権限の有効化をサポートしていません。また、Java プログラムはソケットシステム呼び出し、または次のシステム呼び出しを使用することはできません。

Db2 の外部ルーチンに関するその他の制限については、「IBM Db2 Documentation」の「Restrictions on external routines」を参照してください。

Java ベースの外部ストアドプロシージャの設定

外部ストアドプロシージャを設定するには、外部ルーチンで.jar ファイルを作成して RDS for Db2 データベースにインストールし、外部ストアドプロシージャとして登録します。

ステップ 1: 外部ストアドプロシージャの有効化

外部ストアドプロシージャを有効にするには、DB インスタンスに関連付けられているカスタムパラメータグループで、db2_alternate_authz_behaviour パラメータを次のいずれかの値に設定します。

この設定の詳細については、IBM Db2 ドキュメントの「GRANT (database authorities) statement」を参照してください。

AWS Management Console、AWS CLI、または Amazon RDS API を使用して、カスタムパラメータグループを作成および変更することができます。

ステップ 2: 外部ルーチンで.jar ファイルをインストールする

Java ルーチンを作成したら、.jar ファイルを作成して db2 "call sqlj.install_jar('file:file_path',jar_ID)" を実行し、RDS for Db2 データベースにインストールします。

次の例は、Java ルーチンを作成して、RDS for Db2 データベースにインストールする方法を示しています。この例には、プロセスのテストに使用できる簡単なルーチンのサンプルコードが含まれています。この例では、次を前提としています。

次のコード例を使用してこのプロセスを試す場合は、コード例をコピーして、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;
}
}

次のコマンドは Java ルーチンをコンパイルします。

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

次のコマンドは.jar ファイルを作成します。

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

次のコマンドは、MY_DB2_DATABASE という名前のデータベースに接続して、.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()"

ステップ 3: 外部ストアドプロシージャを登録する

RDS for Db2 データベースに.jar ファイルをインストールしたら、db2 CREATE PROCEDURE コマンドまたは db2 REPLACE PROCEDURE コマンドを実行してストアドプロシージャとして登録します。

次の例は、データベースに接続し、前のステップで作成した Java ルーチンをストアドプロシージャとして登録する方法を示しています。

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

ステップ 4: 外部ストアドプロシージャを検証する

次の手順を使用して、前のステップで登録したサンプル外部ストアドプロシージャをテストします。