次の方法で共有

Azure Data Factory と Azure Synapse で Dynamics 365、Dataverse (Common Data Service)、Dynamics CRM のコネクタの問題を解決します。

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

この記事では、Azure Data Factory と Azure Synapse で Dynamics 365、Dataverse (Common Data Service)、Dynamics CRM のコネクタの一般的な問題を解決する方法について提案します。

エラー コード:DynamicsCreateServiceClientError

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

  • 原因:この問題は、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.

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

  • 推奨事項: 詳細については、ネットワーク接続または Dynamics サーバーのログを確認してください。 さらに支援が必要な場合は、Dynamics サポートにお問い合わせください。

エラー コード: DynamicsFailedToConnect

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

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

    原因分析 レコメンデーション
    ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. が表示されます。あるいはユースケースが次の 3 つの条件のすべてに一致する場合は 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 日から、リージョンの Discovery Service の廃止に伴い、接続が失敗し始めます (このリンクを参照)。    		 テナントとユーザーが 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;.

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

  • 推奨事項: エラー メッセージ (Dynamics operation failed with error code: {code}) から Dynamics 操作のエラー コードを抽出し、「Web サービス エラー コード」で詳細を参照してください。 必要に応じて、Dynamics サポート チームに問い合わせることができます。

エラー コード: DynamicsInvalidFetchXml

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

  • 原因: FetchXML にエラーが存在します。

  • 推奨事項: 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

  • 原因: Dynamics シンクにデータを読み込む場合、Azure Data Factory では検索属性のメタデータに対する検証が課されます。 ただし、特定の Dynamics エンティティに、ターゲットの一覧を保持する有効な検索属性メタデータがないため、検証が失敗するという既知の問題があります。

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

Dynamics 365 の Copy アクティビティで、実際の数よりも多くの行が読み込まれる

  • 現象: Dynamics 365 の Copy アクティビティで、実際の数よりも多くの行が読み込まれます。

  • 原因: Dynamics 365 サーバーでは、利用可能なレコード数が常に多く表示されます。

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

Copy アクティビティで Dynamics ソースの仮想列にアクセスできない

  • 現象: Copy アクティビティで Dynamics ソースの仮想列にアクセスできません。

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

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

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

  • 現象: Dynamics CRM のデータ ストアで並列コピーを設定できるかどうか、または、[Degree of copy parallelism](コピーの並列度) に設定できる値の範囲がわかりません。

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

    コピーの並列度セクションの図。

Dynamics 型の変換

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

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

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

関連するコンテンツ

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