CData JDBC Driver を使用して HubDB を IBM WebSphere に接続

Anusha M B
Technical Marketing Engineer

CData JDBC Driver を使用して HubDB を IBM WebSphere に接続し、シームレスなデータ連携を実現します。

IBM WebSphere は、多くのエンタープライズレベルの Java アプリケーションやサービスを実行する強力なアプリケーションサーバーです。CData JDBC Driver for HubDB と組み合わせることで、IBM WebSphere アプリケーションは複雑な API を使用せずに、標準 SQL クエリで HubDB に接続し、データを操作できます。これにより、連携作業の簡素化、開発工数の削減、重要なビジネスデータへの安全なリアルタイムアクセスが可能になります。

前提条件

HubDB アカウントへのアクセス（API 権限付き）
IBM WebSphere Application Server（構成済みで実行中）
CData JDBC Driver for HubDB
デプロイ用の Java Servlet WAR アプリケーション

Note: この記事では Salesforce をデモ用のデータソースとして使用していますが、同じ手順で CData が提供する 250 種類以上の JDBC Driver に接続できます。

はじめに

ステップ1：CData JDBC Driver for HubDB のダウンロードとインストール

CData JDBC Driver for HubDB をダウンロードしてインストールします。インストールすると .jar ファイルが提供されます：cdata.jdbc.hubdb.jar

ステップ2：IBM WebSphere のインストールと構成

IBM 公式サイトから IBM WebSphere のアカウントを作成します。
IBM WebSphere Application Server のドキュメントを参照して、ローカルシステムに IBM WebSphere Application Server をインストール・構成します。
アプリケーションサーバーのインストールが完了したら、ブラウザで管理コンソールを使用して WebSphere Server を起動します：https://your-server:9043/ibm/console

ステップ3：HubDB 用の JDBC プロバイダーとデータソースの設定

Resources に移動し、JDBC セクションを展開して、JDBC providers を選択して新しいプロバイダーを作成します

ドロップダウンメニューから適切なスコープを選択します

New をクリックして JDBC プロバイダーを追加します

データベースタイプとして User defined を選択します
implementation class name として cdata.jdbc.hubdb.HubDBConnectionPoolDataSource を入力します
プロバイダーの名前を入力します（例：User defined JDBC Provider）
classpath フィールドに JDBC ドライバー JAR ファイルのフルパスを入力します
Next をクリックし、Finish をクリックして、マスター構成に変更を保存します

JDBC プロバイダーが作成されたら、JDBC データソースを追加します。

Data Source Name や JNDI name などの基本情報を入力します
先ほど作成した JDBC provider を選択します（例：CData HubDB Provider）
Implementation class name を指定します：cdata.jdbc.hubdb.HubDBConnectionPoolDataSource
Data Store Helper Class Name を追加します：com.ibm.websphere.rsadapter.GenericDataStoreHelper
必要に応じて authentication aliases を設定してセキュリティを構成します
Summary ページですべての詳細を確認し、Finish をクリックしてデータソースの作成を完了します

一覧から新しく作成したデータソースを選択し、Custom properties を開きます
URL プロパティに JDBC 接続文字列を追加し、OK を押します。例：
```
jdbc:hubdb:RTK=5246...;AuthScheme=OAuth;OAuthClientID=MyOAuthClientID;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;
```
HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

カスタムOAuthアプリを使用する

すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。
1. HubSpotアプリ開発者アカウントにログインします。
  - アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
2. 開発者アカウントのホームページで、アプリタブをクリックします。
3. アプリを作成をクリックします。
4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
  - デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
  - Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
7. 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。
8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。
  
  テーブルにアクセスするには、最低限以下のスコープが必要です：
  - hubdb
  - oauth
  - crm.objects.owners.read
9. 変更を保存をクリックします。
10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
  - 「インストールURL（OAuth）」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
  - コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
  - アプリを接続をクリックします。結果のタブは閉じて構いません。
プライベートアプリを使用する

HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

以下の手順に従ってプライベートアプリケーショントークンを生成できます：
1. HubDBアカウントで、メインナビゲーションバーの設定アイコン（歯車）をクリックします。
2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
3. プライベートアプリを作成をクリックします。
4. 基本情報タブで、アプリケーションの詳細（名前、ロゴ、説明）を設定します。
5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。
接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。

組み込みの接続文字列デザイナー

JDBC URL の作成には、HubDB JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
      java -jar cdata.jdbc.hubdb.jar
      
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Note: URL プロパティが利用できない場合は、作成してから JDBC 接続文字列を追加してください。
Tip: URL プロパティに入力する前に、必ずドライバーで接続文字列をテストしてください。
データソースを開き、Test Connection を選択します

ステップ4：Web アプリケーションのビルド

お好みの Java フレームワーク（Servlet、JSP、Spring）を使用して Web アプリケーションをビルドします。生成される .war ファイルは通常、次のような構造になります：

		HubDBServletApp.war
		|--webcontent
		|  |--index.jsp                 -- JSP ページ（エントリーポイント）
		|  |
		|  |--WEB-INF/                  -- ブラウザから直接アクセス不可
		|     |--web.xml                 -- デプロイメント記述子
		|     |
		|     |--classes/                  -- コンパイル済み .class ファイル
		|       |--com/example/HubDB/
		|          |--HubDBServlet.class
		|
		|--lib/                      -- 依存 JAR ファイル
		|--cdata.jdbc.hubdb.jar

JDBC または JPA を使用してデータアクセスロジックを定義し、JNDI 名でデータソースを参照します
この記事では、JDBC 接続の設定と Java Servlet アプリケーションのデプロイについて説明します
プロジェクトを WAR（Web Application Archive）または EAR（Enterprise Archive）ファイルとしてパッケージ化してデプロイします

ターミナルで以下のコマンドを使用して Java ファイルをコンパイルします：
```
			cd webcontent
			jar cvf ..\HubDBServletApp.war *
		
```

ステップ5：WebSphere に HubDB アプリケーションをデプロイ

WebSphere 管理コンソールで Applications に移動し、Install New Application を選択します
WAR ファイルを参照してアップロードし、インストールウィザードを進めます。

ステップ6：WebSphere から HubDB のデータを取得

コンテキストルートを使用してアプリケーションにアクセスします：http://hostname:port/context-root/page

Note: ブラウザで開く前に、デプロイしたアプリケーションが起動していることを確認してください。

これでソースから取得したデータを表示できるようになりました。データは IBM WebSphere を通じて直接アクセスできます。このセットアップは、Servlet を WebSphere にデプロイして JDBC ドライバーを使用して HubDB データを取得する方法を示しており、HubDB を活用した高度なエンタープライズアプリケーションを構築するための強固な基盤となります。

HubDB から IBM WebSphere への接続を始めましょう

CData JDBC Connector を使用して、今すぐ HubDB から IBM WebSphere への接続を始めましょう。30日間の無料トライアルをダウンロードして、アプリケーションへの安全でリアルタイムなデータアクセスがいかに簡単に実現できるかをお試しください。ご不明な点がございましたら、サポートチームがいつでもお手伝いします。

はじめる準備はできましたか？

HubDB Driver の無料トライアルをダウンロードしてお試しください：

ダウンロード

詳細：

HubDB JDBC Driver お問い合わせ

HubDB データと連携するパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

CData JDBC Driver を使用して HubDB を IBM WebSphere に接続

前提条件

はじめに