FineReport にCosmos DB のデータを連携してビジュアライズ・レポートを作成

CData JDBC Driver for CosmosDB は、JDBC 標準に準拠しており、BI ツールからIDE まで幅広いアプリケーションでCosmos DB へのデータ連携を提供します。FineReport (www.finereport.com)は中国BIベンダー最大手の帆軟軟件（ファンランソフトウェア）が開発＆販売する帳票とBIダッシュボード開発プラットフォームです。 この記事では、帳票ツールのFineReport からCosmos DB] に連携する方法を説明します。

Cosmos DB データのJDBC データソースを作成

下記の手順に従って、FineReport からCosmos DB にデータベース接続として繋ぎます。

1. FineReport の「\FineReport_10.0\webapps\webroot\WEB-INF\lib」ディレクトリにCDATA JDBC Driver インストールディレクトリの［lib］サブフォルダ内のcdata.jdbc.cosmosdb.jar ファイルをコピーして配置します。製品版の場合には.lic ファイルも同様に配置します。
2. Fine Reportの帳票デザイナーを起動します。［サーバ］タブから［データ接続定義］をクリックし、［JDBC］を選択します。

開いたデータ接続定義ウィンドウで接続を確立します。

1. データベース：Other
2. JDBC ドライバ：cdata.jdbc.cosmosdb.CosmosDBDriver
3. URL: jdbc:cosmosdb: に続けてセミコロン区切りで接続プロパティを入力します。
   一般的なJDBC URL は次の通りです: jdbc:cosmosdb:AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;
4. ［接続プール属性］をクリックして、［接続の貸出前に接続有効性を検証］の属性項目を［なし］に変更します。

データ接続定義ウィンドウ上部の［接続テスト］をクリックします。これでCosmos DB データへの接続が確立され、FineReport 上で仮想RDB としてデータを連携利用することができるようになりました。

CosmosDBのデータを実際にデザイナで抽出（Select）してレポートで使ってみます。

1. 左下ペインの＋印をクリックし、［データベースクエリ］を選択します。データベースクエリウィンドウが開きます。
2. 左上のドロップダウンリストで先ほど作成したJDBC 接続を選択します。
3. 左ペインにCosmos DB のエンドポイントがそれぞれテーブルとして表示されます。
4. Cosmos DB データの表示されているテーブルから抽出するテーブル・カラムを指定してSelect 文を書きます。
5. プレビューをクリックするとデータがテーブル状で取得され、表示されます。
6. 作成したデータセットを利用してダッシュボードを作成していきます。

このようにCosmosDB 内のデータをAPI を書くことなくFineReport上で連携利用することができるようになります。