CData Excel Add-In for RabbitMQ はじめに：インストールから接続まで
このガイドでは、CData API Driver for Excel の使い方を詳しく解説します。アドインのインストール、ライセンスの仕組み、初回接続の設定、そしてリアルタイムの RabbitMQ のデータ を Excel に直接インポートして分析、レポート作成、自動化を行う方法を学べます。
インストールとライセンス認証
システム要件
- Windows： Windows 10/11 または Windows Server 2016 以降
- Microsoft Excel： Excel 2016 以降、Excel for Microsoft 365
- .NET Framework： .NET Framework 4.0 以降
Excel Add-In のインストール
CData Web サイトの Excel Add-In ダウンロードページから Excel Add-In をダウンロードしてインストールします。プロンプトが表示されたら、必要な連絡先情報を入力してください。 Excel Add-In download page. Fill in the appropriate contact information when prompted.
Note：ライセンス版のインストーラーをダウンロードする場合は、会社のメールアドレスとライセンスキーを使用してください。
- インストーラーを実行し、セットアップウィザードに従います
- インストールが完了したら、Excel を開き、Excel リボンに CData タブが表示されていることを確認します
Excel Add-In のライセンス認証
Excel Add-In はインストール時にライセンス認証を処理します。インストーラーの実行時に以下を選択できます：
- 試用版ライセンスを使用する、または
- CData から提供されたライセンス版ビルドをインストールする
サブスクリプションライセンスが必要な場合は、CData Orders チーム（[email protected]）にお問い合わせいただき、ライセンスキーを取得してください。アドインがインストールされると、すぐに使用できる状態になります。
ライセンスに関するよくある質問
アドインを複数のマシンにインストールできますか？
サブスクリプションプランによって、含まれるアクティベーション数が決まります。詳細については [email protected] までお問い合わせください。
ライセンスキーを紛失しました。どうすれば取得できますか？
注文番号を添えて [email protected] までメールでお問い合わせいただければ、ライセンスキーを再送いたします。
ライセンスを移行するにはどうすればよいですか？
ライセンスを別のマシンに移行するには、以下のリンクからライセンス移行リクエストを送信する必要があります：
https://jp.cdata.com/contact/
ライセンス移行リクエストが送信され、正常に処理されると、プロダクトキーにアクティベーションが追加され、別のマシンで正規ライセンスを認証できるようになります。このプロセスが完了すると、以前のマシンのライセンスは無効になります。
ライセンスに関するその他のご質問は、[email protected] までお問い合わせください。ライセンスの確認とアップグレードは、セルフサービスポータル portal.cdata.com から行えます。
接続設定
アドインがインストールされたら、Excel リボンから直接 RabbitMQ へのセキュアな接続を設定できます。アドインは接続設定を Excel 環境内に保存し、それを使用してライブの RabbitMQ のデータ を取得します。
新しい接続の作成
- Excel を開き、リボンの CData タブに移動します
- データの取得 > From RabbitMQ をクリックします。次に、 New API Connection をクリックして新しい接続を作成します
- 接続に名前を付け、必要に応じて Update、Insert、Delete 操作を有効にします
- CData 接続ダイアログが開きます。RabbitMQ に必要な認証情報（OAuth、API トークン、資格情報など）を入力します
接続プロパティの設定
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 - 仮想ホスト内の特定のキューのバインディング
接続テスト
- 接続テストをクリックして入力内容を検証します
- OK をクリックして接続を保存します
Excel へのデータインポート
接続を作成したら、組み込みのクエリインターフェースを使用して RabbitMQ のデータ を Excel にインポートできます。
テーブルとビューの選択
- CData リボンから データの取得 > From RabbitMQ をクリックし、作成した接続を選択します
- CData クエリウィンドウが開きます。選択をクリックしてテーブルまたはビューを選択します
- 目的のテーブルを選択し、OK をクリックします
クエリの実行
- 選択したテーブルに対して SQL クエリが自動的に生成されます
- クエリを確認し（任意）、OK をクリックして実行します
- 結果が Excel ワークシートに直接表示されます
これで、ピボットテーブルやグラフを作成したり、Excel の数式を使用して RabbitMQ のデータ を分析できます。
よくある接続の問題
認証エラー
解決策： 資格情報または OAuth 設定を確認してください。RabbitMQ アカウントに必要な API 権限があることを確認してください。
RabbitMQ に接続できない
解決策： インターネット接続、ファイアウォール設定、またはプロキシ設定を確認してください。特定のポート要件については [email protected] までお問い合わせください。
テーブルが見つからない
解決策： アカウントが選択した RabbitMQ のデータ オブジェクトにアクセスできることを確認してください。クエリウィンドウのテーブルセレクターを使用して、利用可能なリソースを参照してください。
クエリ結果が返されない
解決策： 生成された SQL のフィルターまたは WHERE 句を確認してください。フィルターを削除または調整して、クエリの範囲を広げてください。
次のステップ
Excel Add-In のインストール、ライセンス認証、接続設定が完了しました。次は、レポートの自動化、ライブダッシュボードの更新、SQL や Excel 関数を使用した高度なクエリの作成方法をご覧ください。
| Excel Add-In | 記事タイトル |
|---|---|
| Excel CDATAQUERY | CDATAQUERY 関数を使って、Excel スプレッドシートにRabbitMQ を自動挿入 |
| Microsoft Excel | 【ノーコード】RabbitMQのデータをExcelで取得する方法 |
| Excel Add-In Setup | CData Excel Add-In for RabbitMQ はじめに：インストールから接続まで |
サポート
ご不明な点がございましたら、お気軽にお問い合わせください：
- テクニカルサポート： [email protected]
- コミュニティフォーラム： CData Community Site
- ヘルプドキュメント： ローカルにインストールされているほか、オンラインでも参照可能です
よくある質問
インストールとライセンス
- アドインのインストールには管理者権限が必要ですか？
はい、インストールには管理者権限が必要です。 - ライセンスを認証するにはどうすればよいですか？
ライセンス認証はインストール時に行われます。ライセンス版のインストーラーはサブスクリプションキーを自動的に適用します。
接続
- 複数の RabbitMQ アカウントを使用できますか？
データの取得をクリックするたびに、新しい接続を設定できます。 - プロキシ経由で接続できますか？
はい、接続ダイアログでプロキシ設定を構成できます。
パフォーマンスとトラブルシューティング
- クエリが遅いのはなぜですか？
クエリエディターでフィルターを追加するか、選択するフィールドを絞り込んでください。 - ログを有効にするにはどうすればよいですか？
接続マネージャーに以下を追加してください：
- Logfile: /path/to/logfile.log
- Verbosity: 3
トラブルシューティングの際は、[email protected] にご連絡の上、ログファイルを安全にアップロードしてください。
- データを更新するにはどうすればよいですか？
インポートしたテーブルを選択し、CData リボンから更新をクリックしてください。
この FAQ で解決しない場合は、[email protected] までお問い合わせください。