本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for ApachePhoenix は、Java アプリケーションとリアルタイムPhoenix data のデータ連携を実現します。これらの技術を組み合わせることによって、Phoenix data へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するPhoenix data の読み書きのためのコードの作成について説明します。
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyMyTableDAO {
//request specific data from Phoenix (String type is used for simplicity)
@SqlQuery("SELECT Column1 FROM MyTable WHERE Id = :id")
String findColumn1ById(@Bind("id") String id);
/*
* close with no args is used to close the connection
*/
void close();
}
必要な接続プロパティを収集し、Phoenix に接続するための適切なJDBC URL を作成します。
Phoenix Query Server 経由でApache Phoenix に接続します。デフォルトのポートと異なる場合は、Server とPort プロパティを設定してApache Phoenix に接続します。Servre プロパティは通常、Apache Phoenix をホストしているサーバーのホスト名またはIP アドレスです。
デフォルトでは、認証は使用されません(プレーン)。サーバーに認証が設定されている場合は、AuthScheme をNEGOTIATE に設定して、 必要な場合にはUser とPassword プロパティを設定して、Kerberos で認証します。
JDBC URL の構成については、Phoenix JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.apachephoenix.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Phoenix の接続文字列は、通常次のようになります。
jdbc:apachephoenix:Server=localhost;Port=8765;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:apachephoenix:Server=localhost;Port=8765;");
MyMyTableDAO dao = dbi.open(MyMyTableDAO.class);
//do stuff with the DAO
dao.close();
Phoenix への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Phoenix のMyTable エンティティからデータを取得できます。
//disply the result of our 'find' method
String column1 = dao.findColumn1ById("123456");
System.out.println(column1);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for ApachePhoenix と統合することで、SQL Object API for ApachePhoenix を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでライブPhoenix を操作しましょう。