こんにちは!リードエンジニアの杉本です。
OutSystems は、企業がオムニチャネルのエンタープライズアプリケーションを開発、展開、管理するためのツールを提供するローコードプラットフォームです。CData Connect Cloud と組み合わせると、ビジネスアプリケーション用にAzure Data Lake Storage データにクラウド上でアクセスできます。この記事では、Connect Cloud にAzure Data Lake Storage の仮想データベースを作成し、OutSystems でAzure Data Lake Storage データから単純なアプリを構築する方法を説明します。
Connect Cloud アカウントの取得
以下のステップを実行するには、CData Connect Cloud のアカウントが必要になります。こちらから製品の詳しい情報とアカウント作成、30日間無償トライアルのご利用を開始できますので、ぜひご利用ください。
Connect Cloud からAzure Data Lake Storage に接続する
CData Connect Cloud は直感的なクリック操作ベースのインターフェースを使ってデータソースに接続します。
- Connect Cloud にログインし、 Add Connection をクリックします。
- Add Connection パネルから「Azure Data Lake Storage」を選択します。
-
必要な認証情報を入力し、Azure Data Lake Storage に接続します。
Azure DataLakeStorage 接続プロパティの取得・設定方法
Azure DataLakeStorage Gen 1 への接続
Gen 1 DataLakeStorage アカウントに接続するには、はじめに以下のプロパティを設定します。
- Schema:ADLSGen1 を指定。
- Account:アカウント名に設定。
- AzureTenant:テナントId に設定。Azure Portal 内のAzure Data Lake プロパティから取得できます。
- Directory:(オプション)複製したファイルを格納するためのパスを設定。指定しない場合は、ルートディレクトリが使用されます。
Azure DataLakeStorage Gen 1 への認証
Gen 1 は、認証方法としてAzure Active Directory OAuth(AzureAD)およびマネージドサービスID(AzureMSI)をサポートしています。認証方法は、ヘルプドキュメントの「Azure DataLakeStorage Gen 1
への認証」セクションを参照してください。
Azure DataLakeStorage Gen 2 への接続
Gen 2 DataLakeStorage アカウントに接続するには、はじめに以下のプロパティを設定します。
- Schema:ADLSGen2 に設定。
- Account:ストレージアカウント名に設定。
- FileSystem:このアカウントで使用するファイルシステム名に設定。例えば、Azure Blob コンテナ名など。
- Directory:(オプション)複製したファイルを格納するためのパスを設定。指定しない場合は、ルートディレクトリが使用されます。
Azure DataLakeStorage Gen 2 への認証
Gen 2は、認証方法としてアクセスキー、共有アクセス署名(SAS)、Azure Active Directory
OAuth(AzureAD)、マネージドサービスID(AzureMSI)など多様な方法をサポートしています。AzureAD、AzureMSI での認証方法は、ヘルプドキュメントの「Azure DataLakeStorage Gen 2
への認証」セクションを参照してください。
アクセスキーを使用した認証
アクセスキーを使用して接続するには、AccessKey プロパティを取得したアクセスキーの値に、AuthScheme を「AccessKey」に設定します。
Azure ポータルからADLS Gen2 ストレージアカウントのアクセスキーを取得できます。
- Azure ポータルのADLS Gen2 ストレージアカウントにアクセスします。
- 設定で「アクセスキー」を選択します。
- 利用可能なアクセスキーの1つの値を「AccessKey」接続プロパティにコピーします。
共有アクセス署名(SAS)
共有アクセス署名を使用して接続するには、SharedAccessSignature プロパティを接続先リソースの有効な署名に設定して、AuthScheme を「SAS」に設定します。
共有アクセス署名は、Azure Storage Explorer などのツールで生成できます。
- Create & Test をクリックします。
- Add Azure Data Lake Storage Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
パーソナルアクセストークンを追加する
OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン(Personal Access Token, PAT)を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
コネクションが構成されたら、OutSystems からAzure Data Lake Storage に接続できるようになります。
OutSystems からAzure Data Lake Storage に接続する
以下のステップでは、OutSystems からCData Connect Cloud に接続して新しいAzure Data Lake Storage データベース接続を作成する方法の概要を説明します。
- OutSystems Service Studio を開きます。
- 歯車アイコン をクリックし、Service Center のEnvironment Management を開きます。
- Administration をクリックして「Database Connections」を選択します。
- 「New Database Connection」をクリックします。
- データベース接続を設定します。
- Name:接続の名称(例:CData Connect Cloud Azure Data Lake Storage)
- DBMS:SQL Server またはAzure SQL
- Username:Connect Cloud ユーザー(例:user@mydomain.com)
- Password:Connect Cloud ユーザーのPAT
- Server:tds.cdata.com,14333
- Schema:Azure Data Lake Storage コネクションの名前(例: ADLS1)
- 「Test Connection」をクリックします。
- 「Create」をクリックします。
Azure Data Lake Storage テーブルまたはビューを拡張モジュールのエンティティにマップする
Azure Data Lake Storage のデータベース接続を作成したら、テーブルまたはビューをOutSystems のエンティティにマップする拡張機能を作成できます。作成していない場合は、Service Studio でアプリケーションを作成します。
- Service Studio を開き、既存のアプリケーションを開きます。
- 「Add Module」をクリックし、「Module Name」(例:adls_db_extension)を設定し、「Module Type」を「Extension」に設定して、「Create Module」をクリックします。
- Integration Studio で、環境に接続します。
- 拡張ツリーで「Entities」を右クリックし、「Connect to External Table or View...」を選択します。
- ウィザードのステップに従って、使用するテーブルおよびビューを選択します。
- Integration Studio で「1-Click Publish」をクリックします。
- 「1-Click Publish」ウィザードでプロセスが完了したら、「Configure」をクリックします。
- Service Center で、拡張機能の論理データベース名を、拡張機能が使用するデータベース接続に関連付け、「Apply」をクリックします。
- アプリケーションで「Manage Dependencies...」をクリックします。
- 拡張機能に依存関係を追加し、アプリケーションで使用するエンティティを選択します。
これで、標準のOutSystems エンティティと同じように、Azure Data Lake Storage データにアクセスして操作できます。
詳細と無償トライアル
Connect Cloud とOutSystems を使用すると、Azure Data Lake Storage に接続されたアプリケーションを簡単に構築できます。今すぐOutSystems のAzure Data Lake Storage データで作業を開始するには、Connect Cloud の無償トライアルにサインアップしてください。