Azure Data Factory 및 Azure Synapse Dynamics 365, Dataverse(Common Data Service) 및 Dynamics CRM 커넥터 문제 해결

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

Microsoft Fabric의 데이터 팩토리는 더 간단한 아키텍처, 기본 제공 AI 및 새로운 기능을 갖춘 차세대 Azure 데이터 팩토리입니다. 데이터 통합을 접하는 경우 Fabric Data Factory부터 시작합니다. 기존 ADF 워크로드는 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.

  • 원인: Data Factory 및 Synapse 파이프라인은 처음 10개의 레코드에 값이 없는 열을 표시할 수 없습니다. 따라서 이 문제는 의도적으로 발생하는 문제입니다. 추가한 열이 올바른 형식인지 확인하세요.

  • 권장 사항: 매핑 탭에 열을 수동으로 추가합니다. 자세한 내용은 명시적 매핑을 참조 하세요.

오류 코드: 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 서버가 불안정하거나 접근할 수 없거나, 네트워크에 문제가 발생하고 있습니다.

  • 추천: 자세한 내용은 네트워크 연결을 확인하거나 Dynamics 서버 로그를 확인해보십시오. 추가 도움말은 Dynamics 지원에 문의하세요.

오류 코드: DynamicsFailedToConnect

  • 메시지: Failed to connect to Dynamics: %message;

  • 원인 및 권장 사항: 오류의 원인이 여러 가지일 수 있습니다. 아래 목록에서 가능한 원인 분석과 권장 사항을 확인하세요.

    원인 분석 권장
    사용 사례가 다음 세 가지 조건을 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일부터 지역 검색 서비스의 사용 중단으로 인해 연결이 실패하기 시작합니다(이 링크 참조).    		 테넌트 및 사용자가 무조건 액세스 및/또는 다단계 인증을 위해 Microsoft Entra ID 구성된 경우 2021년 6월 8일 이후에 'Microsoft Entra 서비스 주체'를 사용하여 인증해야 합니다. 자세한 단계는 이 링를를 참조하세요.
    오류 메시지에 Office 365 auth with OAuth failed 표시되는 경우 서버에 OAuth와 호환되지 않는 일부 구성이 있을 수 있습니다.
  • 자세한 오류 메시지와 함께 Dynamics 지원 팀에 문의하세요.
  • 서비스 주체 인증을 사용하고자 할 경우, 다음 문서를 참조하십시오: 예시: Microsoft Entra 서비스 주체 및 인증서 인증을 사용한 Dynamics 온라인.
    		•
    오류 메시지에 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 작업의 오류 코드를 추출하고, 보다 자세한 내용은 Dynamics operation failed with error code: {code} 문서를 참조하세요. 필요한 경우 Dynamics 지원 팀에 문의할 수 있습니다.

오류 코드: DynamicsInvalidFetchXml

  • 메시지: The Fetch Xml query specified is invalid.

  • 원인: 페치 XML에 오류가 있습니다.

  • 권장 사항: 페치 XML에서 오류를 수정합니다.

오류 코드: 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 복사 작업은 실제 숫자보다 더 많은 행을 읽습니다.

  • Symptoms: Dynamics 365 복사 작업은 실제 숫자보다 더 많은 행을 읽습니다.

  • 원인: Dynamics 365 서버는 항상 더 많은 추가적인 레코드를 나타냅니다.

  • 권장 사항: XrmToolBox를 사용하여 페이징으로 FetchXML을 테스트합니다. 일부 도구가 설치된 XrmToolBox는 레코드 수를 가져올 수 있습니다. 자세한 내용은 XrmToolBox를 참조하세요.

복사 작업의 Dynamics 원본에서 가상 열에 액세스할 수 없음

  • Symptoms: 복사 작업의 Dynamics 원본에서 가상 열에 액세스할 수 없습니다.

  • 원인: 가상 열은 현재 지원되지 않습니다.

  • 권장 사항: 옵션 집합 값의 경우 아래 옵션에 따라 가져옵니다:

    • StringMap 엔터티를 대상 엔터티에 연결하고 연결된 값을 가져올 수 있습니다.

Dynamics CRM 데이터 저장소의 병렬 복사

  • Symptoms: Dynamics CRM 데이터 저장소에서 병렬 복사를 구성할 수 있는지 여부를 알 수 없으며 "복사 병렬 처리 수준" 섹션에서 설정할 수 있는 값 범위도 모릅니다.

  • 권장 사항: 병렬 복사는 병렬 처리를 제어하며 "복사 병렬 처리 정도" 섹션은 0이 아닌 값으로 설정할 수 있습니다. 숫자가 크면 동적 서버 쪽에서 제한이 발생하여 처리량이 줄어들 수 있지만 이제는 공용 SDK를 사용하여 제한이 처리됩니다.

    복사 병렬 처리 정도 섹션의 다이어그램.

다이내믹스 형식 변환

  • 증상: GUID를 Dynamics 원본의 문자열로 변환하려고 하지만 오류가 발생합니다.

  • Cause: Dynamics 원본으로 사용되는 경우 형식 변환이 지원되지 않습니다.

  • 권장 사항: 스테이징을 사용하도록 설정하고 다시 시도합니다.

관련 콘텐츠

자세한 문제 해결 도움말은 다음 리소스를 참조하세요.

  • Last updated on