各製品の資料を入手。
詳細はこちら →
製品をチェック
Jetty コネクションプールからIBM Cloud Object Storage のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします：本記事では、Jetty のWeb アプリからIBM Cloud Object Storage のデータに連携する手順を説明します。
最終更新日：2023-06-18
この記事で実現できるIBM Cloud Object Storage 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for IBMCloudObjectStorage は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にIBM Cloud Object Storage のデータをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for IBMCloudObjectStorage を設定します。
DBC Driver for IBMCloudObjectStorage を JNDI Data Source として設定
次の手順で、Jetty とIBM Cloud Object Storage の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi- JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、IBM Cloud Object Storage のデータソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
<Configure id='ibmcloudobjectstoragedemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="ibmcloudobjectstoragedemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="ibmcloudobjectstoragedemo"/></Arg> <Arg>jdbc/ibmcloudobjectstoragedb</Arg> <Arg> <New class="cdata.jdbc.ibmcloudobjectstorage.IBMCloudObjectStorageDriver"> <Set name="url">jdbc:ibmcloudobjectstorage:</Set> <Set name="ApiKey">myApiKey</Set> <Set name="CloudObjectStorageCRN">MyInstanceCRN</Set> <Set name="Region">myRegion</Set> <Set name="OAuthClientId">MyOAuthClientId</Set> <Set name="OAuthClientSecret">myOAuthClientSecret</Set> </New> </Arg> </New> </Configure>Cloud Object Storage 接続プロパティの取得・設定方法
Cloud Object Storage に接続する前に、Cloud Object Storage インスタンスを登録してCloud Object Storage API キーとCRN を取得していきます。
Cloud Object Storage の新規インスタンスの登録
IBM Cloud アカウントにCloud Object Storage がまだない場合は、以下の手順に従ってアカウントにSQL Query のインスタンスをインストールできます。
- IBM Cloud アカウントにログインします。
- Cloud Object Storage ページに移動して、インスタンス名を指定して「作成」をクリックします。Cloud Object Storage の新規インスタンスにリダイレクトされます。
API キー
API キーは以下の手順で取得できます。
- まずは、IBM Cloud アカウントにログインします。
- API キーページに移動します。
- 中央右隅のIBM Cloud APIキーの作成 をクリックして、新しいAPI キーを作成します。
- ポップアップウィンドウが表示されたら、API キーの名前を指定して作成をクリックします。ダッシュボードからはアクセスできなくなるため、API Key を控えておきましょう。
Cloud Object Storage CRN
デフォルトでは、CData 製品はCloud Object Storage CRN を自動で取得します。ただし、複数のアカウントがある場合は、CloudObjectStorageCRN を明示的に指定する必要があります。この値は、次の2つの方法で取得できます。
- Services ビューをクエリする。これにより、IBM Cloud Object Storage インスタンスとそれぞれのCRN がリストされます。
- IBM Cloud で直接CRN を見つける。これを行うには、IBM Cloud のダッシュボードに移動します。リソースリストで、ストレージからCloud Object Storage リソースを選択してCRN を取得します。
IBM Cloud Object Storage への接続
これで準備は完了です。以下の接続プロパティを設定してください。
- InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 認証を繰り返す必要がなく、さらに自動でアクセストークンを設定できます。
- ApiKey：セットアップ中に控えたAPI キーを指定。
- CloudObjectStorageCRN（オプション）：控えておいたCloud Object Storage のCRN に設定。Cloud Object Storage アカウントが複数ある場合のみ設定する必要があります。
プロパティを設定したら、これで接続設定は完了です。
-
Web xml でリソースを設定します:
jdbc/ibmcloudobjectstoragedb javax.sql.DataSource Container -
これで、java:comp/env/jdbc/ibmcloudobjectstoragedb へのルックアップでIBM Cloud Object Storage のデータにアクセスできます:
InitialContext ctx = new InitialContext(); DataSource myibmcloudobjectstorage = (DataSource)ctx.lookup("java:comp/env/jdbc/ibmcloudobjectstoragedb");
Jetty にさらに統合
ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 参照してください。
関連コンテンツ
