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

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

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 への認証

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

アクセスキー

Azure ポータルで：

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

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

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

共有アクセス署名（SAS）

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

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

• AuthScheme：SAS。
• SharedAccessSignature：先に生成した共有アクセス署名の値。

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

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

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

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

Windows:

MacOS:

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

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

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

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

最後にデータソース設定を行います。データソース定義名に先ほど設定したものを選択し、画面下部にある追加ボタンをクリックします。これで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 のデータを表示させることができます。

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

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