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

ノート

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

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

この移行が困難に困難が伴い可能性は理解していますが、よりスムーズな経験を提供し、ガイダンスを提供したいと考えています。 開始するには、 Synapse Link 移行ガイド を参照してください。 コミュニティーの声に耳を傾け、よりスムーズな移行ができるよう、複数の機能に取り組んでいます。 移行プロセスに関するこの他の改善点については、新機能をオンライン化する際にお知らせします。 連絡を取り合う場合は、https://aka.ms/SynapseLinkforDynamics のコミュニティに参加してください。

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

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

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

データの選択

メモ

この機能 Azure Data Lake へのエクスポートがご利用中の環境内の機能管理モジュールで使用できない場合、環境にサインインし、ブラウザのアドレスに以下の URL を追加してください: &mi=DataFeedsDefinitionWorkspace たとえば、https://ax123456.cloud.test.dynamics.com/?cmp=USMF&mi=DataFeedsDefinitionWorkspace

Data Lake にステージングする必要のあるテーブルとエンティティを選択することができます。

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

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

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

  3. 完了後に、テーブルの追加を選択し、選択したテーブルを Data Lake に追加します。

    テーブルの選択。

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

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

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

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

    メモ

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

  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 リージョンや、ご使用の環境によっては利用できない場合があります。 Synapse Link for Dynamics プレビュー フィードバック Yammer グループに参加すると、今後の改善点やお住いの地域での利用可能性を確認することができます。

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

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

Data Lake アドインへのエクスポート機能がインストールされません。

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

Data Lake へのエクスポート機能は、Lifecycle Services へのインストールに失敗しました。

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

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

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

Data Lake に、一部のフィールド (長い文字列やメモ フィールドなど) がありません。

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

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

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

データがエクスポートされなかったため、データ ファイルが見つかりません。

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

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

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

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

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

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

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

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

アプリケーション シークレットを定期的に更新するか拡張することをお勧めします。 新しいクライアント シークレットを作成し、Key Vault でシークレットを置き換えることができます。

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

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

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

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

この問題は、DirPerson テーブルなどの「派生テーブル」を追加する場合にも発生する可能性があります。 現在、このサービスでは、派生テーブルはサポートされていません。 派生テーブルを選択するには、ベース テーブルを選択する必要があります。 将来のリリースで派生テーブルのサポートが追加される予定です。
402 RecID フィールドがインデックス化されません。 システムにより、テーブルに含まれる RecID フィールドがインデックスの一部ではないか、インデックスの最初のフィールドではないことが検出されました。 このテーブルは Data Lake の更新でのパフォーマンスが低下し、更新が Data Lake に反映されるのに時間がかかる可能性があります。 この問題を解決するために、インデックスに RecID フィールドを含めることができます。 この問題が財務と運用アプリのテーブルからの問題である場合は、Microsoft サポートにお問い合わせください。 このテーブルがパートナーまたは ISV によって開発された場合は、開発者にお問い合わせください。
409 アクセス許可が原因で、ストレージ アカウントにアクセスできません。 ストレージ アカウントのコンフィギュレーションを確認します。 システムはストレージ アカウントにアクセスして書き込むことができません。 階層の名前空間 (HNS) が有効になっていることを確認し、アクセス ロールを検証してください。 詳細については、Azure Data Lake へのエクスポートのコンフィギュレーション - アクセス権の付与を参照してください。 この問題を解決するには、システムを構成したシステム管理者または LCS 管理者に連絡してください。
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 へのエクスポートのコンフィギュレーション - アクセス権の付与を参照してください。 システムを構成したシステム管理者または LCS 管理者に連絡する必要があります。
412 選択したテーブルがサポートされていないか、RecID インデックスがありません。 一部の内部テーブルおよびシステム テーブルは、データ レイクへのエクスポート機能でサポートされていません。 このエラーが表示された場合は、許可されないテーブルを選択した可能性があります。 将来的に、選択フォームにそのようなテーブルが表示されなくなる可能性があります。 サポートされているテーブルを使用して同じ情報を抽出するように計画する必要があります。

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

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

Azure Data Lake へのエクスポートのコンフィギュレーション - サービス プリンシパルの作成に記載の手順に従って、サービス プリンシパルが作成されていることを確認します。 

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

Azure Data Lake へのエクスポートのコンフィギュレーション - アドインのインストールの構成手順で、正しい Key Vault URI が指定されていることを確認します。
425 環境の Azure テナント ID の検索に失敗しました。 Azure Data Lake へのエクスポートのコンフィギュレーション - アドインのインストールに記載の手順に従って、正しい Azure テナント ID が指定されていることを確認します。
430 環境にアクセスできませんでした。 環境が使用可能で、削除されているまたは無効な状態でないことを確認します。
435 レイク内のファイルが破損している、または無効です。 システムにより、Data Lake 内で破損したファイルまたは無効なフォルダー構造が検出されました。 システムは、コンフィギュレーションで指定されたレイク内のファイルとフォルダーを管理します。 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 サポートに更新プログラムを依頼してください。

ノート

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