CData JDBC Driver を使用して UM SaaS Cloud を IBM WebSphere に接続
IBM WebSphere は、多くのエンタープライズレベルの Java アプリケーションやサービスを実行する強力なアプリケーションサーバーです。CData JDBC Driver for UM SaaS Cloud と組み合わせることで、IBM WebSphere アプリケーションは複雑な API を使用せずに、標準 SQL クエリで UM SaaS Cloud に接続し、データを操作できます。これにより、連携作業の簡素化、開発工数の削減、重要なビジネスデータへの安全なリアルタイムアクセスが可能になります。
前提条件
- UM SaaS Cloud アカウントへのアクセス(API 権限付き)
- IBM WebSphere Application Server(構成済みで実行中)
- CData JDBC Driver for UM SaaS Cloud
- デプロイ用の Java Servlet WAR アプリケーション
Note: この記事では Salesforce をデモ用のデータソースとして使用していますが、同じ手順で CData が提供する 250 種類以上の JDBC Driver に接続できます。
はじめに
ステップ1:CData JDBC Driver for UM SaaS Cloud のダウンロードとインストール
CData JDBC Driver for UM SaaS Cloud をダウンロードしてインストールします。インストールすると .jar ファイルが提供されます:cdata.jdbc.umsaascloud.jar
ステップ2:IBM WebSphere のインストールと構成
- IBM 公式サイトから IBM WebSphere のアカウントを作成します。
- IBM WebSphere Application Server のドキュメントを参照して、ローカルシステムに IBM WebSphere Application Server をインストール・構成します。
- アプリケーションサーバーのインストールが完了したら、ブラウザで管理コンソールを使用して WebSphere Server を起動します:https://your-server:9043/ibm/console
ステップ3:UM SaaS Cloud 用の JDBC プロバイダーとデータソースの設定
- Resources に移動し、JDBC セクションを展開して、JDBC providers を選択して新しいプロバイダーを作成します
- ドロップダウンメニューから適切なスコープを選択します
- New をクリックして JDBC プロバイダーを追加します
- データベースタイプとして User defined を選択します
- implementation class name として cdata.jdbc.umsaascloud.UMSaaSCloudConnectionPoolDataSource を入力します
- プロバイダーの名前を入力します(例:User defined JDBC Provider)
- classpath フィールドに JDBC ドライバー JAR ファイルのフルパスを入力します
- Next をクリックし、Finish をクリックして、マスター構成に変更を保存します
- JDBC プロバイダーが作成されたら、JDBC データソースを追加します。
- Data Source Name や JNDI name などの基本情報を入力します
- 先ほど作成した JDBC provider を選択します(例:CData UM SaaS Cloud Provider)
- Implementation class name を指定します:cdata.jdbc.umsaascloud.UMSaaSCloudConnectionPoolDataSource
- Data Store Helper Class Name を追加します:com.ibm.websphere.rsadapter.GenericDataStoreHelper
- 必要に応じて authentication aliases を設定してセキュリティを構成します
- Summary ページですべての詳細を確認し、Finish をクリックしてデータソースの作成を完了します
- 一覧から新しく作成したデータソースを選択し、Custom properties を開きます
-
URL プロパティに JDBC 接続文字列を追加し、OK を押します。例:
jdbc:umsaascloud:RTK=5246...;AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;
UM SaaS Cloud 接続プロパティの取得・設定方法
デフォルトでは、CData 製品は本番環境に接続します。UMSaaSCloud sandbox アカウントを使用するには、UseSandbox をtrue に設定します。ユーザー / パスワード認証を使用している場合は、User にsandbox のユーザー名を設定してください。
UM SaaS Cloud への認証
UM SaaS Cloud は、Basic、OAuth、OAuthJWT(コンシューマーキー)など、複数の認証方式をサポートしています。ここではBasic 認証について説明します。認証情報の詳しい取得方法や他の認証方法については、ヘルプドキュメントの「はじめに」セクションを参照してください。
Basic 認証
Basic 認証は、セキュリティトークンとユーザー資格情報の使用に基づきます。Basic 認証を使用するには、AuthScheme をBasic に、User とPassword をログイン資格情報に設定し、SecurityToken を設定します。
デフォルトではSecurityToken が必要ですが、UM SaaS Cloud で信頼できるIP アドレスの範囲を設定することで、オプションにすることができます。
組み込みの接続文字列デザイナー
JDBC URL の作成には、UM SaaS Cloud JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.umsaascloud.jar接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Note: URL プロパティが利用できない場合は、作成してから JDBC 接続文字列を追加してください。
Tip: URL プロパティに入力する前に、必ずドライバーで接続文字列をテストしてください。
- データソースを開き、Test Connection を選択します
ステップ4:Web アプリケーションのビルド
- お好みの Java フレームワーク(Servlet、JSP、Spring)を使用して Web アプリケーションをビルドします。生成される .war ファイルは通常、次のような構造になります:
- JDBC または JPA を使用してデータアクセスロジックを定義し、JNDI 名でデータソースを参照します
- この記事では、JDBC 接続の設定と Java Servlet アプリケーションのデプロイについて説明します
- プロジェクトを WAR(Web Application Archive)または EAR(Enterprise Archive)ファイルとしてパッケージ化してデプロイします
- ターミナルで以下のコマンドを使用して Java ファイルをコンパイルします:
cd webcontent jar cvf ..\UM SaaS CloudServletApp.war *
UM SaaS CloudServletApp.war |--webcontent | |--index.jsp -- JSP ページ(エントリーポイント) | | | |--WEB-INF/ -- ブラウザから直接アクセス不可 | |--web.xml -- デプロイメント記述子 | | | |--classes/ -- コンパイル済み .class ファイル | |--com/example/UM SaaS Cloud/ | |--UM SaaS CloudServlet.class | |--lib/ -- 依存 JAR ファイル |--cdata.jdbc.umsaascloud.jar
ステップ5:WebSphere に UM SaaS Cloud アプリケーションをデプロイ
- WebSphere 管理コンソールで Applications に移動し、Install New Application を選択します
- WAR ファイルを参照してアップロードし、インストールウィザードを進めます。
ステップ6:WebSphere から UM SaaS Cloud のデータ を取得
- コンテキストルートを使用してアプリケーションにアクセスします:http://hostname:port/context-root/page
Note: ブラウザで開く前に、デプロイしたアプリケーションが起動していることを確認してください。
これでソースから取得したデータを表示できるようになりました。データは IBM WebSphere を通じて直接アクセスできます。このセットアップは、Servlet を WebSphere にデプロイして JDBC ドライバーを使用して UM SaaS Cloud データを取得する方法を示しており、UM SaaS Cloud を活用した高度なエンタープライズアプリケーションを構築するための強固な基盤となります。
UM SaaS Cloud から IBM WebSphere への接続を始めましょう
CData JDBC Connector を使用して、今すぐ UM SaaS Cloud から IBM WebSphere への接続を始めましょう。30日間の無料トライアルをダウンロードして、アプリケーションへの安全でリアルタイムなデータアクセスがいかに簡単に実現できるかをお試しください。ご不明な点がございましたら、サポートチームがいつでもお手伝いします。