Microsoft Azure Data Lake Store
接続タイプ | Alteryxツール。最新のバージョンは、 Alteryx Marketplace から入手できます。 |
ドライバーの詳細 | 選択したログイン方法によっては、Alteryx Azure Data Lakeツールを使用して接続を確立する前に、管理者がAzure Data LakeとAzure Active Directoryへのアクセスを設定することが必要な場合があります。 |
サポートのタイプ | 読み取り、書き込み |
バージョン | 説明 |
v2.5.0 |
|
v2.4.3 |
|
v2.2.0 |
|
v2.1.0 |
|
v2.0 |
|
v1.1.0 |
|
v1.0.2 |
|
v1.0.1 |
|
v1.0.0 |
|
接続に使用する Alteryx ツール
データ接続マネージャー
Azure Data Lake Storeツールのバージョン2.3.0以降は データ接続マネージャー をサポートしているため、資格情報を簡単かつ安全に保存できます。Azure Data Lake Storeへの接続を作成し、Azure Data Lake Storeツールを含むワークフローで保存された資格情報を簡単に再利用できます。Alteryx Serverで公開されたワークフローを正常に実行するには、保存された資格情報が必要です。
AMP Engineを有効にする
Azure Data Lake Storeツールのバージョン2.3.0以降を含むワークフローに対して AMP Engine が有効になっていることを確認します。
認証と権限
Gen1ストレージとGen2ストレージのAzure Data Lakeエンドポイントは異なり、認証中に、接続するストレージの種類を指定する必要があります。使用しているストレージの種類がわからない場合は、Azure管理者に問い合わせるか、 Microsoft Azureポータル で確認してください。
ヒント
ワークフローをサーバーまたはAAHに公開するには、サービス間認証タイプまたは共有キー認証タイプを使用します。こうすれば、リフレッシュトークンの有効期限が切れた後にワークフローを再アップロードする必要はありません。
メタデータのロードには時間がかかる場合があるため、詳細ユーザー設定([オプション] > [ユーザー設定] > [ユーザー設定の編集] > [詳細])で [自動設定を無効にする] を選択して、メタデータのロードを無効にすることができます。
Azure Data Lake Storeアカウント内のデータの読み取りと書き込みを行うための権限が付与されている必要があります。これらの権限がどのように割り当てられ、適用されるかについての詳細は、Microsoftの公式ドキュメントを参照してください。
シングルテナントとマルチテナント
シングルテナントアプリケーションは、登録したテナント (ホームテナントとも呼ばれます) でのみ使用できます。お客様または Azure 管理者は、Designer での認証時に使用するアカウントで、シングルテナント Azure アプリケーションとストレージを作成できます。マルチテナントアプリケーションは、ホームテナントと他のテナントの両方のユーザーが使用できます。
エンドユーザー (基本)
基本的なエンドユーザー認証は、DesignerでADLSデータにアクセスするための最も便利な方法です。Azure管理者に連絡して、組織のAzureテナントでパブリックAlteryxアプリケーションを許可してください。手順については、 Microsoftのドキュメント を参照してください。
テナント:
共通
Gen2 AlteryxアプリケーションのADLSクライアントID:
2584cace-63ff-47cb-96d2-d153704f4d75
このセットアップ後、通常のMicrosoft資格情報を使用してADLSデータにアクセスできるようになります。
エンドユーザー (上級)
高度なエンドユーザー認証は、シングルテナント認証とマルチテナント認証をサポートしており、パブリックアプリケーションとプライベートアプリケーションの両方で使用できます。
資格情報のセットアップについては Microsoftのドキュメント の説明を参照してください。
認証の設定
テナントID: AzureポータルからテナントIDを取得することも、[テナントID] フィールドに「common」と入力してAzureの自動検出メカニズムを利用することもできます。複数のテナントにアクセスする場合は、テナントIDを指定できます。マルチテナントの詳細については、「シングルテナントとマルチテナント」セクションを参照してください。
クライアントID: Azureアプリケーションの固有識別子。クライアントIDフィールドは必須です。
クライアントシークレット: アプリケーションがプライベートである場合は、クライアントシークレットの指定は必須です。パブリックアプリケーションを使用している場合は、フィールドを空白のままにしてください。
サービス間
サービス間認証は、サーバーとハブでのワークフローの公開に適しています。
資格情報のセットアップについては Microsoftのドキュメント の説明を参照してください。
共有キー
注記
共有キー認証は、Gen2ストレージでのみ使用できます。
この認証方法は2020.4リリースから導入されたため、サーバーへの公開は、DesignerおよびServerのバージョン2020.4以降でのみ使用できます。
Azure ストレージアカウントを使用すると、マイクロソフトは 2 つのアクセスキーを生成します。これらのアクセスキーを使用して、共有キーの承認を介した Azure Data Lake へのアクセスを承認できます。共有キーとその使用方法の詳細については、 Microsoftのドキュメント を参照してください。
Azureナショナルクラウドとカスタムエンドポイント
v2.0リリース以降、ADLSコネクタはカスタムエンドポイントへのアクセスをサポートします。米国と中国のナショナルクラウドのURLは、[認証局オーソリティエンドポイント] フィールドのコネクタの認証画面で選択できます。
カスタムMicrosoft Azure APIアプリケーションのセットアップ
このツールのカスタムAPIアプリケーションを設定するには、ガイドを参照してください。
データの選択と設定オプション
[データ] タブでは、使用するデータを指定できます。
[ ストレージアカウント名 ] を指定します。このストレージは、[認証] ページで選択したものと同じタイプ(Gen1、Gen2)である必要があります。
Gen2 ストレージの場合は、 ファイルシステム名 を指定します。
Gen2のストレージとファイルシステムを選択したら、読み取りまたは書き込みを行うファイルのパスを設定できます。[ファイルパス] フィールドに直接入力するか、ファイルブラウザを使用することで、パスを指定できます。Azure Data Lakeファイル出力ツールでは、同じ仕組みを使用して新しいファイルを作成できます。
Excelファイルの場合、ファイルブラウザ下にある [シート] フィールドでシート名を指定できます。空のままにすると、自動的に最初のシートが選択されます。新規ファイルの場合、シート名は既定の「Sheet」になります。
ファイル形式と設定
ADLSツールは、.csv、.avro、.json、.xlsxのデータ形式をサポートします。
CSVファイル
読み込み
書き込み: 既存のCSVファイルに上書きまたは追加できます。
ヒント
データ入力ツールやデータ出力ツールとの互換性のために、エンコードは UTF-8 SIG にする必要があります。
JSONファイル
読み込み: JSONファイルを正しく読み込むには、 BOMなしのUTF-8エンコード を使用する必要があります。
書き込み: JSONファイルに書き込む場合のデータ型変換には、制限があります。10進数、日時、時刻のセルは 文字列 として出力されます。
Avroファイル
読み込み
書き込み
Excelファイル
読み取り : すべてのデータはV_Wstringとして読み取られます。
書き込み
追加の詳細
別のアカウントで作成したフォルダーにアクセス(読み取り/書き込み)できない場合は、権限の問題があります。
トークンが取り消された可能性があることを示すエラーが発生した場合は、ログアウトしてから設定パネルに再度ログインし、再認証を行う必要があります。
注記
トークンの有効期間プロパティは、システム管理者が設定できます。
Azure Data Lake Explorerは、Azure Data Lake Storeアカウント内のデータの読み取りと書き込みの権限を付与する必要があります。これらの権限がどのように割り当てられ、適用されるかについての詳細は、Microsoftの公式ドキュメントを参照してください。
制限事項
Azure Data Lake Storeツールのバージョン2.5.0以降、Gen1認証はサポートされません。
JSONとAvroは、UTF-8のみです。
JSONでは、データ型に対して大きすぎる数値を保存しようとすると、サイレント変換エラーが発生します。
現在、Excelファイルへの書き込みは、ファイル全体の上書きのみに制限されています。
バイト型のフィールドを持つAvroファイルはサポートされていないため、インポート時に失敗します。
Alteryxワークフローの浮動小数点数フィールド値は、出力先のAvroファイルでは倍精度浮動小数点数値型に変換されます。
Microsoft Azure Data Lake、OneDrive、Dynamics CRMコネクタは、EメールやパスワードなどのMicrosoftユーザー資格情報による認証をサポートしています。対話型ワークフローでは、現時点では、これらのコネクタ間で異なるMicrosoftユーザーアカウントを使用して認証することはできません。この制限は、スケジュールされたワークフローには影響しません。これらのいずれかのコネクタに対してMicrosoftユーザーアカウントで認証されており、別のコネクタに対して別のMicrosoftユーザーアカウントで認証しようとすると、エラーメッセージが表示されます。この問題を解決するには、次のいずれかの推奨事項に従ってください。
Azure Active Directory管理者は、1つのユーザーアカウントに必要な権限を付与します。これで、ワークフローを構築するユーザーが、そのワークフロー内の必要なサービスにアクセスできる1つのユーザーアカウントを持つことができます。
ログインする前に、別のMicrosoftユーザーアカウントで認証されているコネクタからログアウトしてください。
エンドユーザー認証は、できるだけ使用しないでください。Azure Data Lakeのコネクタでサービス間認証を使用し、Dynamics CRMのコネクタでアプリケーションログイン認証を使用してください。
Desktop Automation (Scheduler)は、このコネクタではサポートされていません。