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 설명서의 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단계: 외부 저장 프로시저 검증

다음 단계를 사용하여 이전 단계에서 등록된 샘플 외부 저장 프로시저를 테스트합니다.