財務と運用アプリの Data Lake にエクスポートする

Note

コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。

Note

過去 12 か月間、製品チームは、ギャップを埋め、ユーザー コミュニティのメンバーが強調した新機能を追加するために取り組んできました。 Power Apps に搭載された Dataverse サービスの Synapse Link は、財務と運用アプリの データレイクへのエクスポート機能の後継機能が一般的に利用できるようになりました。 Synapse Link は、すべての Microsoft Dynamics 365 アプリのデータを 1 つのエクスペリエンスで操作できます。

Synapse Link が可能な限り早く提供するパフォーマンス、柔軟性、およびユーザー エクスペリエンスの向上からメリットを得られます。 そのため、Microsoft は、2023 年 10 月 15 日より、 Data Lake へのエクスポート 機能の廃止を発表しました。 すでに データ レイクへのエクスポート機能を使用している場合は、2024 年 11 月 1 日まで引き続き使用できます。 Data Lake へのエクスポート機能を初めて使用する場合、または今後数か月以内にこの機能を採用する予定の場合は、代わりに Synapse Link を使用してください。

移行は困難に思えるかもしれませんが、Microsoft はよりスムーズなエクスペリエンスを提供し、ガイダンスを提供したいと考えています。 開始するには、 Synapse Link 移行ガイド を参照してください。 製品チームはコミュニティに密接に耳を傾け、移行をよりスムーズにするために複数の機能に取り組んでいます。 新しい機能がオンラインになると、移行プロセスに対するこれらの他の機能強化が発表されます。 連絡を取り合う場合は、https://aka.ms/SynapseLinkforDynamics のコミュニティに参加してください。

Data Lake へのエクスポート機能を使用すると、財務と運用アプリから自分の Data Lake にデータをコピーできます (Azure Data Lake Storage Gen2)。 このシステムでは、含めるテーブルやエンティティを選択できます。 必要なデータを選択した後、システムが初期コピーを行います。 システムは、変更、削除、追加を適用することで、選択したデータを最新の状態に保ちます。 財務と運用アプリのインスタンスのデータを変更後、Data Lake でデータが使用可能になるまでには数分を要する場合があります。

Data Lake へのエクスポート機能を有効にする

この機能を使用する前に、Azure Data Lake アドインへのエクスポートをインストールするを参照してください。

データの選択

Note

環境内の機能管理モジュールで Azure Data Lake へのエクスポート機能を使用できない場合は、環境にサインインし、ブラウザー アドレスの URL に次の文字列を追加します:&mi=DataFeedsDefinitionWorkspace。 たとえば、「 https://ax123456.cloud.test.dynamics.com/?cmp=USMF&mi=DataFeedsDefinitionWorkspace 」のように入力します。

データ レイクでステージングするテーブルとエンティティを選択します。

  1. ご利用の環境で、システム管理>設定>Data Lake にエクスポートするの順に移動します。

    ナビゲーション バーの検索フィールドを使用して、Data Lake にエクスポート ページを開くこともできます。 検索フィールドで、構成と入力します。 検索結果には、ページへのリンクが含まれます。

  2. [ Data Lake へのエクスポート ] ページの [ テーブルの選択 ] タブで、Data Lake でステージングするデータ テーブルを選択します。 テーブルは、表示名またはシステム名のいずれかで検索できます。 テーブルが既に同期されているかどうかを確認することもできます。

  3. 完了したら、[テーブルの 追加] を選択して、選択したテーブルをデータ レイクに追加します。

    [Data Lake へのエクスポート] ページでテーブルを選択しているスクリーンショット。

  4. データフィードの有効化 を選択し 、OK を選択します。 テーブルを追加すると、システムのステータスが初期化として表示される場合があります。 この状態は、データの初期コピーを作成していることを示します。 初期コピーが完了すると、システムは状態を 実行中に変更します。 初期コピー後に財務と運用アプリでデータが変更されるため、データが Data Lake で更新されます。 最後に処理された変更列に、最新のデータ変更が表示できます。 初期コピー後にシステムでのデータのを変更がない場合、このフィールドは空白のままになります。

    エラーが発生した場合は、状態が 無効 として表示されます。

    状態が実行中の場合、Data Lake でデータを消費できます。 初期化または無効化状態の間に Data Lake でデータを使用している場合は、一部のデータが表示されないことがあります。

    必要な特定のテーブルに慣れていない場合は、エンティティを使用してテーブルを選択します。 エンティティはデータの抽象度が高く、複数のテーブルを含む場合があります。 エンティティを選択することで、エンティティを構成する基になるテーブルを選択します。

    Note

    エンティティを使用して選択タブを初めて開いた場合、ページのエンティティの一覧が空白である場合があります。 システムは、エンティティの一覧に入力するのに時間がかかる場合があります。 アクション ウィンドウで [ 管理>Rebuild データ フィード カタログ ] を選択して、リストを強制的に更新できます。

  5. 使用するエンティティの選択 タブでエンティティを選択し、エンティティを使用してテーブルを追加する を選択します。

    [Data Lake へのエクスポート] ページのエンティティを使用してテーブルを選択するスクリーンショット。

    テーブルを選択する方法を問わず、テーブルは Data Lake にステージングされます。

Data Lake のテーブルを監視する

データ のエクスポートを監視またはスケジュールする必要はありません。これは、データ レイクでデータが更新された状態を維持するためです。 Data Lake へのエクスポート ページの状態列で、進行中のデータ エクスポートの状態を確認することができます。

データを選択すると、Azure Data Lake へのエクスポート サービスは、Data Lake 内のデータの初期コピーを作成します。 複数のテーブルを選択する場合、システムは一度に 10 個のテーブルを取得して初期コピーを作成します。 データのサイズやテーブル内のレコード数によっては、このプロセスに数分または数時間かかる場合があります。 エクスポートの進行状況が画面に表示されます。

初期コピーが作成された後、財務と運用アプリで変更が行われると、システムによってデータが継続的に更新されます。 レコードの挿入、更新、または削除を行う場合、Data Lake 内のデータ レコードは、それに応じて挿入、更新、または削除されます。

ほぼリアルタイムのデータ変更機能を使用すると、財務と運用環境の変更から数分以内に Data Lake 内のデータは更新されます。 それ以外の場合は、財務と運用環境内の変更から数時間以内に Data Lake 内のデータは更新されます。

財務と運用環境にある Data Lake へのエクスポートのページは、Data Lake 内のデータが最後に更新された時のタイム スタンプを表示します。 システムは、Data Lake 内のデータが更新された時刻を識別するのに役立つデータ フィールドも追加します。 ダウンストリーム プロセスでは、タイム スタンプを使用して、Data Lake 内で変化するデータを検出して処理できます。

一般的な問題とエラーに対するトラブルシューティング

現時点では、お使いのリージョンや環境では、Data Lake へのエクスポート機能を使用できません

この機能は、Tier 1 (開発者) 環境では使用できません。 バージョン 10.0.13、またはそれ以上のプラットフォーム更新プログラムを含むサンドボックス環境 (Tier 2 またはそれ以降) が必要です。

この機能は、財務と運用アプリが利用可能なすべての Azure リージョンや、ご使用の環境によっては利用できない場合があります。 Microsoft Viva Engage の Fabric/Synapse Link for Dynamics コミュニティに参加して、お客様のリージョンでの今後の改善と可用性に関する最新情報を入手できます。

Data Lake へのエクスポート機能は、ご利用の環境にインストールされています。 後でもう一度確認してください

この機能を使用する前に、Data Lake へのエクスポートを構成する必要があります。 詳細については、Azure Data Lake へのエクスポートの構成を参照してください。

Data Lake アドインへのエクスポートがインストールされていない

Dynamics Lifecycle Services を使用してこのアドインをインストールする場合は、管理者に問い合わせてください。 この機能を使用する前に、Data Lake へのエクスポートを構成する必要があります。 詳細については、Azure Data Lake へのエクスポートの構成を参照してください。

Data Lake へのエクスポート機能をライフサイクル サービスにインストールできませんでした

Data Lake アドインへのエクスポート機能を再インストールするには、管理者に問い合わせてください。 問題が解消しない場合は、サポートにお問い合わせください。 Data Lake へのエクスポート機能を構成した際に、エラーが表示される場合があります。 または、ご利用の環境の変更がされている場合は、構成後に Data Lake にアクセスした際にエラーが発生する場合があります。 詳細については、Azure Data Lake へのエクスポートの構成を参照してください。

Data Lake へのエクスポート機能は、一時的に使用できなくなります。 後でもう一度確認してください

このエラーが長時間継続するする場合は、サポートに連絡してください。

データ レイクに一部のフィールド (長い文字列やメモ型のフィールドなど) がありません

システムは、メモnVarchar(max)VarBinaryBlob タイプのフィールドを Data Lake にエクスポートしません。 これらのタイプのフィールドを含むテーブルを選択すると、それらのフィールドは無視され、他のフィールドがエクスポートされます。 Microsoft では将来そのような特殊フィールドも有効化するように取り組んでいます。 製品チームと連絡を取り合い、今後の機能について学習したい場合は、Microsoft Viva Engage の Fabric/Synapse Link for Dynamics コミュニティに参加できます。

Data Lake でデータを探すには?

この機能を使用してエクスポートされたデータは、Lifecycle Services を介して設定されたストレージ アカウントのフォルダー構造に格納されます。 フォルダー構造におけるデータの正確な場所は、Azure Data Lake 内に格納されたデータとメタデータで説明したように、テーブル メタデータ プロパティによって異なります。 これらのメタデータ プロパティが変更された場合、フォルダー構造のデータの場所も変更される可能性があります。 Azure Data Lake へのエクスポート サービスによって生成されるビジネス イベントで説明したように、ビジネスの初期化イベントを使用してこれらの変更を検出して新しいパスを見つけることができます。 Data Lake 内のデータ ファイルの消費は可能ですが、T-SQL を使用してデータにアクセスできます。 この方法を使用するには、FastTrack for Dynamics 365 - CDMUtilSolution を使用して Azure Synapse Analytics サーバーレス SQL プールを構成します。

データがエクスポートされておらず、データ ファイルが見つかりません

選択したテーブルにデータがない場合、テーブルが 実行中 の状態であることがシステムに表示されます。 ただし、システムはデータ レイクにコンマ区切り値 (CSV) ファイルを作成しません (ただし、フォルダーに他のシステム ファイルが表示される場合があります)。 財務と運用アプリでデータが追加されると、データを使用して CSV ファイルが作成されます。

一部のテーブルは、ユーザー アクションなしで "初期化" されます

テーブルを追加して最初のコピーが完了すると、テーブルは 実行中 の状態のままになり、データ レイクのデータ変更が更新されます。 まれに (データベースの復元や、基礎になる環境で問題が発生した場合)、システムは Data Lake でデータを再初期化して問題から回復する場合があります。 変更データを下流システムにコピーしている場合は、イベントの再初期化に対応しなければならない場合があります。 Azure Data Lake へのエクスポート サービスによって生成されるビジネス イベントで説明したように、ビジネス イベントを使用してこれらの条件を監視できます。

Synapse サーバーレスを使用してデータ ファイルを読み取ると、"レコード内に予期しない入力の終了..." というエラーが断続的に発生します。

財務および運用アプリでテーブル レコードが頻繁に更新または削除されると、CSV ファイルの読み取り/書き込みの競合が発生し、このエラーが発生する可能性があります。 この問題は、Syapse サーバーレス SQL サービスが更新中の CSV ファイルをクエリする際に発生します。 多くの場合、クエリを再試行することで、この問題を解決できます。

ほぼリアルタイムに近いデータ変更機能または拡張されたメタデータ機能を有効化するには?

新機能を有効にするには、「 Azure Data Lake へのエクスポートの構成」で説明されているプロセスを使用して、アドインを再インストールします。 アドインをアンインストールすると、Data Lake の既存のデータが残ります。 アドインを再インストールするときは、[ Data Lake にエクスポート] ページを使用してテーブルを追加します。 システムはテーブルを再初期化しますが、フォルダー パスは変更されません。 下流消費は影響を受けない可能性があります。

Data Lake にエクスポートするアドイン用に提供される Key Vault で、アプリケーション シークレットをローテーションまたは更新するには?

アプリケーション シークレットを定期的に更新または拡張します。 新しいクライアント シークレットを作成し、キー コンテナー内のシークレットを置き換えます。

拡張エラーを含むステータス コード

Data Lake へのエクスポートに追加したテーブルでエラーが発生すると、状態列にエラー コードが表示されることがあります。 次のエラー コードは、エラーの原因と問題の修正方法を示します。

エラー ステータス コード 4xx は、テーブルに関する問題を示します

エラー コード 問題点 次のステップ
400 追加したテーブルには RecID フィールドが含まれていません。 システムは RecID フィールドを使用してテーブル データのインデックスを作成します。 RecID フィールドを含まないテーブルをデータ レイクに追加することはできません。 この問題が財務および運用アプリのテーブルから発生する場合は、Microsoft サポートにお問い合わせください。 パートナーまたは ISV がこのテーブルを開発した場合は、開発者に連絡して RecID フィールドを含めます。
401 追加したテーブルがデータベースにありません。 追加したテーブルがデータベースで使用できなくなり、システムはレイクでデータの更新を続行できません。 ソフトウェアまたはデータベースの更新によってテーブルが削除された可能性があります。 この問題を解決するには、データベース管理者または開発者にお問い合わせください。 パートナーまたは ISV がこのテーブルを開発した場合は、開発者に問い合わせてください。

この問題は、DirPerson テーブルなどの「派生テーブル」を追加する場合にも発生する可能性があります。 現在、派生テーブルはサービスでサポートされていません。 派生テーブルを選択するには、ベース テーブルを選択する必要があります。 将来のリリースで派生テーブルのサポートが追加される予定です。
402 RecID フィールドがインデックス化されません。 テーブル内の RecID フィールドがインデックスの一部ではないか、インデックスの最初のフィールドではないことがシステムによって検出されました。 このテーブルは Data Lake の更新でのパフォーマンスが低下し、更新が Data Lake に反映されるのに時間がかかる可能性があります。 この問題を解決するために、インデックスに RecID フィールドを含めることができます。 この問題が財務および運用アプリのテーブルから発生する場合は、Microsoft サポートにお問い合わせください。 パートナーまたは ISV がこのテーブルを開発した場合は、開発者に問い合わせてください。
409 アクセス許可が原因で、ストレージ アカウントにアクセスできません。 ストレージ アカウントのコンフィギュレーションを確認します。 システムはストレージ アカウントにアクセスして書き込むできません。 階層型名前空間 (HNS) を有効にし、アクセス ロールを検証します。 詳細については、Azure Data Lake へのエクスポートのコンフィギュレーション - アクセス権の付与を参照してください。 この問題を解決するには、システム管理者またはシステムを構成したライフサイクル サービス管理者に問い合わせてください。
410 Data Lake にアクセスするためのアプリケーション ID の検出に失敗しました。 指定されたアプリケーション ID が正しくない、または見つかりません。 Key Vault で指定されたアプリケーション ID が Microsoft Entra ID で見つかりません。 Azure Data Lake へのエクスポートのコンフィギュレーション - 申請書の作成に記載の手順に従って、Key Vault で指定されたアプリケーション ID を検証します。
411 指定されたアプリケーション ID とアプリケーション シークレットで Data Lake にアクセスできませんでした。 指定されたアプリケーション ID (app-id) とアプリケーション シークレット (app-secret) は、ストレージ アカウントへのアクセスには使用できません。 Azure Data Lake へのエクスポートのコンフィギュレーション - 申請書の作成に記載の手順に従って、アプリケーション ID とアプリケーション シークレットが有効であることを確認します。

次に、ストレージ アカウントに必要なアクセス権を持っているかどうかを確認します。 詳細については、Azure Data Lake へのエクスポートのコンフィギュレーション - アクセス権の付与を参照してください。 システムを構成したシステム管理者またはライフサイクル サービス管理者に問い合わせる必要があります。
412 選択したテーブルがサポートされていないか、RecID インデックスがありません。 一部の内部テーブルおよびシステム テーブルは、データ レイクへのエクスポート機能でサポートされていません。 このエラーが表示された場合は、許可されないテーブルを選択した可能性があります。 将来的に、選択フォームにそのようなテーブルが表示されなくなる可能性があります。 サポートされているテーブルを使用して同じ情報を抽出するように計画する必要があります。

選択したテーブルに多数の行 (100 万以上) が含まれていて、必要な RecID インデックスが存在しない場合にも、このエラーが発生する可能性があります。 システムでは、RecID がインデックスの最初のフィールドであるインデックスを格納するために、より大きなテーブルが必要です。 このエラーを解決するために、テーブル拡張子として RecID インデックスを作成することができます。
415 Key Vault で指定されているストレージ名を使用してストレージ アカウントにアクセスできませんでした。 Key Vault で指定されているストレージ アカウントが見つからない、または無効です。 Azure Data Lake へのエクスポートのコンフィギュレーション - シークレットの追加に記載の手順に従って、正しいストレージ アカウント名が Key Vault に入力されていることを確認します。

「Azure Data Lake Add シークレットへのエクスポートを構成する」の手順に従って、ストレージ アカウントの正しいシークレット名を指定したことを確認します。
420 Key Vault または Key Vault のシークレットにアクセスできませんでした。 サービスは、Key Vault または Key Vault のシークレットにアクセスできません。  Azure サブスクリプションの有効期限が切れていないことを確認します。

サービス プリンシパルを作成したことを確認するには、「 Azure Data Lake へのエクスポートの構成 - サービス プリンシパルの作成の手順に従います。 

Azure Data Lake へのエクスポートのコンフィギュレーション - シークレットの追加に記載の手順に従って、Key Vault に必要なシークレットがすべて含まれていることを確認します。

Azure Data Lake へのエクスポートの構成 - アドインのインストール」の構成手順で、正しいキー コンテナー URI を指定していることを確認します。
425 環境の Azure テナント ID の検索に失敗しました。 「Azure Data Lake へのエクスポートの構成 - アドインのインストール」の手順に従って、正しい Azure テナント ID を指定していることを確認します。
430 環境にアクセスできませんでした。 環境が使用可能で、削除されているまたは無効な状態でないことを確認します。
435 レイク内のファイルが破損している、または無効です。 データ レイク内の破損したファイルまたは無効なフォルダー構造がシステムによって検出されました。 システムは、コンフィギュレーションで指定されたレイク内のファイルとフォルダーを管理します。 Data Lake 内のファイルやフォルダー構造を自分で変更しないでください。 ユーザーまたはプロセスによって、レイク内のファイルまたはフォルダーが変更されなかったことを確認します。 テーブルを再有効化して、問題が解決されているかどうか確認することができます。 問題が解決しない場合は、Data Lake アドインへのエクスポート機能をアンインストールしてから再インストールしてください。
439 選択したテーブルの拡張メタデータがシステムで見つかりません 財務と運用のバージョンを 10.0.28 (PU52) に更新し、管理 > メタデータの再発行 オプションを使用してメタデータを手動で更新する必要があります。 このオプションの後、数分間待って、問題が解決されたかどうかを確認する必要があります。
440 この環境で拡張メタデータをシステムが見つけられません [拡張メタデータ] 機能を選択すると、このエラーが表示されます。 この場合、システムが拡張メタデータを見つけられません。 この問題を解決するには、財務および運用バージョン 10.0.28 (PU52) 以降がインストールされていることを確認します。 適切なバージョンを使用している場合は、管理 > メタデータの再発行 オプションを使用してメタデータを手動で更新することもできます。 このオプションの後、数分間待って、問題が解決されたかどうかを確認する必要があります。

エラー ステータス コード 5xx は、データのエクスポート中にシステム エラーが発生することを示します

エラーのため、システムはデータのエクスポートを一時停止します。 レイクに存在するデータは、エラーが解決されるまで更新されません。 テーブルを無効化および有効化して、これにより問題が解決されるかどうか確認してください。 テーブルを無効化および有効化すると、システムが完全なコピーを作成してレイク内のデータが再初期化される場合があります。 それでも問題が解消しない場合は、テーブル名とエラー コードを手元に用意して Microsoft サポートにお問い合わせください。

エラー状態コード 8xx は、財務と運用アプリのデータベースの問題を示します

Microsoft Azure Data Lake 機能へのエクスポートは、財務と運用アプリ データベースの変更データ キャプチャ機能を使用します。 エラー 8xx は、財務と運用アプリ データベースの変更データ キャプチャ機能の問題を示します。 このエラーの原因は、データベース保守操作の結果、またはデータベース操作に影響を与える別の問題である可能性があります。 この問題の解決にサービス管理チームが積極的に取り組んでおり、お客様のアクションは必要ありません。 問題が解決しない場合は、Microsoft サポートに更新プログラムを依頼してください。

エラー状態コード 9xx は、財務と運用環境の問題を示します

エラー コード 9xx は、財務と運用環境にともなうシステム構成の問題を示します。 この問題の解決にサービス管理チームが積極的に取り組んでおり、お客様のアクションは必要ありません。 問題が解決しない場合は、Microsoft サポートに更新プログラムを依頼してください。

Note

テーブルを無効化および有効化すると、システムが完全なコピーを作成してレイク内のデータが再初期化される場合があります。 このテーブルが大きい場合、初期化プロセスに時間がかかる場合があります。 今後システムは、テーブル構造の変更を反映するため、レイク内のデータの更新を自動的に行う可能性があります。