Azure Data FactoryおよびAzure SynapseでのDynamics 365、Dataverse（共通データサービス）、およびDynamics CRMコネクタのトラブルシューティング

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

Data Factory in Microsoft Fabric は、よりシンプルなアーキテクチャ、組み込みの AI、および新機能を備えた次世代のAzure Data Factoryです。 データ統合を初めて使用する場合は、Fabric Data Factory から始めます。 既存の ADF ワークロードをFabricにアップグレードして、データ サイエンス、リアルタイム分析、レポートの新機能にアクセスできます。

この記事では、Dynamics 365、Dataverse (Common Data Service)、および Azure Data Factory および Azure Synapse の DYNAMICS CRM コネクタに関する一般的な問題のトラブルシューティングに関する推奨事項を示します。

エラー コード:DynamicsCreateServiceClientError

  • メッセージ: This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • Cause: この問題は、Dynamics サーバー側の一時的な問題です。

  • 推奨事項: パイプラインを再実行してください。 再度失敗した場合は、並列処理を減らしてみてください。 問題が解決しない場合は、Dynamicsサポートにお問い合わせください。

スキーマをインポートするとき、またはデータをプレビューするときに列が見つからない

  • 現象:スキーマをインポートするとき、またはデータをプレビューするときに、いくつかの列が欠落しています。 エラー メッセージ: The valid structure information (column name and type) are required for Dynamics source.

  • 原因: この問題は仕様によるものです。最初の 10 個のレコード内の値が含まれていない列を Azure Data Factory および Synapse のパイプラインでは表示できないためです。 追加した列が正しい形式であることを確認します。

  • 推奨事項: マッピング タブに列を手動で追加します。詳細については、「 明示的なマッピング」を参照してください。

エラー コード:DynamicsMissingTargetForMultiTargetLookupField

  • メッセージ: Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • 原因:ターゲット列がソースまたは列マッピングに存在しません。

  • 推奨事項:

    1. ソースにターゲット列が含まれていることを確認します。
    2. 列マッピングにターゲット列を追加します。 シンク列が {fieldName}@EntityReference の形式であることを確認してください。

エラー コード: DynamicsInvalidTargetForMultiTargetLookupField

  • メッセージ: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • 原因:複数ターゲット検索フィールドのターゲット エンティティとして不正なエンティティ名が指定されています。

  • 推奨事項: 複数ターゲット検索フィールドの有効なエンティティ名を指定します。

エラー コード:DynamicsInvalidTypeForMultiTargetLookupField

  • メッセージ: The provided target type is not a valid string. Field: '%fieldName;'.

  • 原因:ターゲット列の値が文字列ではありません。

  • 推奨事項: 複数ターゲット検索フィールドに有効な文字列を指定します。

エラー コード: DynamicsFailedToRequestServer

  • メッセージ: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • Cause: Dynamics サーバーが不安定であるか、アクセスできないか、ネットワークで問題が発生しています。

  • Recommendation: 詳細については、ネットワーク接続を確認するか、Dynamics サーバー ログを確認してください。 詳細については、Dynamics サポートにお問い合わせください。

エラー コード: DynamicsFailedToConnect

  • メッセージ: Failed to connect to Dynamics: %message;

  • 原因と推奨事項: このエラーはさまざまな原因により発生する可能性があります。 考えられる原因の分析および関連する推奨事項については、以下の一覧を確認してください。

    原因分析 レコメンデーション
    次の 3 つの条件がすべて該当する場合、ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled.またはUnable to Login to Dynamics CRM, message:ERROR REQUESTING Token FROM THE Authentication context - USER intervention required but not permitted by prompt behavior AADSTS50079: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multi-factor authentication to access '00000007-0000-0000-c000-000000000000'が表示されます。
  • Dynamics 365、Common Data Service、または Dynamics CRM に接続している。
  • Office365 認証を使用している。
  • テナントとユーザーは、Microsoft Entra ID で構成されています。条件付きアクセスまたは多要素認証が必要です（Dataverse ドキュメントへのこのリンクを参照）。
    • これらの状況下で、接続は 2021 年 6 月 8 日までは成功しました。 2021 年 6 月 9 日から、リージョン探索サービスの廃止により、接続が失敗し始めます (この リンクを参照)。    		 テナントとユーザーが conditional access または多要素認証のMicrosoft Entra IDで構成されている場合は、2021 年 6 月 8 日以降に認証するために "Microsoft Entra サービス プリンシパル" を使用する必要があります。 詳細な手順についてこちらのリンクを参照してください。
    エラー メッセージに Office 365 auth with OAuth failed が表示される場合は、サーバーに OAuth と互換性のない構成がある可能性があることを意味します。
  • 詳細なエラーメッセージをDynamicsサポートチームに問い合わせてください。
  • サービス プリンシパル認証を利用してください。次の記事を参照するとよいでしょう:Microsoft Entra サービス プリンシパルと証明書認証を使用して Dynamics Online の例。
    		•
    エラー メッセージに Unable to retrieve authentication parameters from the serviceUri が表示される場合は、間違ったDynamics サービス URL またはプロキシ/ファイアウォールを入力してトラフィックをインターセプトすることを意味します。
  • リンクされたサービスに正しいサービス URI が指定されていることを確認してください。
  • セルフホステッド IR を使用する場合は、ファイアウォール/プロキシがDynamics サーバーへの要求をインターセプトしていないことを確認します。
    		•
    エラー メッセージに An unsecured or incorrectly secured fault was received from the other party が表示された場合は、サーバー側から予期しない応答を取得したことを意味します。
  • Office 365認証を使用する場合は、ユーザー名とパスワードが正しいことを確認します。
  • 正しいサービス URI が入力されていることを確認してください。
  • リージョンの CRM URL ("crm" の後に数字が含まれている URL) を使用する場合は、正しいリージョン識別子を使用していることを確認してください。
  • 詳細については、Dynamics サポート チームにお問い合わせください。
    		•
    エラー メッセージに No Organizations Found が表示された場合は、組織名が間違っているか、サービス URL で誤った CRM リージョン識別子が使用されていることを意味します。
  • 正しいサービス URI が入力されていることを確認してください。
  • リージョンの CRM URL ("crm" の後に数字が含まれている URL) を使用する場合は、正しいリージョン識別子を使用していることを確認してください。
  • 詳細については、Dynamics サポート チームにお問い合わせください。
    		•
    401 UnauthorizedとMicrosoft Entra関連するエラー メッセージが表示される場合は、サービス プリンシパルに問題があることを意味します。 エラー メッセージのガイダンスに従って、サービス プリンシパルの問題を修正してください。
    他のエラーの場合、通常はサーバー側に問題があります。 XrmToolBox を使用して接続します。 エラーが解決しない場合は、Dynamics サポート チームに問い合わせてください。

エラー コード: DynamicsOperationFailed

  • メッセージ: Dynamics operation failed with error code: %code;, error message: %message;.

  • 原因: サーバー側で操作が失敗しました。

  • Recommendation: Dynamics operation failed with error code: {code} というエラー メッセージからdynamics操作のエラー コードを抽出し、詳細については記事「Web サービスのエラー コードを参照してください。 必要に応じて、Dynamics サポート チームにお問い合わせください。

エラー コード: DynamicsInvalidFetchXml

  • メッセージ: The Fetch Xml query specified is invalid.

  • 原因: フェッチ XML にエラーが存在します。

  • 推奨事項: FetchXML でエラーを修正してください。

エラー コード: DynamicsMissingKeyColumns

  • メッセージ: Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • 原因: ソース データにシンク エンティティのキー列が含まれていない。

  • 推奨事項: ソース データ内にキー列があることを確認するか、ソース列をシンク エンティティのキー列にマップします。

エラー コード: DynamicsPrimaryKeyMustBeGuid

  • メッセージ: The primary key attribute '%attribute;' must be of type guid.

  • 原因: 主キー列の型が 'Guid' ではありません。

  • 推奨事項: ソース データの主キー列が 'Guid' 型であることを確認してください。

エラー コード: DynamicsAlternateKeyNotFound

  • メッセージ: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • 原因: 指定された代替キーが存在しません。これは、キー名が間違っているか、アクセス許可が不十分であることが原因である可能性があります。

  • 推奨事項:

    • キー名の入力ミスを修正します。
    • エンティティに対する十分なアクセス許可があることを確認します。

エラー コード: DynamicsInvalidSchemaDefinition

  • メッセージ: The valid structure information (column name and type) are required for Dynamics source.

  • 原因: 列マッピングのシンク列に 'type' プロパティがありません。

  • 推奨事項: ポータルの JSON エディターを使用して、列マッピングのこれらの列に 'type' プロパティを追加できます。

エラー コード: UserErrorUnsupportedAttributeType

  • メッセージ: The attribute type 'Lookup' of field %attributeName; is not supported

  • Cause: Dynamicsにデータを読み込む際、Azure Data Factoryはルックアップ属性のメタデータに検証を適用します。 ただし、特定のDynamics エンティティに、ターゲットの一覧を保持する有効な参照属性メタデータがないという既知の問題があり、検証に失敗します。

  • Recommendation: 問題を軽減するには、Dynamics サポート チームにお問い合わせください。

Dynamics 365からのコピー アクティビティは、実際の数よりも多くの行を読み取ります

  • Symptoms: Dynamics 365からのコピー アクティビティは、実際の数よりも多くの行を読み取ります。

  • Cause: Dynamics 365 サーバーは常により多くの使用可能なレコードを示します。

  • 推奨事項: XrmToolBox を使用して、ページングを使用した FetchXML をテストします。 XrmToolBox と一部のインストールされているツールでレコード数を取得できます。 詳細については、XrmToolBox を参照してください。

コピー アクティビティのDynamicsソースから仮想列にアクセスできない

  • Symptoms: コピー アクティビティのDynamics ソースから仮想列にアクセスすることはできません。

  • 原因: 仮想列は現在サポートされていません。

  • 推奨事項: オプション セットの値については、次のオプションに従って取得します。

    • StringMap エンティティをターゲット エンティティにリンクし、関連付けられている値を取得できます。

Dynamics CRM データ ストア内の並列コピー

  • Symptoms: Dynamics CRM データ ストアで並列コピーを構成できるかどうかを把握できず、[コピーの並列処理の次数] セクションで設定できる値の範囲もわかりません。

  • 推奨事項: 並列コピーは並列処理を制御し、[Degree of copy parallelism](コピーの並列度) セクションは 0 以外の値に設定できます。 数値が大きいと Dynamics サーバー側でスロットリングが発生し、スループットが低下する場合がありましたが、現在は公開 SDK を使用してスロットリングが処理されます。

    コピー並列化の度合いの図。

Dynamics 型の変換

  • Symptoms: GUID を Dynamics ソース内の文字列に変換しようとすると、エラーが発生します。

  • Cause: ソースとしてDynamicsを使用する場合、型変換はサポートされていません。

  • 推奨事項: ステージングを有効にして再試行します。

関連するコンテンツ

トラブルシューティングのその他のヘルプについては、次のリソースを参照してください。

  • Last updated on