Cognos BI でRabbitMQ のデータを使ってデータビジュアライゼーションを作成

CData ODBC Driver for API を使って、RabbitMQ のデータをドラッグアンドドロップ スタイルのCognos Report Studio に連携できます。この記事では、データビジュアライゼーションをSQL を書かずに作成するグラフィカルアプローチと、RabbitMQ がサポートする任意のSQL クエリを実行する方法の両方について説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持った製品です。

1. RabbitMQ をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
2. 多様なアプリケーション、ツールにRabbitMQ のデータを連携
3. ノーコードでの手軽な接続設定
4. 標準SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてRabbitMQ の接続を設定、2.Cognos BI 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとRabbitMQ への接続設定

まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

下記の手順に従って、［Cognos Administration］ツールのライブ RabbitMQ に接続を確立します。この接続はCognos BI 全体で使えます。このドライバーを使って、すべてのユーザーは一貫したデータおよびメタデータ：リアルタイムRabbitMQ を利用できます。

1. 接続プロパティの指定がまだの場合は、ODBC DSN （データソース名）で行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

   64ビット版のマシンからCognos を実行している場合は、32ビット版ODBC データソースアドミニストレーターを起動する必要があります。以下のコマンドで開くことができます：

   C:\Windows\sysWOW64\odbcad32.exe 

   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 - 仮想ホスト内の特定のキューのバインディング

   Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。

2. ［Cognos Administration］を開いて新しいデータソースを追加します。［Data Source Connections］をクリックして［ODBC］オプションを選択したら、システム DSN とユーザーフレンドリーな名前を入力します。［Retrieve Objects］をクリックして CData RabbitMQ データベースオブジェクトを選択します。

   

データビジュアライゼーションをレポートに追加

これで、［Source Explorer］からレポートオブジェクトにカラムをドラッグアンドドロップしてCognos Report Studio のRabbitMQ のデータ にレポートを作成できます。以下では、最新データを表示するチャートを持つシンプルなレポートを作成する方法を説明します。

レポートをビルドすると、Cognos Report Studio はSQL クエリを生成して実行をドライバーに依存します。ドライバーはクエリをRabbitMQ API へのリクエストに変換します。ドライバーはリアルタイムRabbitMQ へのクエリの実行を基になるAPI に依存します。

アグリゲートに基づきチャートを作成

［Source Explorer］からオブジェクトのdimentions にカラムをドラッグアンドドロップするだけで、Cognos レポートオブジェクトとしてRabbitMQ のデータを使うことができます。チャートのSeries dimension のカラムは自動的にグループ化されます。

さらにCognos は、measure dimesion のロジカルなデフォルトアグリゲート関数をデータタイプに基づいて設定します。この例では、デフォルトをオーバーライドしています。［Data Items］タブの カラムをクリックしてAggregate Function プロパティを Not Applicableに設定します。Rollup Aggregate Function プロパティは Automatic に設定する必要があります。

Query オブジェクトをSQL に変換

必要なクエリを把握している、あるいは生成されたクエリを調整したい場合は、query オブジェクトをSQL ステートメントに変換します。クエリがSQL に変換されると、UI コントロールはquery オブジェクトで利用できなくなります。下記の手順に従って、ユーザー定義のSQL でチャートを埋めます。

Cognos はユーザー定義クエリの実行をドライバーに依存します。ドライバーのSQL エンジンを使うと、キャッシュデータのコピーがないためクエリは常に最新の結果を返します。

1. ［Query Explorer］の上にカーソルを置き、［Queries］フォルダをクリックしてレポートにquery オブジェクトを表示します。

2. 自動生成されたクエリを編集したい場合は、Generated SQL プロパティにあるquery オブジェクトのボタンをクリックします。ダイアログが表示されたら、［Convert］をクリックします。

   新たにSQL ステートメントを入力したい場合は、query オブジェクトと一緒にSQL オブジェクトをドロップします。

3. SQL オブジェクトのプロパティを編集：SQL プロパティでRabbitMQ のデータソースを選択してSQL Syntax プロパティをNative に設定します。

4. SQL プロパティのボタンをクリックし、ダイアログが表示されたらSQL クエリを入力します。この例では以下のクエリを使います：

   SELECT ,  FROM AuthAttempts WHERE NodeName = 'rabbit@hostname'

5. query オブジェクトのプロパティを編集：Processing プロパティを［Limited Local］に設定します。この値はquery オブジェクトをSQL に変換するために必要です。

   

クエリ結果をチャートで使用

これで［Data Items］タブのオブジェクトとしてSQL クエリ結果にアクセスできるようになりました。下記の手順に従って、クエリ結果を使ってチャートを作成します；例えば、AuthAttempts テーブルから を各 へ。

1. ［Page Explorer］ 上にカーソルを置きpage オブジェクトをクリックしてページに戻ります。
2. 円グラフをツールボックスからワークスペース上にドラッグします。
3. チャートのプロパティで、Query プロパティに先ほど作成したクエリの名前を設定します。
4. ［Data Items］タブをクリックしてカラムをx およびy 軸上にドラッグします。この例では カラムをSeries (pie slices) ボックスに、 カラムをDefault Measure ボックスにドラッグします。

5. Default Measure ( 値) のデフォルトのプロパティを編集します：［Aggregate Function］ボックスで "Not Applicable" オプションを選択します。

レポートを実行してクエリ結果を追加します。