JasperReports Server で CouchDB のレポートを作成

Jerod Johnson
Senior Technology Evangelist

CData JDBC Driver をJasperReports Server にデプロイして、レポートや組み込み分析などから CouchDB データにリアルタイムでアクセスできます。

CData JDBC Driver for CouchDB を使用すると、企業全体で CouchDB のデータへのアクセスを提供できます。この記事では、JasperReports Server にドライバーをデプロイし、CouchDB のデータのビジネスビューであるレポートドメインに基づいたシンプルなレポートを作成する方法を説明します。

ドライバー JAR のデプロイ

以下の手順に従って、JasperReports Server にドライバー JAR をデプロイします。この手順は CouchDB と JasperReports Server にバンドルされている Tomcat サーバーに固有のものです。Tomcat ではなく JBoss AS 7 を使用している場合は、標準的なプロセスに従って JBoss への CouchDB JDBC Driver のデプロイを行ってください。

インストールディレクトリの lib サブフォルダにあるドライバー JAR と .lic ファイルを、JasperReports Server インストールディレクトリ内の apache-tomcat フォルダの lib サブフォルダにコピーします。
apache-tomcat -> webapps -> jasperserver-pro -> META-INF に移動し、以下のリソースエントリを context.xml ファイルに追加します。
```
<Resource name="jdbc/apachecouchdb"   auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.apachecouchdb.ApacheCouchDBDriver"  url="jdbc:apachecouchdb:Url=http://localhost:5984;User=abc123;Password=abcdef;" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSCommonsBasicDataSourceFactory"/>
```
JDBC URL（url 属性）に必要な接続プロパティを指定します。

Apache CouchDB 接続プロパティの取得・設定方法

それでは、Apache CouchDB に接続していきましょう。Url 接続プロパティをApache CouchDB インスタンスのURL に設定します。例：http://localhost:5984

ユーザー（またはJWT）が特定のデータベースだけにアクセスできるようにしたい場合は、Apache CouchDB インスタンスで"admin_only_all_dbs" オプションを設定し、テーブルをリストするためにCData 製品が必要とする"/_all_dbs" エンドポイントへのアクセス権をすべてのユーザーに付与する必要があります。

Apache CouchDB への認証

続いて、認証方法を設定しましょう。CData 製品では、3種類の認証をサポートしています。
- Basic：基本的なユーザー名 / パスワード認証
- JWT：JWT 認証
- None：パブリックなデータベースへの匿名アクセス
Basic 認証

データに接続するには、以下のプロパティを設定してください。
- AuthScheme：Basic
- User：認証に使用されるApache CouchDB ユーザーアカウント
- Password：認証するユーザーに関連付けられたApache CouchDB パスワード
その他の認証方法については、ヘルプドキュメントの「接続の確立」セクションをご確認ください。

組み込みの接続文字列デザイナー

JDBC URL の構築には、CouchDB JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.apachecouchdb.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

JDBC URL を設定する際に、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションを設計する際のパフォーマンス向上に役立ちます。
jasperserver-pro -> WEB-INF に移動し、以下の参照を web.xml ファイルに追加します。
```
  CouchDB のデータ JSP
  jdbc/apachecouchdb
  javax.sql.DataSource
  Container
```
サーバーを再起動します。

CouchDB JDBC データソースの作成

以下の手順に従って、CouchDB JDBC Driver を JDBC データソースにマッピングします。

JasperReports Server にログインし、Create -> Data Source をクリックします。
Type メニューで、JNDI Data Source を選択します。
Service Name ボックスに、web.xml ファイルのリソース定義で指定した JNDI ルックアップを入力します。この例では、ルックアップは「jdbc/apachecouchdb」です。
Save をクリックしてデータソースを作成します。

ドメインの作成

ドメインは、レポート作成者に関連するビジネスビューを提供するメタデータおよびアクセス制御レイヤーです。以下の手順に従って、CouchDB のカラムを選択し、フィルタを適用し、SQL を実行してドメインを作成します。

Create -> Domain をクリックします。ドメインの ID を入力し、保存場所を選択します。
Data Source セクションで Browse をクリックし、作成した CouchDB データソースを選択します。
Domain Design セクションで、Create with Domain Designer をクリックします。
テーブルが含まれるスキーマを選択します。
Tables タブで、Data Source ペインからテーブルを選択し、矢印をクリックして Selected Tables ペインに追加します。
Derived Tables タブでは、SQL クエリに基づいてドメインを定義できます。例えば、
```
  SELECT MovieRuntime, MovieRating FROM Movies WHERE MovieRating = 'R'
  
```
Joins タブでは、結合条件を構築するカラムを選択し、結合タイプを選択することでテーブルを結合できます。
Pre-Filters タブでは、カラムをドラッグ＆ドロップして、ドメインを通じて公開されるデータをフィルタする検索条件を定義します。
Display タブで、ユーザーに提示されるデータセットに CouchDB データを選択します。
OK をクリックして変更を確定し、Submit をクリックしてドメインを作成します。

リアルタイムでデータを探索

ドメインを作成したら、データに接続する準備が整います。以下の手順に従って、Ad Hoc Editor で Ad Hoc ビューを作成します。

Create -> Ad Hoc View をクリックします。
表示されるダイアログで、作成した CouchDB ドメインを選択します。
Choose Data ページで、ビューで使用するカラムを選択します。Pre-Filters セクションでは、選択したフィールドに基づいてフィルタを作成できます。Display セクションでは、ドメインで表示されるカラム情報を変更できます。
ウィザードが完了したら、ビュータイプを選択し、ビューにカラムを追加します。JasperSoft はドライバーのメタデータを使用して、データ型に基づいて利用可能なディメンションとメジャーを検出します。ディメンションとメジャーを Columns ボックスと Rows ボックスにドラッグします。メジャーを右クリックして集計計算を変更できます。Filters セクションで Columns スライダーを目的のデータレベルにドラッグします。
ビューの設計中にデータの更新にアクセスするには、設計モードのツールバーでメニュー選択を Sample Data から Full Data に変更します。変更を行うと、JasperSoft Server はドライバーに対して基になる SQL クエリを実行します。
ビューを保存します。