Azure Data Lake アドインへのエクスポートのインストール

財務および運用環境で Data Lake へのエクスポート 機能を使用するには、管理者が Data Lake へのエクスポート アドインをインストールし、環境をData Lakeに接続する必要があります。 ライフサイクル サービスを使用して、Export Data Lake アドインを環境にインストールする必要があります。 この操作を実行するには、ライフサイクル サービス管理者に問い合わせてください。

Export to Data Lake アドインには、data lakeの接続情報が必要です。 そのため、ストレージ アカウント (つまり、Azure data lake) をまだ作成していない場合は、インストールする前に作成する必要があります。 必要なAzure リソースを作成するには、ユーザーに代わってAzureリソースを作成できる管理者に問い合わせる必要がある場合があります。

次のステップ バイ ステップの説明は、プロセスの手順を示します。

Microsoft Dynamics ERP マイクロサービスのサービス プリンシパルを作成する

Export to Azure Data Lake 機能では、財務および運用アプリのデータをエクスポートしてAzure Data Lakeし、データを最新の状態に保つマイクロサービスを使用します。 マイクロサービスは、Azure サービス プリンシパル Microsoft Dynamics ERP Microservices を使用して、Azure リソースに安全に接続します。 Data Lakeへのエクスポート機能を構成する前に、Microsoft Dynamics ERP マイクロサービス サービス プリンシパルをMicrosoft Entraに追加します。 この手順により、Microsoft Entraはマイクロサービスを認証できます。

サービス プリンシパルを追加するには、次の手順を実行します。

1. Azure ポータルを起動し、Microsoft Entraに移動します。

2. 左のメニューで、管理>エンタープライズ アプリケーションを選択し、以下のアプリケーションを検索します。

   申請書	アプリ ID
   Microsoft Dynamics ERP マイクロサービス	0cdb527f-a8d1-4bf8-9436-b352c68682b2

   上記のアプリケーションが見つからない場合は、次の手順を実行します。

3. ローカル コンピューターで、スタート メニューを開き、PowerShell を検索します。

4. Windows PowerShell を右クリックし、 管理者として実行を選択します。

5. 以下のコマンドを実行して AzureAD モジュールをインストールします。

   Install-Module -Name AzureAD
   

   • NuGet プロバイダーを続行する必要がある場合は、Y を選択してインストールします。
   • 信頼できないリポジトリのメッセージが表示された場合は、Y を選択して続行します。

6. 次のコマンドを実行して、アプリケーションをMicrosoft Entraに追加します。

   Connect-AzureAD
   

   New-AzureADServicePrincipal –AppId '0cdb527f-a8d1-4bf8-9436-b352c68682b2'
   

7. メッセージが表示されたら、Microsoft Entra管理者としてサインインします。

Azure リソースを構成する

Data Lakeへのエクスポートを構成するには、独自のAzure サブスクリプションにストレージ アカウントを作成します。 このストレージ アカウントを使用してデータを格納します。 次に、ストレージ アカウントのルートへのアクセスを許可するMicrosoft Entra アプリケーション ID を作成します。 財務アプリまたは運用アプリでは、Microsoft Entra アプリケーションを使用してストレージにアクセスし、フォルダー構造を作成し、データを書き込みます。 サブスクリプションにキー コンテナーを作成し、ストレージ アカウントの名前、アプリケーション ID、アプリケーションのシークレットを保存します。 Azure ポータルでリソースを作成するアクセス許可がない場合は、組織内のユーザーが必要なアクセス許可を持つサポートを受ける必要があります。

次の手順は、Azure ポータルで実行されます。

1. Microsoft Entra ID
2. サブスクリプションにData Lake Storage (Gen2 アカウント) を作成します
3. アプリケーションにアクセス制御ロールを付与する
4. キー コンテナーを作成します
5. キー コンテナーにシークレットを追加する
6. キー コンテナーのシークレットを読み取るためにアプリケーションを許可する
7. Power Platform の統合
8. ライフサイクル サービスで Data Lake アドインにエクスポートをインストールします

Microsoft Entra IDでアプリケーションを作成する

1. Azure ポータルで Microsoft Entra を選択し、App registrations を選択します。

2. 新しいアプリケーションの登録を選択し、以下の情報を入力します。

   • 名前: アプリの名前を入力します。
   • 対応しているアカウントのタイプ : 適切なオプションを選択します。

3. アプリケーションを作成したら、それを選択し、ページの上部にある Application (クライアント) ID をコピーして保存します。 この ID は後で必要になります。

4. 左のナビゲーション ウィンドウで、証明書 & シークレットを選択し、新しいクライアント シークレットを選択します。

5. 説明フィールドに名前を入力します。

6. 有効期限 フィールドで、オプションを選択し、追加 を選択します。 システムがシークレットを生成し、グリッドの下に表示します。

7. シークレット値をクリップボードにコピーします。 後でキー コンテナーを設定する際に、この 値を提供する必要があります。

サブスクリプションに Data Lake Storage (Gen2) アカウントを作成する

Data Lake Storage アカウントを使用して、財務および運用アプリのデータを格納します。 ストレージ アカウントを手動で作成するには、組織のAzure サブスクリプションに対する管理者権限が必要です。 ストレージ アカウントを作成するには、次の手順を完了してください。

1. Azure ポータルで Create new resource を選択し、Storage アカウント (BLOB、ファイル、テーブル、キュー。

2. ストレージ アカウントを作成 ダイアログ ボックスで、次のパラメーター フィールドの値を指定します。

   • 場所: 環境があるデータ センターを選択します。 選択したデータ センターが別のAzure リージョンにある場合は、データ移動コストが高くなります。 Microsoft Power BIまたはデータ ウェアハウスが別のリージョンにある場合は、レプリケーションを使用してリージョン間でストレージを移動できます。
   • [パフォーマンス]: [標準] を選択します。
   • アカウントの種類: StorageV2 を選択します。 Advanced オプション ダイアログ ボックスに、Data Lake storage Gen2 オプションが表示されます。

3. Advanced タブで、 Data Lake storage Gen2>Hierarchical namespaces を選択し、 Enabled を選択します。 このオプションを無効にすると、 Data Lake へのエクスポート 機能がエラーで失敗する可能性があります。

4. 確認して作成 を選択します。 デプロイが完了すると、Azure ポータルに新しいリソースが表示されます。

5. Azure ポータルで、作成したストレージ アカウントを選択します。 ストレージアカウント名をコピーして保存し ます。

アプリケーションにアクセス制御ロールを付与する

アプリケーションにストレージ アカウントの読み取り、書き込みのアクセス許可を付与する必要があります。 Microsoft Entra IDのロールを使用して、これらのアクセス許可を付与します。

1. Azure portal で、前に作成したストレージ アカウントを開きます。

2. 左側のナビゲーションで Access Control (IAM) を選択します。

3. アクセス制御 ページで、ロールの割り当て タブを選択します。

4. ページの上部の追加 を選択し、ロール割り当ての追加 を選択します。

5. ロール割り当ての追加ダイアログ ボックスで、ロール フィールドを選択し、ストレージ BLOB データの共同作成者を選択します。

6. 選択フィールドで、前述の手順で登録したアプリケーションを選択します。

   メモ

   フィールドAssign access toとMicrosoft Entra ユーザー、グループ、またはサービス プリンシパルに変更を加えないでください。

7. 保存を選びます。

8. 先ほど作成したアプリケーション のストレージ アカウント ロール の割り当てを検証します。

   申請書	ロール
   既に作成したアプリケーション	ストレージ BLOB データの共同作成者

キー コンテナーの作成

キー コンテナーは、ストレージ アカウント名などの詳細情報を財務と運用アプリに共有する安全な手段です。 キー コンテナーとシークレットを作成するには、次の手順を完了してください。 Data Lake へのエクスポート機能を使用するためのキー コンテナーを作成します。 複数のサービスへのアクセスを提供するために同じキー コンテナーを使用しないでください。

1. Azure ポータルで、[新しいリソースの作成を選択し、Key Vault を検索して選択します。
2. キー コンテナーの作成ダイアログ ボックスの場所フィールドで、環境があるデータ センターを選択します。
3. キー コンテナーの作成後は、一覧から選択し、左側のナビゲーション ウィンドウで 概要 を選択します。
4. DNS名フィールドに値を保存します。 この値はのちほど使用します。

キー コンテナーにシークレットを追加する

キー コンテナーに 3 つのシークレットを作成し、前の手順で保存した値を追加します。 シークレットごとにシークレット名を指定し、前の手順で保存した値を入力します。

シークレットごとに 1 回、次の手順を 3 回実行します。

1. Azure ポータルで、前に作成したキー コンテナーに移動します。 左側のナビゲーション ウィンドウで、[シークレット] を選択 します。
2. [Generate/Import](生成/インポート) を選択します。 シークレットを作成 ダイアログ ボックスの アップロード オプション フィールドで、手動 を選択します。
3. シークレットの名前を入力します。 このセクション冒頭の「推奨される名前」の表を参照してください。
4. 値フィールドに、対応するシークレットの値をコピーして貼り付け ます。
5. 有効 を選択し、作成を選択します。

シークレットの一覧に作成されたシークレットが表示されます。

キー コンテナーのシークレットを読み取るためにアプリケーションを許可する

1. Azure ポータルで、前に作成したキー コンテナーを開きます。

2. 設定で、構成にアクセスを選択します。

3. 次に、 アクセス ポリシー に移動し、[ 作成 ] を選択して新しいポリシーを作成します。

4. シークレットのアクセス許可フィールドで、取得とリストを選択します。

5. 主要なアクセス許可 フィールドで 取得 を選択します。

6. プリンシパルの選択 フィールドで、アプリケーションMicrosoft Dynamics ERP マイクロサービスを見つけて選択し、Select を選択します。

   メモ

   Microsoft Dynamics ERP マイクロサービスが見つからない場合は、このドキュメントの「Create サービス プリンシパル」セクションを参照してください。

7. 保存を選びます。

   次の例と同様に、キー コンテナーへのアクセス許可を持つアプリケーションが表示されている必要があります。

   申請書	シークレットのアクセス許可
   Microsoft Dynamics ERP マイクロサービス	取得、リスト表示

Power Platform の統合

初めてこの環境にアドインをインストールする場合は、この環境の Power Platform 統合 を有効化する必要がある場合があります。 詳細については、「Microsoft Power Platform finance and operations アプリとの統合を参照してください。

ライフサイクル サービスで Data Lake アドインへのエクスポートをインストールする

財務および運用アプリからデータ レイクにデータをエクスポートするには、Lifecycle Services にExport to Data Lakeアドインをインストールする必要があります。 このタスクを完了するには、使用する環境の Lifecycle Services 環境管理者である必要があります。

これを開始する前に、次の情報を確認する必要があります。 作業の開始前に、情報を手元に保管しておいてください。

1. Lifecycle Services にサインインし、ご利用の環境に移動します。
2. Environment ページで、Environment アドイン タブを選択します。Export Data Lake が一覧に表示される場合は、Data Lake アドインが既にインストールされているため、この手順の残りの部分は省略できます。 これに該当しない場合は、残りの手順を実行してください。
3. インストールするアドインを選択し、ダイアログ ボックスで、データ レイクへのエクスポートを選択します。 データ レイクへのエクスポート が表示されない場合は、この機能がご利用の環境で使用できない可能性があります。
4. 設定のアドイン ダイアログ ボックスで、必要な情報を入力します。 質問に答えるには、既にストレージ アカウントが作成されている必要があります。 ストレージ アカウントをまだ持っていない場合は、作成するか、管理者にアカウントの作成代行を依頼してください。
5. チェック ボックスをオンにしてサービス条件を承認し、インストール を選択します。

システムが、ご利用の環境に Data Lake をインストールし構成します。 この操作には数分かかる場合があります。 インストールと構成が完了すると、Export to Data Lake が Environment ページに表示され、状態は Installed になります。 別のステータスが表示される場合は、次の「トラブルシューティング」のセクションを参照してください。

トラブルシューティング

数分後にインストールしたアドインが完了しない

場合によっては、アドイン インストールのステータスがインストールまたはコンフィグレーションに、10 分以上表示される場合があります。 遅延の原因は、構成の問題や不足しているパラメータによるものです。 この場合、中止オプションを選び、手順に従って再度アドインをインストール してください。

アドインのインストールに失敗

場合によっては、アドイン インストールのステータスがインストールに失敗と表示されます。 インストールに失敗すると、エラー コードとエラー メッセージが表示されます。 次の表の「解決策」列に、失敗の理由の修正に役立つ候補が示されています。 この問題を修正するには、中止オプションを選び、手順に従って再度アドインをインストール してください。