CData ODBC Driver for RabbitMQ のセットアップ

---

このガイドでは、CData ODBC Driver for RabbitMQ を使い始めるために必要なすべてのステップを解説します。ドライバーのインストールとライセンス認証、初めての接続設定、そしてアプリケーションでRabbitMQ のデータを活用するための次のステップを学ぶことができます。

インストールとライセンス認証

システム要件

• Windows: Windows 10/11 または Windows Server 2016 以降
• Linux: UnixODBC がインストールされた主要なディストリビューション

ドライバーのインストール

Windows でのインストール

1. CData アカウントまたは評価版ダウンロードページから ODBC ドライバーのインストーラーをダウンロードします。
2. インストーラーを実行し、インストールウィザードの指示に従って進めます。
3. セットアッププロセスが自動的に進み、ドライバーがシステムに登録されます。
4. インストール中に、ライセンスを有効化するためのライセンスキーの入力を求められます。ライセンスキーは CData 注文チームからメールで届いているはずです。ライセンスキーは次のような形式です： XXXX-XXXX-XXXX-XXXX-XXXX
   • 注意：トライアル版をご利用の場合は、Trial Key オプションを選択してください。
5. 32 ビット版と 64 ビット版の両方のドライバーが含まれています。異なるアーキテクチャのアプリケーションを使用する場合は、両方をインストールしてください。

Linux でのインストール

1. UnixODBC がインストールされていることを確認します： sudo apt-get install unixodbc unixodbc-dev (Debian/Ubuntu) sudo yum install unixODBC unixODBC-devel (RHEL/CentOS)
2. ドライバーパッケージを /opt/cdata/ に展開します
3. ドライバーは自動的に /etc/odbcinst.ini に登録されます

---

ライセンスの有効化

ライセンスキーは CData 注文チームからメールで届いているはずです。ライセンスキーは次のような形式です： XXXX-XXXX-XXXX-XXXX-XXXX

Windows でのライセンス認証

通常、ライセンスはインストール時に有効化されます。ただし、手動で有効化が必要な場合もあります。以下の手順で手動認証を行います：

1. スタートメニューから ODBC ドライバーアプリケーションを開きます。
2. Help > Licensing に移動します
3. 表示されたフィールドにライセンスキーを入力します。
4. Activate をクリックします
5. 「Licensed」ステータスが表示されれば、認証は完了です。

Linux でのライセンス認証

1. ドライバーパッケージを展開したインストールディレクトリに移動します（例：cd /opt/cdata/cdata-odbc-driver-for-acumatica/bin/）
2. 次のコマンドを実行してライセンスファイルを作成します：sudo ./install-license.sh
3. を実際のライセンスキーに置き換えてください。
4. トライアル版を有効化する場合は、 を省略してください。

---

よくあるライセンスに関する質問

ライセンスを複数のマシンで使用できますか？
はい、サブスクリプションプランによって異なります。詳細については注文確認書を確認するか、担当営業にお問い合わせください。担当者が不明な場合は [email protected] までご連絡ください。

ライセンスキーを紛失しました。再発行できますか？
[email protected] に注文番号を添えてメールをお送りください。ライセンスキーを再送いたします。

ライセンスを別のマシンに移行できますか？
はい、可能です。別のマシンへの移行時には、以下のリンクからライセンス移行リクエストを送信してください：

https://jp.cdata.com/contact/

ライセンス移行リクエストが送信され正常に処理されると、プロダクトキーにアクティベーションが追加され、別のマシンでフルライセンスを有効化できるようになります。この処理が完了すると、以前のマシンのライセンスは無効になります。

その他のライセンスに関するご質問は [email protected] までお問い合わせください。ライセンスの確認やアップグレードは、セルフサービスポータル portal.cdata.com から行えます。

---

接続設定

ドライバーのインストールとライセンス認証が完了したら、RabbitMQ への接続を設定しましょう。ODBC ドライバーは DSN（データソース名）を使用して接続プロパティを保存します。

DSN の作成

Windows：ODBC データソースアドミニストレーターを使用

1. ODBC データソースアドミニストレーター（64 ビット）を開きます
   注意：64 ビットアプリケーションには 64 ビット版、32 ビットアプリケーションには 32 ビット版を使用してください。
   • Windows のスタートメニューで「ODBC」を検索
   • または、コントロールパネル > 管理ツール > ODBC データソースから開きます
2. システム DSN または ユーザー DSN タブをクリックします
   • システム DSN：マシン上のすべてのユーザーが利用可能（サービス用に推奨）
   • ユーザー DSN：現在のユーザーのみ利用可能
3. リストから CData API Driver for ODBC を選択するか、追加 をクリックして新しいデータソースを作成します。
4. OK または 完了 をクリックして接続設定ダイアログを開きます。

Linux：設定ファイルの編集（odbcinst.ini と odbc.ini）

1. odbcinst.ini ファイルに以下のセクションを追加してドライバーを登録します。
[CData API Driver for ODBC] Driver=/opt/cdata/cdata-odbc-driver-for-api/lib/libapiodbc.x64.so Description=CData API Driver for ODBC
2. ファイルを保存します。
3. odbc.ini ファイルに以下のエントリを追加して DSN を作成します：
[CData RabbitMQ Source] Driver=/opt/cdata/cdata-odbc-driver-for-api/lib/libapiodbc.x64.so ConnectionProperty1=Value1 ConnectionProperty2=Value2 Profile = C:\profiles\\RabbitMQ.apip AuthScheme = Basic URL = http://localhost:15672 User = guest Password = guest
4. ファイルを保存します。

---

接続プロパティの設定

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 へのアクセスを有効にするには、以下のステップで進めます：

1. サーバーで RabbitMQ Management プラグインが有効になっていることを確認します（rabbitmq-plugins enable rabbitmq_management）。
2. 既存の管理ユーザーを使用するか、適切な管理タグ（management、policymaker、monitoring、または administrator）を持つユーザーを作成します。
3. 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 - 仮想ホスト内の特定のキューのバインディング

---

接続のテスト

1. 接続プロパティを入力したら、Test Connection をクリックします。
2. テストが成功すると、以下が確認できます：
   • 認証情報が正しい
   • ネットワーク接続が確立されている
   • 必要な権限が設定されている
3. テストが失敗した場合、エラーメッセージに修正すべき点が表示されます。
4. OK をクリックして DSN を保存します。

---

よくある接続の問題

認証に失敗

解決策：認証情報が最新であることを確認してください。OAuth アプリケーションの場合、アプリケーションのセキュリティ設定で CData を認可する必要があるかもしれません。認可に関するサポートは [email protected] までお問い合わせください。

サーバーに接続できない

解決策：ファイアウォールとプロキシの設定を確認してください。特定のポート要件については [email protected] までお問い合わせください。

テーブルが見つからない

解決策：データベース名とスキーマ名を確認してください。DSN 設定の Data Model タブで利用可能なテーブルを確認できます。

ドライバーが見つからない（Linux）

解決策：ドライバーが odbcinst.ini に正しく登録されていることを確認してください。詳しいサポートは [email protected] までお問い合わせください。

その他の接続に関するトラブルシューティングは、具体的なエラーメッセージを添えて [email protected] までお問い合わせください。

---

次のステップ

ドライバーのインストール、ライセンス認証、接続設定が完了したので、ODBC ドライバーを活用できるシナリオをご紹介します：

---

サポート

お困りの際はお気軽にお問い合わせください：

• テクニカルサポート：[email protected]
• コミュニティフォーラム：CData Community Site
• ヘルプドキュメント：ローカルインストール版とオンライン版があります

---

よくある質問

インストールとライセンス

• ドライバーのインストールに管理者権限は必要ですか？
  はい、Windows と Linux のどちらでもシステム全体へのインストールには管理者権限が必要です。
• 32 ビットと 64 ビットのドライバーを同じマシンにインストールできますか？
  はい、デフォルトで両方のバージョンがインストールされます。

接続

• システム DSN とユーザー DSN の違いは何ですか？
  システム DSN はマシン上のすべてのユーザーが利用でき、サービスで必要です。ユーザー DSN は作成したユーザーのみが利用できます。
• DSN を作成せずに DSN レス接続文字列を使用できますか？
  はい。多くのアプリケーションは DSN レス接続文字列をサポートしています。以下の接続文字列の例をご参照ください：

  Driver={CData API Driver for ODBC};RequiredConnectionProperty1=Value1;RequiredConnectionProperty2=Value2;

• 複数の RabbitMQ アカウントに接続するにはどうすればよいですか？
  アカウントごとに個別の DSN を作成し、それぞれに認証情報を設定してください。
• プロキシサーバー経由で接続できますか？
  はい。DSN の接続プロパティでプロキシ設定を行ってください。プロキシ設定の詳細はヘルプドキュメントの Firewall & Proxy セクションをご参照ください。

パフォーマンスとトラブルシューティング

• クエリが遅いのはなぜですか？
  以下を確認してください：
  • 変更頻度の低いデータにはキャッシュを使用します。詳細はヘルプドキュメントの Caching Data セクションをご参照ください。
  • フィルタ（WHERE 句）を追加して結果セットのサイズを小さくします。
  • クエリ最適化のサポートは [email protected] までお問い合わせください。
• トラブルシューティング用のログを有効にするにはどうすればよいですか？
  DSN に以下を追加してください：
  • Logfile: /path/to/logfile.log
  • Verbosity: 3

  [email protected] にトラブルシューティングをご依頼の際は、ログファイルを安全にアップロードできるようご準備ください。

• ドライバーにはどのポートへのアクセスが必要ですか？
  データソースによって異なります。ほとんどのクラウドアプリケーションは HTTPS（ポート 443）を使用します。具体的なファイアウォール要件については [email protected] までお問い合わせください。
• Linux コンテナや Docker でドライバーを使用できますか？
  はい。コンテナイメージにドライバーをインストールし、コンテナの /etc/odbc.ini ファイルで DSN を設定してください。

その他

• サポートされている SQL 操作の完全なリストはどこで確認できますか？
  完全な SQL リファレンスについてはヘルプドキュメントの SQL Compliance の章をご参照ください。
• ドライバーの更新頻度は？
  CData は年に一度、ドライバーのメジャーバージョンアップデートをリリースしています。最新バージョンについてはアカウントポータルを確認するか、[email protected] までお問い合わせください。
• プログラミング言語ごとのコード例はどこで確認できますか？
  言語固有の例（Python、PHP、C# など）についてはヘルプドキュメントの Using ODBC セクションをご確認ください。

この FAQ で解決しないご質問は [email protected] までお問い合わせください。