はじめに
Azure Data Lake Storage Gen2は世界最高水準の生産性を持つデータレイクです。ビッグデータ解析ワークロード用の全社規模のハイパースケールリポジトリとなっています。Azure Storageが、Azure上にエンタープライズデータレイクを構築するための基礎になります。大量のデータを簡単に管理することによって、PoC（導入検証）から生産への移行を迅速に行うことができます。DomoのMicrosoft Azure Data Lake Store Gen2 using AADコネクターを使うと、Data Lake Storeからデータファイルを取得し、Domoで利用できます。データファイルは、CSV、TSV、TXTのいずれかのファイルタイプで取得できます。Azure APIについて詳しくは、製品ドキュメント（ https://docs.microsoft.com/en-us/azu…ta-lake-store/ ）を参照してください。 Microsoft Azure Data Lake Store Gen2 AADアカウントには、Data Centerから接続します。このトピックでは、Microsoft Azure Data Lake Store Gen2 using AADコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
Microsoft Azure Data Lake Store Gen2 AADアカウントに接続してDataSetを作成するには、以下が必要です。- Azure Active Directory設定から取得したクライアントWeb AppのクライアントID（GUID）とシークレットキー
- Microsoft Azure Data Lake Storageのアカウント名
- テナントID
Azure Appを設定する
必要なクライアントIDとシークレットを取得するには、最初にMicrosoft Azure Web Appを作成する必要があります。 Azure Appを設定するには ：- Azureポータル にログインします。
- ［Azure Active Directory］>［App Registrations］>［New Registration］ の順に選択します。
- 登録フォームに次の通りに入力します。
- ［Name］：アプリケーションの名前を入力します。
- ［Supported account types］：オプションを選択して、このアプリケーションを使用できる、またはこのAPIにアクセスできるユーザーを指定します。
- ［Redirect URI］：リダイレクトURIを入力します。認証応答は、ユーザーの認証に成功した後にこのURIに送信されます。この段階でURIを指定することは任意で、後で変更することもできますが、ほとんどの認証シナリオでは値が必要です。
- ［Register］ をクリックします。登録したAppの概要が表示されます。
- ここに表示される ［Application ID］ が クライアントID であり、［Directory ID］ はDomoの ［認証情報］ ペインに入力する テナントID になります。
- 次に、［Certificates and secrets］ をクリックします。証明書は、トークンを要求するときにアプリケーションの識別情報を証明するためのシークレットとして使用できます。これは、パブリックキーと呼ばれることもあります。
- ［+New client secret］ をクリックします。
- クライアントシークレットの説明と有効期限を指定し、［Add］ をクリックします。
- 値をコピーして、Domoのこの コネクターの［認証情報］ セクションの ［Client Secret］ フィールドに貼り付けます。
Microsoft Azure Data Lake Store Gen2 AAD アカウントに接続する
このセクションでは、 Microsoft Azure Data Lake Store Gen2 using AADコネクター ページの［認証情報］および［詳細］ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、 Microsoft Azure Data Lake Store Gen2 AAD アカウントに接続する認証情報の入力フィールドが含まれています。以下の表は、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
| Azure Application Client ID | Azure Active Directory設定から取得されるクライアントWeb AppのクライアントID（GUID）を入力します。詳細は、「必要条件」を参照してください。 |
| Azure Application Client Secret | クライアントWeb Appのシークレットキーを入力します。詳細については、「必要条件」を参照してください。 |
| Tenant ID | テナントIDを入力します。［ Portal.azure.com ］>［Azure Active Directory］>［Properties］に移動します。ディレクトリIDはお使いのテナントIDです。 |
| Account Name | Microsoft Azure Data Lake Storageアカウント名を入力します。 |
［詳細］ペイン
このペインには、メインの ［Reports］ メニューのほか、選択したレポートタイプに応じて表示/非表示になるその他様々なメニューがあります。メニュー | 説明 | ||||||
|---|---|---|---|---|---|---|---|
| What file type would you like to import? | インポートするファイルのタイプを選択します。 | ||||||
| Container Name | コンテナを選択します。 | ||||||
| How would you like to choose the directory name? | ディレクトリ名をどのように選択するかを選択します。 | ||||||
| Discover Directory Name | ディレクトリ名を選択します。 | ||||||
| Enter Directory Name | 次の例を使ってディレクトリ名を入力します。
| ||||||
| How would you like to choose the File name? | ファイル名の選択方法を選びます。 | ||||||
| Enter File Name | ファイル名を入力します。 | ||||||
| Discover File Name | ファイル名を選択します。 | ||||||
| File Encoding | ファイルのエンコーディングを選択します。デフォルトでは UTF-8 が選択されています。 | ||||||
| Select the delimiting character | ファイルで使用する区切り文字を選択します。区切り文字がリストにない場合は、［Other］を選択します。 | ||||||
| Specify your delimiter | CSVテキストを区切る文字を入力します。 | ||||||
| Quote Character | CSVファイルの解析に使用する引用文字を選択します（CSVの標準のデフォルトの引用符は二重引用符です）。 | ||||||
| Custom Quote Character | 希望するCSV引用符を入力します。 | ||||||
| Escape Character | CSVファイルを解析するために使用するエスケープ文字を選択します。 | ||||||
| Custom Escape Character | 希望するCSVエスケープ文字を入力します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
このコネクターを作成するにはどのような認証情報が必要ですか？
このコネクターを作成するにはどのような認証情報が必要ですか？
Azure Active Directory設定で取得したクライアントWeb AppのクライアントID、クライアントシークレット、テナントIDに加えて、ストレージアカウント名が必要です。
DomoクライアントID、クライアントシークレット、テナントIDを見つけるにはどうしたらよいですか？
DomoクライアントID、クライアントシークレット、テナントIDを見つけるにはどうしたらよいですか？
クライアントIDを取得するには：
- Azure Portal（ https://protal.azure.com ）にログインします。
- ［Azure Active Directory］>［App registrations］を選択します。
- ［Web App］>［Application ID］をクリックします。
- アプリケーションIDがクライアントIDです。
- Azure Portal（ https://protal.azure.com ）にログインします。
- ［Azure Active Directory］>［App registrations］を選択します。
- 証明書とシークレットをクリックしてから、［+New client secret］を選択します。
- シークレットの値をコピーします。シークレットは一度だけ生成されることに注意してください。
- Azure Portal（ https://protal.azure.com ）にログインします。
- ［Azure Active Directory］>［Properties］を選択します。
- ディレクトリIDをコピーします。ディレクトリIDがテナントIDです。
注意すべきAPI制限はありますか？
注意すべきAPI制限はありますか？
ありません。
データはどれくらいの頻度で更新可能ですか？
データはどれくらいの頻度で更新可能ですか？
必要に応じて何回でも更新できます。
同じアカウントを使用して複数のDataSetを作成することはできますか？
同じアカウントを使用して複数のDataSetを作成することはできますか？
はい。
トラブルシューティング
- 認証が有効であることを確認してください。
- 設定を見直し、すべての必須項目が選択されていることを確認してください。
- コネクターの履歴にエラーメッセージが記録されていないか確認してください。
- まれに、リクエストした情報が多すぎた結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。