JReport Designer で Google Cloud Storage ののデータを連携利用

Jerod Johnson
Senior Technology Evangelist

JReport Designer で Google Cloud Storage のデータをもとにチャートとレポートを作成。

CData JDBC Driver for Google Cloud Storage のデータを使えば、ダッシュボードやレポートから Google Cloud Storage をリレーショナルデータベースのように扱い、使い慣れた SQL クエリで Google Cloud Storage のデータのライブデータにアクセスできます。この記事では、JReport Designer で Google Cloud Storage のデータに JDBC データソースとして接続し、Google Cloud Storage のデータのデータをもとにレポートを作成する方法を説明します。

Google Cloud Storage ののデータに接続

C:\JReport\Designer\bin\setenv.bat を編集して、JAR ファイルの場所を ADDCLASSPATH 変数に追加します。

...
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for Google Cloud Storage 2016\lib\cdata.jdbc.googlecloudstorage.jar;
...

File メニューから New、Data Source と進み、新しいデータソースを作成します。
表示されるダイアログでデータソース名を入力し（例：CData JDBC Driver for Google Cloud Storage）、JDBC を選択して OK をクリックします。
Get JDBC Connection Information ダイアログで、JDBC ドライバーへの接続を設定します。
- Driver: Driver ボックスにチェックが入っていることを確認し、ドライバーのクラス名を入力します。
```
cdata.jdbc.googlecloudstorage.GoogleCloudStorageDriver
```
- URL: JDBC URL を入力します。URL は jdbc:googlecloudstorage: から始まり、その後に接続プロパティをセミコロン区切りで記述します。
  ユーザーアカウントでの認証
  
  ユーザー資格情報の接続プロパティを設定することなく接続できます。InitiateOAuth をGETANDREFRESH に設定したら、接続の準備が完了です。
  
  接続すると、Google Cloud Storage OAuth エンドポイントがデフォルトブラウザで開きます。ログインして権限を付与すると、OAuth プロセスが完了します。
  
  サービスアカウントでの認証
  
  サービスアカウントには、ブラウザでユーザー認証を行わないサイレント認証があります。サービスアカウントを使用して、企業全体のアクセススコープを委任することもできます。
  このフローでは、OAuth アプリケーションを作成する必要があります。詳しくは、ヘルプドキュメントを参照してください。以下の接続プロパティを設定したら、接続の準備が完了です：
  - InitiateOAuth: GETANDREFRESH に設定。
  - OAuthJWTCertType: PFXFILE に設定。
  - OAuthJWTCert: 生成した.p12 ファイルへのパスに設定。
  - OAuthJWTCertPassword: .p12 ファイルのパスワードに設定。
  - OAuthJWTCertSubject: 証明書ストアの最初の証明書が選ばれるように"*" に設定。
  - OAuthJWTIssuer: 「サービスアカウント」セクションで「サービスアカウントの管理」をクリックし、このフィールドをサービスアカウントID フィールドに表示されているE メールアドレスに設定。
  - OAuthJWTSubject: サブジェクトタイプが"enterprise" に設定されている場合はエンタープライズID に設定し、"user" に設定されている場合はアプリユーザーID に設定。
  - ProjectId: 接続するプロジェクトのID に設定。
  これで、サービスアカウントのOAuth フローが完了します。
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、Google Cloud Storage JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.googlecloudstorage.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  JDBC URL を設定する際には、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションのデザイン時のパフォーマンス向上に役立ちます。
  
  一般的な JDBC URL は次のとおりです。
```
jdbc:googlecloudstorage:ProjectId='project1';
```
- User: 認証に使用するユーザー名です。通常は空白のままにします。
- Password: 認証に使用するパスワードです。通常は空白のままにします。
Add Table ダイアログで、レポートに含めるテーブル（または、このデータソースを使用する今後のレポート用のテーブル）を選択し、Add をクリックします。

テーブルの読み込みが完了したら Done をクリックします。
Catalog Browser で、レポートを作成するためのクエリを作成できます。これはレポート作成前でも作成後でも行えます。データソース（CData JDBC Driver for Google Cloud Storage）を展開（）し、Queries を右クリックして Add Query を選択します。
Add Table/View/Query ダイアログで、JDBC URL と Tables を展開（）し、クエリで使用するテーブルを選択して OK をクリックします。
Query Editor ダイアログで、含めるカラムを選択するか、SQL ボタンをクリックして独自のクエリを手動で入力します。例えば次のようになります。
```
SELECT Name, OwnerId FROM Buckets WHERE Name = 'TestBucket'
```
クエリが構築できたら、OK をクリックして Query Editor ダイアログを閉じます。これで Google Cloud Storage のデータを新規または既存のレポートに追加する準備が整いました。

NOTE: クエリが構築できたら、そのクエリをもとに Business View を作成できます。Business View を使用すると、クエリに基づいた Web レポートやライブラリコンポーネントを作成できます。詳しくは、JReport のチュートリアルを参照してください。