JReport Designer でAzure Data Lake Storage のデータを連携

JReport Designer でAzure Data Lake Storage に連携するチャートとレポートを作成します。

加藤龍彦
デジタルマーケティング

最終更新日:2022-10-10

この記事で実現できるAzure Data Lake Storage 連携のシナリオ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for ADLS を使用すると、Azure Data Lake Storage がリレーショナルデータベースであるかのようにダッシュボードやレポートからリアルタイムデータにアクセスでき、使い慣れたSQL クエリを使用してAzure Data Lake Storage] をクエリできます。ここでは、JDBC データソースとしてAzure Data Lake Storage に連携し、JReport Designer でAzure Data Lake Storage のレポートを作成する方法を説明します。

Azure Data Lake Storage のデータに接続

  1. C:\JReport\Designer\bin\setenv.bat を編集し、JAR ファイルの場所をADDCLASSPATH 変数に追加します。
    ...
    set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for ADLS 2016\lib\cdata.jdbc.adls.jar;
    ...
    
  2. [File][New][Data Source]と進み、新しいデータソースを作成します。
  3. 表示されるダイアログで、データソースの名前(CData JDBC Driver for ADLS) を作成し、JDBC を選択して[OK]をクリックします。
  4. [JDBC Connection Information]ダイアログで、JDBC ドライバーへの接続を構成します。
    • Driver:[Driver]ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。 cdata.jdbc.adls.ADLSDriver
    • URL:jdbc:adls: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。

      Azure Data Lake Storage 接続プロパティの取得・設定方法

      Azure Data Lake Storage Gen 2 への接続

      Gen 2 Data Lake Storage アカウントに接続するには、以下のプロパティを設定します。

      • Account:ストレージアカウントの名前。
      • FileSystem:このアカウントに使用されるファイルシステム名。例えば、Azure Blob コンテナの名前。
      • Directory(オプション):レプリケートされたファイルが保存される場所へのパス。パスが指定されない場合、ファイルはルートディレクトリに保存されます。

      Azure Data Lake Storage Gen 2 への認証

      本製品は、次の4つの認証方法をサポートします:アクセスキーの使用、共有アクセス署名の使用、Azure Active Directory OAuth(AzureAD)、Managed Service Identity(AzureMSI)。

      アクセスキー

      アクセスキーを使用して接続するには、はじめにADLS Gen2 ストレージアカウントで利用可能なアクセスキーを取得する必要があります。

      Azure ポータルで:

      1. ADLS Gen2 ストレージアカウントにアクセスします。
      2. 設定でアクセスキーを選択します。
      3. 利用可能なアクセスキーの1つの値をAccessKey 接続プロパティにコピーします。
      4. 接続の準備ができたら、次のプロパティを設定します。

        • AuthSchemeAccessKey
        • AccessKey:先にAzure ポータルで取得したアクセスキーの値。

      共有アクセス署名(SAS)

      共有アクセス署名を使用して接続するには、はじめにAzure Storage Explorer ツールを使用して署名を生成する必要があります。

      接続の準備ができたら、次のプロパティを設定します。

      • AuthSchemeSAS
      • SharedAccessSignature:先に生成した共有アクセス署名の値。

      AzureAD、AzureMSI での認証方法については、ヘルプドキュメントの「Azure Data Lake Storage Gen 2 への認証」セクションを参照してください。

      ビルトイン接続文字列デザイナー

      JDBC URL の構成については、Azure Data Lake Storage JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

      java -jar cdata.jdbc.adls.jar

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。

      Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

      JDBC URL を構成する際、Max Rows 接続プロパティを設定することもできます。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

      以下は一般的なJDBC URLです。

      jdbc:adls:Schema=ADLSGen2;Account=myAccount;FileSystem=myFileSystem;AccessKey=myAccessKey;InitiateOAuth=GETANDREFRESH
    • User:認証に使用するユーザー名は、通常空白のままにします。
    • Password:User と同様に認証に使用するパスワードも、通常は空白のままにします。
    Configuring the connection to the JDBC Driver (Salesforce is shown.)
  5. [Add Table]ダイアログで、レポート(またはこのデータソースを使用する予定のレポート)に含めるテーブルを選択し、[Add]をクリックします。

    Adding Tables.(Salesforce is shown.)

    ダイアログがテーブルのロードを完了したら、[Done]をクリックします。

  6. [Catalog Browser]では、レポートの作成に使用するクエリを作成できます。今すぐ、またはレポートの作成後に作成できますが、どちらにしても、 データソース(CData JDBC Driver for Azure Data Lake Storage) を展開()し、[Queries]を右クリックして[Add Query]を選択します。 Adding a query for data to be used in the report.(Salesforce is shown.)
  7. [Add Table/View/Query]ダイアログで、JDBC URL とTables を展開() し、クエリで使用するテーブルを選択して[OK]をクリックします。 Selecting a table for the query.(Salesforce is shown.)
  8. [Query Editor]ダイアログで、含めるカラムを選択するか、[SQL]ボタンをクリックして以下のようにカスタムクエリを手動で入力できます。
    SELECT FullPath, Permission FROM Resources WHERE Type = 'FILE'
    
    Editing the query.(Salesforce is shown.)

    クエリが作成されたら、[OK]をクリックして[Query Editor]ダイアログを閉じます。この時点で、Azure Data Lake Storage を新規または既存のレポートに追加する準備が整いました。

    NOTE: クエリが作成されると、クエリに基づいて[Business View]を作成できます。[Business View]を使用すると、クエリに基づいてWeb レポートまたはライブラリコンポーネントを作成できます。これについてのより詳しい情報は、JReport のチュートリアルを参照してください。

レポートにAzure Data Lake Storage のデータを追加

Azure Data Lake Storage を使用してレポートを作成することができるようになりました。

  1. 新しいレポートを作成([File][New][Page Report]) するか、既存のレポートの[Chart Wizard]を開きます。
  2. クエリを選択(または上記を参照して新しいクエリを作成) します。
  3. Selecting the query to use.(Salesforce is shown.)
  4. クエリのカラムからグラフの[Category]と[Value]を割り当て、[Finish]をクリックします。
  5. Assigning columns to define the chart.(Salesforce is shown.)
  6. レポートの[View]タブをクリックし、チャートを表示します。
Sample chart based on live data.(Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。