CData JDBC Driver を使用して RabbitMQ を IBM WebSphere に接続
IBM WebSphere は、多くのエンタープライズレベルの Java アプリケーションやサービスを実行する強力なアプリケーションサーバーです。CData API Driver for JDBC と組み合わせることで、IBM WebSphere アプリケーションは複雑な API を使用せずに、標準 SQL クエリで RabbitMQ に接続し、データを操作できます。これにより、連携作業の簡素化、開発工数の削減、重要なビジネスデータへの安全なリアルタイムアクセスが可能になります。
前提条件
- RabbitMQ アカウントへのアクセス（API 権限付き）
- IBM WebSphere Application Server（構成済みで実行中）
- CData API Driver for JDBC
- デプロイ用の Java Servlet WAR アプリケーション
Note: この記事では Salesforce をデモ用のデータソースとして使用していますが、同じ手順で CData が提供する 250 種類以上の JDBC Driver に接続できます。
はじめに
ステップ1：CData API Driver for JDBC のダウンロードとインストール
CData API Driver for JDBC をダウンロードしてインストールします。インストールすると .jar ファイルが提供されます：cdata.jdbc.api.jar
ステップ2：IBM WebSphere のインストールと構成
- IBM 公式サイトから IBM WebSphere のアカウントを作成します。
- IBM WebSphere Application Server のドキュメントを参照して、ローカルシステムに IBM WebSphere Application Server をインストール・構成します。
- アプリケーションサーバーのインストールが完了したら、ブラウザで管理コンソールを使用して WebSphere Server を起動します：https://your-server:9043/ibm/console
ステップ3：RabbitMQ 用の JDBC プロバイダーとデータソースの設定
- Resources に移動し、JDBC セクションを展開して、JDBC providers を選択して新しいプロバイダーを作成します
- ドロップダウンメニューから適切なスコープを選択します
- New をクリックして JDBC プロバイダーを追加します
- データベースタイプとして User defined を選択します
- implementation class name として cdata.jdbc.api.APIConnectionPoolDataSource を入力します
- プロバイダーの名前を入力します（例：User defined JDBC Provider）
- classpath フィールドに JDBC ドライバー JAR ファイルのフルパスを入力します
- Next をクリックし、Finish をクリックして、マスター構成に変更を保存します
- JDBC プロバイダーが作成されたら、JDBC データソースを追加します。
- Data Source Name や JNDI name などの基本情報を入力します
- 先ほど作成した JDBC provider を選択します（例：CData RabbitMQ Provider）
- Implementation class name を指定します：cdata.jdbc.api.APIConnectionPoolDataSource
- Data Store Helper Class Name を追加します：com.ibm.websphere.rsadapter.GenericDataStoreHelper
- 必要に応じて authentication aliases を設定してセキュリティを構成します
- Summary ページですべての詳細を確認し、Finish をクリックしてデータソースの作成を完了します
- 一覧から新しく作成したデータソースを選択し、Custom properties を開きます
-
URL プロパティに JDBC 接続文字列を追加し、OK を押します。例：
jdbc:api:RTK=5246...;Profile=C:\profiles\\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;
RabbitMQ Management HTTP API について
RabbitMQ は、複数のメッセージングプロトコルをサポートするオープンソースのメッセージブローカーです。RabbitMQ Management HTTP API は、RabbitMQ サーバーの管理データと監視データに HTTP 経由でアクセスする手段を提供します。この API では、仮想ホスト、エクスチェンジ、キュー、バインディング、コネクション、チャネル、コンシューマー、ユーザー、権限、ポリシー、クラスター全体の統計情報を取得できます。
HTTP API を利用するには、RabbitMQ サーバーで Management プラグインを有効化する必要があります。デフォルトでは、管理インターフェースはポート 15672 でリッスンします。
Basic 認証の設定
RabbitMQ Management HTTP API は HTTP Basic 認証を使用します。RabbitMQ 管理ユーザーのユーザー名とパスワードを指定する必要があります。
管理 API へのアクセスを有効にするには、以下のステップで進めます：
- サーバーで RabbitMQ Management プラグインが有効になっていることを確認します（rabbitmq-plugins enable rabbitmq_management）。
- 既存の管理ユーザーを使用するか、適切な管理タグ（management、policymaker、monitoring、または administrator）を持つユーザーを作成します。
- RabbitMQ Management HTTP API の完全なベース URL を控えておきます（例：http://localhost:15672）。
RabbitMQ サーバーを設定したら、以下の接続プロパティを設定して接続します：
- AuthScheme：Basic に設定します。
- URL：RabbitMQ Management HTTP API のベース URL に設定します（例：http://localhost:15672）。
- User：RabbitMQ の管理ユーザー名に設定します（例：guest）。
- Password：RabbitMQ の管理パスワードに設定します。
接続文字列の例：
Profile=C:\profiles\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;
利用可能なテーブル
RabbitMQ プロファイルでは、以下のテーブルにアクセスできます：
- Overview - クラスター全体の統計情報と RabbitMQ ノードに関する情報
- Nodes - RabbitMQ クラスター内の個々のノードに関する情報
- NodeMemory - 特定のクラスターノードの詳細なメモリ使用状況の内訳
- Connections - ブローカーへのすべてのオープンな AMQP コネクションの一覧
- Channels - すべてのコネクションにわたるオープンな AMQP チャネルの一覧
- Consumers - すべてのキューに登録されたコンシューマーの一覧
- Exchanges - すべての仮想ホストで宣言されたエクスチェンジの一覧
- Queues - すべての仮想ホストで宣言されたキューの一覧
- Bindings - エクスチェンジとキュー間のすべてのバインディングの一覧
- VirtualHosts - ブローカーに設定された仮想ホストの一覧
- VhostPermissions - 特定の仮想ホスト内のユーザー権限
- Users - すべての RabbitMQ ユーザーの一覧
- Permissions - すべての仮想ホストにわたる全ユーザーの権限レコード
- TopicPermissions - 全ユーザーのトピックレベルの権限レコード
- Policies - 仮想ホスト内のキューおよびエクスチェンジに適用されたポリシーの一覧
- OperatorPolicies - 仮想ホスト内のキューに適用されたオペレーターポリシーの一覧
- Parameters - 仮想ホストごとのコンポーネントパラメータ（例：federation、shovel）の一覧
- GlobalParameters - すべての仮想ホストに適用されるグローバルパラメータの一覧
- VhostLimits - 特定の仮想ホストに設定されたリソース制限
- UserLimits - 特定のユーザーに設定されたリソース制限
- FeatureFlags - フィーチャーフラグの一覧と、ノード上での有効／無効の状態
- DeprecatedFeatures - 非推奨機能の一覧と、その使用状態
- AuthAttempts - ノードの認証試行統計
- ClusterName - RabbitMQ クラスターの名前
- WhoAmI - 現在認証されている管理ユーザーに関する情報
- ExchangeBindingsSource - 特定のエクスチェンジがソースとなっているバインディング
- ExchangeBindingsDestination - 特定のエクスチェンジが宛先となっているバインディング
- QueueBindings - 仮想ホスト内の特定のキューのバインディング
組み込みの接続文字列デザイナー
JDBC URL の作成には、RabbitMQ JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.api.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 ..\RabbitMQServletApp.war *
RabbitMQServletApp.war |--webcontent | |--index.jsp -- JSP ページ（エントリーポイント） | | | |--WEB-INF/ -- ブラウザから直接アクセス不可 | |--web.xml -- デプロイメント記述子 | | | |--classes/ -- コンパイル済み .class ファイル | |--com/example/RabbitMQ/ | |--RabbitMQServlet.class | |--lib/ -- 依存 JAR ファイル |--cdata.jdbc.rabbitmq.jar
ステップ5：WebSphere に RabbitMQ アプリケーションをデプロイ
- WebSphere 管理コンソールで Applications に移動し、Install New Application を選択します
- WAR ファイルを参照してアップロードし、インストールウィザードを進めます。
ステップ6：WebSphere から RabbitMQ のデータ を取得
- コンテキストルートを使用してアプリケーションにアクセスします：http://hostname:port/context-root/page
Note: ブラウザで開く前に、デプロイしたアプリケーションが起動していることを確認してください。
これでソースから取得したデータを表示できるようになりました。データは IBM WebSphere を通じて直接アクセスできます。このセットアップは、Servlet を WebSphere にデプロイして JDBC ドライバーを使用して RabbitMQ データを取得する方法を示しており、RabbitMQ を活用した高度なエンタープライズアプリケーションを構築するための強固な基盤となります。
RabbitMQ から IBM WebSphere への接続を始めましょう
CData JDBC Connector を使用して、今すぐ RabbitMQ から IBM WebSphere への接続を始めましょう。30日間の無料トライアルをダウンロードして、アプリケーションへの安全でリアルタイムなデータアクセスがいかに簡単に実現できるかをお試しください。ご不明な点がございましたら、サポートチームがいつでもお手伝いします。