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

Jerod Johnson
Senior Technology Evangelist

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

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

ドライバー JAR のデプロイ

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

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

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

CockroachDB に接続するには以下を設定します。
- Server：サーバーのホスト名またはIP アドレス。
- Port：CockroachDB サーバーのポート番号。デフォルトのポートは26257 です。
- Database：Cockroach データベースの名前。デフォルトでは、CData 製品はユーザーのデフォルトデータベースに接続します。
- User：認証に使用されるCockroach DB ユーザーアカウント。
- Password：ユーザーの認証で使用されるパスワード。
組み込みの接続文字列デザイナー

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

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

CockroachDB JDBC データソースの作成

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

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

ドメインの作成

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

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

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

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

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