Microsoft Dynamics 365 取り込みコネクタの制限

備考

プレビュー

この機能は パブリック プレビュー段階です。

このページでは、 LakeFlow ConnectのMicrosoft Dynamics 365 コネクタの制限と制約について説明します。

一般的な SaaS コネクタの制限

Dynamics 365 コネクタには、 LakeFlow ConnectのすべてのSaaSコネクタに共通する制限があります。

• スケジュールされたパイプラインを実行しても、アラートはすぐにはトリガーされません。代わりに、次の更新が実行されたときにトリガーされます。
• ソース テーブルを削除しても、宛先テーブルは自動的に削除されません。宛先テーブルを手動で削除する必要があります。この動作は、 Lakeflow Spark宣言型パイプラインの動作と一致しません。
• ソースメンテナンス期間中、Databricks はデータにアクセスできない可能性があります。
• ソース テーブル名が既存の宛先テーブル名と競合する場合、パイプラインの更新は失敗します。
• 複数の宛先パイプラインのサポートは API のみです。
• オプションで、取り込むテーブルの名前を変更できます。パイプライン内のテーブルの名前を変更すると、そのパイプラインは API 専用となり、UI でパイプラインを編集できなくなります。
• 列レベルの選択と選択解除は API のみです。
• パイプラインが既に開始された後に列を選択した場合、コネクタは新しい列のデータを自動的にバックフィルしません。履歴データを取り込むには、テーブルで完全な更新を手動で実行します。
• Databricks は、異なるソース スキーマからのものである場合でも、同じパイプラインに同じ名前を持つ 2 つ以上のテーブルを取り込むことはできません。
• ソース システムは、カーソル列が単調に増加すると想定します。
• SCDタイプ 1 が有効になっている場合、削除によって変更データフィードに明示的なdeleteイベントが生成されません。 監査可能な削除の場合、コネクタがサポートしている場合は SCD タイプ 2 を使用します。詳細については、 「例: CDF ソース データを使用した SCD タイプ 1 および SCD タイプ 2 の処理」を参照してください。
• コネクタは、変換せずに生データを取り込みます。変換にはダウンストリームのLakeFlow Spark宣言型パイプライン パイプラインを使用します。

Azure Synapse Link の要件

Dynamics 365 コネクタでは、Azure Synapse Link for Dataverse が継続的に実行される必要があります。

• 継続的な操作 : Synapse Link は中断することなくデータをエクスポートする必要があります。Synapse Link が停止した場合、コネクタは再開するまで変更をキャプチャできません。
• エクスポートの待機時間 : Synapse Link のエクスポート間隔 (通常は 5 ～ 15 分) の後に、変更がAzureデータレイク ストレージ ( ADLS ) Gen2 に表示されます。 Synapse Link アーキテクチャには本質的にこの遅延が含まれます。
• 保持ポリシー : ADLS Gen2 ストレージに適切な保持ポリシーを構成します。取り込み前に Synapse Link エクスポートを削除する場合は、完全な更新を実行する必要があります。

重要

Azure Synapse Link が長時間停止すると、変更が反映されない可能性があります。Power Apps メーカー ポータルで Synapse Link の正常性を監視し、エクスポートの失敗に関するアラートを設定します。

スキーマの進化

現時点では、Dynamics 365 コネクタは自動スキーマ進化をサポートしていません。

仮想実体スキーマ進化

Finance & Operations 仮想エンティティに関する特別な考慮事項:

F&O の仮想エンティティでは、スキーマの変更に対して追加の処理が必要です。

• 仮想エンティティの更新 : F&O 仮想エンティティが更新された場合は、Dataverse で仮想エンティティの構成を更新する必要があります。
• 同期の遅延 : 仮想エンティティの変更が Dataverse スキーマ検出に表示されるまでに最大 15 分かかります。
• 完全な更新が必要です : 仮想エンティティ スキーマの変更には、影響を受けるテーブルの完全な更新が必要です。

必要なアクション : F&O 仮想エンティティの更新を監視し、D365 管理者と連携して完全な更新を調整します。

増分取り込み

Dynamics 365 コネクタの増分取り込みには次の制限があります。

• VersionNumber が必要です : Synapse Link はVersionNumberフィールドを使用して変更ログをエクスポートする必要があります。VersionNumberがない場合、完全更新モードを使用する必要があります。
• フォルダーベースの処理 : コネクタは Synapse Link エクスポート フォルダーを時系列順に処理します。フォルダーを削除した場合、またはフォルダーが見つからない場合、コネクタは完全に更新しないと回復できません。
• バックフィルなし : ダウンタイムのために Synapse Link が変更を見逃した場合、完全な更新を実行しない限り、それらの変更はキャプチャされません。
• 削除の検出 : コネクタは、Synapse Link が変更ログ内の削除レコードをエクスポートする場合にのみ削除を検出します。一部の D365 構成では削除がエクスポートされません。

ヒント

パイプラインを作成する前に、 VersionNumberを使用して Synapse Link 構成が変更ログをエクスポートしていることを確認してください。Microsoft Dynamics 365 取り込み用のデータ ソースの構成」を参照してください。

添付ファイルとファイル

Dynamics 365 コネクタは添付ファイルのメタデータを取り込みますが、ファイルの内容は取り込みません。

• メタデータのみ : コネクタは、ファイル名、サイズ、MIME タイプ、およびレコードの関連付けを含む添付ファイル テーブル ( annotation 、 attachment ) を取り込みます。
• バイナリ データなし : コネクタはファイルの内容を取り込みません。Dynamics 365 Web API または Power Automate を使用してファイルを個別にダウンロードする必要があります。
• ストレージの制限 : Synapse Link は、D365 に保存されているバイナリ ファイルではなく、テーブル データをエクスポートします。

回避策 : 添付ファイルのメタデータを使用して必要なファイルを識別し、D365 APIsを使用してダウンロードし、ボリュームまたはADLS Gen2 に保存します。

データ型のサポート

Dynamics 365 コネクタはほとんどの Dataverse データ型をサポートしますが、複合型には制限があります。

完全な忠実度でサポート

• 文字列（1行および複数行のテキスト）
• 整数（整数）
• 小数（10進数）
• Boolean （はい/いいえ）
• DateTime（日付と時刻）
• お金（通貨）
• ルックアップ（外部キー参照、GUID として保存）

制限付きでサポート

• オプション セット (選択リスト) : コネクタはこれらを整数値として取り込みます。整数をラベルにマッピングするには、 OptionSetMetadataテーブルと結合するか、参照テーブルを維持します。
• 複数選択オプション セット : コネクタはこれらをコンマ区切りの整数文字列として取り込みます。文字列を解析して個々の値を抽出します。
• ルックアップ フィールド : コネクタはこれらを GUID として取り込みます。関連レコード データを取得するには、参照先のテーブルと結合します。

サポートされていません

• 複雑な JSON オブジェクト : 一部のカスタム Dataverse データ型は JSON としてエクスポートされます。コネクタはこれらを文字列として取り込みます。下流の変換で JSON を解析します。
• 画像 : 画像メタデータは取り込まれますが、画像データは別途ダウンロードする必要があります。

完全なデータ型マッピング テーブルについては、 Microsoft Dynamics 365 コネクタ リファレンスを参照してください。

パフォーマンスに関する考慮事項

Dynamics 365 コネクタのパフォーマンスは、いくつかの要因によって異なります。

初期同期時間

• データ量 : 数百万件のレコードを含むテーブルでは、最初に同期するのに時間がかかります。
• Synapse Link エクスポート : 大規模なデータセットの場合、最初の Synapse Link エクスポートに数時間かかることがあります。
• ネットワーク スループット : Azure と Databricks 間の転送速度は同期時間に影響します。

推奨事項 : セットアップを検証するために、テーブルの小さなサブセットから始めて、徐々にテーブルを追加します。

増分同期時間

• 変更量 : 高頻度の変更 (たとえば、1 分あたり数千回の更新) により、処理時間が長くなります。
• フォルダー数 : Synapse Link は定期的にフォルダーを作成します。フォルダーが増えると、処理のオーバーヘッドが増加します。
• 変更ログのサイズ : 変更ログが大きいと処理に時間がかかります。

推奨事項 : 変更量に基づいてパイプラインの実行をスケジュールします。変更頻度が高い場合は、変更ログを小さく保つために、パイプラインをより頻繁に実行します。

パイプラインの制限

Dynamics 365 コネクタには、パイプライン固有の制限があります。

• パイプラインあたりの最大テーブル数 : 250 テーブル。大規模な D365 環境の場合は、複数のパイプラインを作成します。
• UI 作成なし :現時点では、CLI、Databricks アセット バンドル、またはノートブックを使用してパイプラインを作成する必要があります。

注記

250 テーブルの制限は接続ごとではなくパイプラインごとです。250 を超えるテーブルを取り込むには、同じ接続を使用して複数のパイプラインを作成します。

APIとSDKの制限

Dynamics 365 コネクタは、次の制限付きで Dataverse およびAzure Storage APIs使用します。

• API バージョンの互換性 : コネクタは、Dataverse API v9.2 以降でテストされています。古いバージョンはサポートされない可能性があります。
• Azure Storage API : コネクタは、Azure Storage REST API バージョン 2021-08-06 を使用します。ストレージ アカウントがこのバージョンをサポートしていることを確認してください。
• Synapse Link バージョン : コネクタには、Azure Synapse Link for Dataverse バージョン 1.0 以降が必要です。

推奨事項 : 最高の互換性を得るために、D365、Dataverse、Azure サービスを最新バージョンに更新しておいてください。

既知の問題

• 仮想エンティティの同期の遅延 : 仮想エンティティの同期には 15 分以上かかる場合があります。テーブルが表示されない場合は、最大 30 分待ってから再試行してください。
• Synapse Link エクスポートの失敗 : Synapse Link が特定のテーブルのエクスポートに失敗することがあります。Power Apps の Synapse Link ログでエラーを確認します。
• 変更ログ バージョン番号のギャップ : まれに、変更ログのVersionNumberシーケンスにギャップが生じる場合があります。これはデータの完全性には影響しませんが、パイプライン ログに警告が表示される可能性があります。

調査のために、パイプライン ID とタイムスタンプを添えて Databricks サポートに問題を報告してください。