MongoDB JDBC Driver を使用した OBIEE でのレポート作成

Jerod Johnson
Senior Technology Evangelist

MongoDB JDBC Driver を OBIEE にデプロイして、エンタープライズ全体でリアルタイムレポートを実現します。

CData JDBC Driver for MongoDB は、標準的なデータベースドライバーとして、Java ベースのレポーティングサーバーにMongoDB のデータへのリアルタイムアクセスを統合できます。この記事では、Oracle Business Intelligence Enterprise Edition（OBIEE）にドライバーをデプロイし、変更がリアルタイムに反映されるMongoDB のデータのレポートを作成する方法を説明します。

MongoDB データ連携について

CData を使用すれば、MongoDB のライブデータへのアクセスと統合がこれまでになく簡単になります。お客様は CData の接続機能を以下の目的で利用しています：

MongoDB 2.6 以降のデータにアクセスでき、さまざまな MongoDB バージョンで幅広く使用できます。
柔軟な NoSQL により、非構造化データを簡単に管理できます（詳細はこちら：NoSQL 統合のための最先端ドライバー）。
他の NoSQL ドライバーに対する機能的な優位性を活用し、MongoDB データを扱う際の機能的なメリットを実現できます（詳細はこちら：NoSQL 向けドライバーの機能比較）。

MongoDB の柔軟性により、トランザクション、オペレーション、または分析データベースとして使用できます。つまり、CData のお客様は、ビジネスデータを MongoDB に統合したり、MongoDB データをデータウェアハウスに統合したり（またはその両方）するために当社のソリューションを使用しています。また、Power BI や Tableau などのお気に入りのツールから MongoDB を直接分析・レポートするために、当社のライブ接続オプションを活用しているお客様もいます。

MongoDB のユースケースと CData が MongoDB 体験をどのように向上させるかについての詳細は、ブログ記事をご覧ください：The Top 10 Real-World MongoDB Use Cases You Should Know in 2024

はじめに

JDBC Driver のデプロイ

以下の手順で、JDBC Driver を WebLogic のクラスパスに追加します。

WebLogic 12.2.1 の場合、ドライバーの JAR ファイルと .lic ファイルを DOMAIN_HOME\lib に配置するだけで完了です（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）。これらのファイルは起動時にサーバーのクラスパスに追加されます。

手動でクラスパスにドライバーを追加することもできます（以前のバージョンでは必須）。setDomainEnv.cmd（Windows）または setDomainEnv.sh（Unix）の PRE_CLASSPATH の先頭に以下を追加します。このスクリプトは、そのドメインのフォルダ内の bin サブフォルダにあります（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\bin）。

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.mongodb.jar;%PRE_CLASSPATH%

すべてのサーバーを再起動します（例：DOMAIN_HOME\bitools\bin の stop コマンドと start コマンドを実行）。

MongoDB 用 JDBC データソースの作成

JDBC Driver をデプロイしたら、BI Publisher から JDBC データソースを作成できます。

BI Publisher にログインします（URL は例えば http://localhost:9502/analytics）。Administration -> Manage BI Publisher をクリックします。
JDBC Connection -> Add Data Source をクリックします。
以下の情報を入力します：
- Data Source Name：ユーザーがレポートで接続を作成する際に使用する名前を入力します。
- Driver Type：Other を選択します。
- Database DriverClass：ドライバークラス cdata.jdbc.mongodb.MongoDBDriver を入力します。
- Connection String：JDBC URL を入力します。
  MongoDB への接続には、Server、Database、User、Password プロパティを設定します。MongoDB コレクションにテーブルとしてアクセスするには、自動スキーマ検出を使用することができます。もちろんスキーマ定義の.rsd ファイルを編集して自分でスキーマ定義を書くことも可能です。スキーマに縛られないフリーフォーマットクエリを投げることもできます。
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、MongoDB JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.mongodb.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  JDBC URL を構成する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に特に役立ちます。
  
  一般的な JDBC URL は以下のとおりです：
```
jdbc:mongodb:Server=MyServer;Port=27017;Database=test;User=test;Password=Password;
```
- Username：ユーザー名を入力します。
- Password：パスワードを入力します。
Security セクションで、許可するユーザーロールを選択します。

リアルタイム MongoDB レポートの作成

これで、リアルタイムMongoDB のデータに基づいたレポートや分析を作成できます。以下の手順で、標準のレポートウィザードを使用して、MongoDB のデータの変更がリアルタイムに反映されるインタラクティブなレポートを作成します。

グローバルヘッダーで、New -> Data Model をクリックします。
Diagram タブで、メニューから SQL query を選択します。
クエリの名前を入力し、Data Source メニューで作成した MongoDB JDBC データソースを選択します。
standard SQL を選択し、以下のようなクエリを入力します：
```
SELECT borough, cuisine FROM restaurants
```
View Data をクリックして、レポート作成に使用するサンプルデータを生成します。
サンプルデータに含める行数を選択し、View をクリックしてから、Save As Sample Data をクリックします。
Create Report -> Use Data Model をクリックします。
Guide Me を選択し、Select Layout ページで含めるレポートオブジェクトを選択します。この例では Chart と Table を選択します。
cuisine のような数値カラムを Y 軸の Drop Value Here ボックスにドロップします。borough のようなディメンションカラムを X 軸の Drop Label Here ボックスにドロップします。
Refresh をクリックすると、MongoDB のデータの変更が反映されます。