Azure Data Lake Storage のデータを帳票ツールbiz-Stream で連携利用する方法

CData JDBC ドライバを使って、帳票ツールのbiz-Stream で Azure Data Lake Storage をノーコードで連携。

宮本航太
プロダクトスペシャリスト

最終更新日:2022-05-18

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

こんにちは!プロダクトスペシャリストの宮本です。

biz-Stream は、多様な表現が可能なWeb 帳票ソリューションです。

この記事では、biz-Stream からCData JDBC ドライバ経由でAzure Data Lake Storage のデータにリアルタイムで連携接続して帳票から利用する方法を紹介します。CData Drivers を使うことで、RDB のようにbiz-Stream 内でAzure Data Lake Storage のデータを扱うことができるようになります。

biz-Stream へのAzure Data Lake Storage JDBC ドライバーの配置

デフォルトの内容でインストールした場合、以下のパスに jar ファイルが配置されますので、その jar ファイルを biz-Stream の所定のパスにコピーします。

  • cdata.jdbc.adls.jar
  • cdata.jdbc.adls.lic (試用版では.lic ファイルは不要)
  • コピー元:C:\Program Files\CData\CData JDBC Driver for ADLS 20xxJ\lib
  • コピー先:C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc

biz-Stream からAzure Data Lake Storage への接続設定

レイアウトデザイナを起動後、リソース定義にて Azure Data Lake Storage への接続設定を行います。ドライバー選択のプルダウンに CData ADLS JDBC Driver が表示されますので選択します。

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 への認証」セクションを参照してください。

サーバURLは以下の形式で入力します。
URL: jdbc:adls:Schema=ADLSGen2;Account=myAccount;FileSystem=myFileSystem;AccessKey=myAccessKey;InitiateOAuth=GETANDREFRESH

Azure Data Lake Storage のデータ リソースの作成

JDBC Driver の接続文字列デザイナーを使う

JDBC 接続文字列を作るには、Azure Data Lake Storage JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。

Windows:

java -jar 'C:\Program Files\CData\CData JDBC Driver for ADLS 20xxJ\lib\cdata.jdbc.adls.jar'

MacOS:

java -jar cdata.jdbc.adls.jar

接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。

接続文字列デザイナーを使って、JDBC URL を生成する (Salesforce is shown.)

次にデータ取得条件を設定します。SQL 定義から定義名を設定し、編集ボタンをクリックします。

Azure Data Lake Storage のデータ リソースの編集

上のグレーエリアで右クリック → テーブルリストと選択しますと、Azure Data Lake Storage のオブジェクトがリストで表示されます。使用するテーブルを選択します。

Azure Data Lake Storage のデータ リソースの選択

ここでは取得対象の項目や条件などを設定することができます。対象項目や条件を指定できたらOKボタンをクリックし、戻った画面で追加ボタンをクリックします。

Azure Data Lake Storage のデータ のカラム選択と条件設定

最後にデータソース設定を行います。データソース定義名に先ほど設定したものを選択し、画面下部にある追加ボタンをクリックします。これでbiz-Stream でAzure Data Lake Storage のデータを利用する準備ができました。

データソース設定

Azure Data Lake Storage のデータをリアルタイムで参照するbiz-Stream 帳票のデザイン

用紙設定を行います。今回は A4 設定にしました。設定後は画面下部にある追加ボタンをクリックします。

ページ設定では新規ボタンをクリックします。

ここではレイアウトデザイナが帳票テンプレートを xml で保存しますので、ファイル名を設定します。

レイアウトにはさまざまなメニューがありますが、今回は表を使用します。表を設定後、Azure Data Lake Storage から取得したデータをセットするエリアを作成します。各セルにテキストボックスを挿入し、そのテキストボックス自体に Azure Data Lake Storage の項目を紐づけします。
※ヘッダーにもそれぞれテキストボックスを追加します。

表オブジェクトとしてAzure Data Lake Storage を使用

レイアウト作成画面を閉じた後、ページ設定の画面に戻りますので、画面下部にある追加ボタン(一度作成している場合は適用)をクリックし、レイアウトの作成が完了となります。

レイアウトデザイナーのトップ画面のヘッダーメニューからプレビューアイコンをクリックします。先ほど作成したレイアウトで Azure Data Lake Storage のデータを表示させることができます。

このようにCData JDBC ドライバをアップロードすることで、簡単にbiz-Stream でAzure Data Lake Storage のデータをリアルタイムに参照する帳票をノーコードで連携して作成することができます。

ぜひ、CData JDBC Driver for ADLS 30日の無償評価版 をダウンロードして、お試しください。

関連コンテンツ

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

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