NetBeans で Azure Data Lake Storage のデータ に接続
CData JDBC Driver for Azure Data Lake Storage は、JDBC をサポートする IDE にリアルタイム Azure Data Lake Storage のデータ 接続を統合します。JDBC 標準により、ビルトインのデータアクセスウィザードや迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans で Azure Data Lake Storage のデータ に接続する方法を説明します。接続を作成し、テーブルエディターで ロードを行います。
NetBeans で Azure Data Lake Storage 用の JDBC データソースを作成
JDBC データソースを作成するには、サービスウィンドウで Database ノードを展開し、Drivers ノードを右クリックして New Driver を選択します。表示される New Driver ウィザードで、以下の情報を入力します:
- Driver File(s):Add をクリックし、表示されるファイルエクスプローラーダイアログで cdata.jdbc.adls.jar ファイルを選択します。ドライバー JAR はインストールディレクトリの lib サブフォルダにあります。
- Driver Class:Find をクリックして JAR 内のドライバークラスを検索します。次に、メニューから cdata.jdbc.adls.ADLSDriver を選択します。
- Name:ドライバーの名前を入力します。
接続パラメータの定義
以下の手順で、必要な接続プロパティを定義します:
サービスウィンドウで Database ノードを右クリックし、New Connection をクリックします。
New Connection Wizard で、以下の接続プロパティを入力します:
- Driver Name:メニューから CData JDBC Driver for Azure Data Lake Storage を選択します。
- User Name:ユーザー名を入力します。これは JDBC URL でも定義できます。
- Password:パスワードを入力します。これは JDBC URL でも定義できます。
JDBC URL:JDBC URL を指定します。
Azure Data Lake Storage 接続プロパティの取得・設定方法
Azure Data Lake Storage Gen2 への接続
それでは、Gen2 Data Lake Storage アカウントに接続していきましょう。接続するには、以下のプロパティを設定します。
- Account:ストレージアカウントの名前
- FileSystem:このアカウントに使用されるファイルシステム名。例えば、Azure Blob コンテナの名前
- Directory(オプション):レプリケートされたファイルが保存される場所へのパス。パスが指定されない場合、ファイルはルートディレクトリに保存されます
Azure Data Lake Storage Gen2への認証
続いて、認証方法を設定しましょう。CData 製品では、5つの認証方法をサポートしています:アクセスキー(AccessKey)の使用、共有アクセス署名(SAS)の使用、Azure Active Directory OAuth(AzureAD)経由、Azure サービスプリンシパル(AzureServicePrincipal またはAzureServicePrincipalCert)経由、およびManaged Service Identity(AzureMSI)経由です。
アクセスキー
アクセスキーを使用して接続するには、まずADLS Gen2ストレージアカウントで利用可能なアクセスキーを取得する必要があります。
Azure ポータルでの手順は以下のとおりです:
- ADLS Gen2ストレージアカウントにアクセスします
- 設定でアクセスキーを選択します
- 利用可能なアクセスキーの1つの値をAccessKey 接続プロパティにコピーします
接続の準備ができたら、以下のプロパティを設定してください。
- AuthScheme:AccessKey
- AccessKey:先ほどAzure ポータルで取得したアクセスキーの値
共有アクセス署名(SAS)
共有アクセス署名を使用して接続するには、まずAzure Storage Explorer ツールを使用して署名を生成する必要があります。
接続の準備ができたら、以下のプロパティを設定してください。
- AuthScheme:SAS
- SharedAccessSignature:先ほど生成した共有アクセス署名の値
その他の認証方法については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「Azure Data Lake Storage Gen2への認証」セクションをご確認ください。
ビルトイン接続文字列デザイナー
JDBC URL の作成には、Azure Data Lake Storage JDBC Driver にビルトインされている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.adls.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は次のとおりです:
jdbc:adls:Schema=ADLSGen2;Account=myAccount;FileSystem=myFileSystem;AccessKey=myAccessKey;
Azure Data Lake Storage のデータ のクエリ
Azure Data Lake Storage のデータ に接続するには、Database ノードで接続を右クリックし、Connect をクリックします。接続が確立されたら、展開してスキーマ情報を確認できます。
Data Views ウィンドウにテーブルをロードするには、テーブルを右クリックして View Data をクリックします。。