各製品の資料を入手。
詳細はこちら →
製品をチェック
JDBI からDB2 データ のデータアクセスオブジェクトを作成
JDBI でDB2 のデータ 用のSQL オブジェクトAPIを作成する方法を概説します。
最終更新日：2022-05-25
この記事で実現できるDB2 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for DB2 は、Java アプリケーションとリアルタイムDB2 のデータ のデータ連携を実現します。これらの技術を組み合わせることによって、DB2 のデータ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO（Data Access Object ）とそれに付随するDB2 のデータ の読み書きのためのコードの作成について説明します。
DB2 Orders Entity のDAO を作成
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyOrdersDAO {
//insert new data into DB2
@SqlUpdate("INSERT INTO Orders (ShipCity, Freight) values (:shipCity, :freight)")
void insert(@Bind("shipCity") String shipCity, @Bind("freight") String freight);
//request specific data from DB2 (String type is used for simplicity)
@SqlQuery("SELECT Freight FROM Orders WHERE ShipCity = :shipCity")
String findFreightByShipCity(@Bind("shipCity") String shipCity);
/*
* close with no args is used to close the connection
*/
void close();
}
DB2 への接続を開く
必要な接続プロパティを収集し、DB2 に接続するための適切なJDBC URL を作成します。
DB2 に接続するには以下のプロパティを設定します。
- Server: DB2 を実行するサーバー名。
- Port: DB2 サーバーのポート。
- Database: DB2 データベース名。
接続の準備ができたら、認証スキームを選択し、以下で説明するように適切なプロパティを設定します。
本製品 は、DB2 への認証に4つの異なるスキームをサポートします。DB2 ユーザー資格情報（デフォルト）、暗号化されたユーザー資格情報、IBM Identity and Access Management（IAM）認証、および Kerberos です。
DB2 ユーザー資格情報
ユーザー資格情報を使用して認証するには、次のプロパティを設定します。- AuthScheme：USRIDPWD。
- User：データベースへのアクセス権を持つユーザーのユーザー名。
- Password：データベースへのアクセス権を持つユーザーのパスワード。
暗号化されたユーザー資格情報
サーバーがセキュア認証に対応しており、暗号化されたユーザー資格情報を使用して認証を行いたい場合は、このプロパティを設定します。- AuthScheme：EUSRIDPWD
IAM、Kerberos で認証したい場合は、ヘルプドキュメントの「はじめに」セクションを参照してください。
パスワード方式によるSSH 接続
パスワード方式によるSSH接続時に必要なプロパティ一覧を以下に示します。
- User: DB2 のユーザ
- Password: DB2 のパスワード
- Database: DB2 の接続先データベース
- Server: DB2 のサーバー
- Port: DB2 のポート
- UserSSH: "true"
- SSHAuthMode: "Password"
- SSHPort: SSH のポート
- SSHServer: SSH サーバー
- SSHUser: SSH ユーザー
- SSHPassword: SSH パスワード
接続文字列形式では以下のようになります。
Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=testUseSSH=true;SSHAuthMode=Password;SSHPort=22;SSHServer=ssh-server;SSHUser=root;SSHPassword=sshpasswd;
公開鍵認証方式方式によるSSH 接続
公開鍵認証によるSSH接続時に必要なプロパティ一覧を以下に示します。
- User: DB2 のユーザ
- Password: DB2 のパスワード
- Database: DB2 の接続先データベース
- Server: DB2 のサーバー
- Port: DB2 のポート
- UserSSH: "true"
- SSHAuthMode: "Public_Key"
- SSHClientCertType: キーストアの種類
- SSHPort: SSH のポート
- SSHServer: SSH サーバー
- SSHUser: SSH ユーザー
- SSHClientCert: 秘密鍵ファイルのパス
接続文字列形式では以下のようになります。
Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=test;UseSSH=true;SSHAuthMode=Public_Key;SSHClientCertType=PUBLIC_KEY_FILE;SSHPort=22;SSHServer=ssh-server;SSHUser=root;SSHClientCert=C:\Keys\key.pem;
ビルトイン接続文字列デザイナー
JDBC URL の構成については、DB2 JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.db2.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
DB2 の接続文字列は、通常次のようになります。
jdbc:db2:Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=test;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:db2:Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=test;");
MyOrdersDAO dao = dbi.open(MyOrdersDAO.class);
//do stuff with the DAO
dao.close();
DB2 データ について
DB2 への接続を開いた状態で以前定義したメソッドを呼び出すだけで、DB2 のOrders エンティティからデータを取得できます。
//disply the result of our 'find' method
String freight = dao.findFreightByShipCity("New York");
System.out.println(freight);
DB2 データ の書き方
以前定義した方法を使用すれば、DB2 にデータを書き込むことも簡単になります。
//add a new entry to the Orders entity
dao.insert(newShipCity, newFreight);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for DB2 と統合することで、SQL Object API for DB2 を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムDB2 を操作しましょう。
関連コンテンツ
