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.

• 원인: 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;'.

• 원인: 대상 열의 값이 문자열이 아닙니다.

• 권장 사항: 다중 대상 조회 대상 열에 유효한 문자열을 지정합니다.

오류 코드: DynamicsFailedToRequetServer

• 메시지: 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. 또는 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 인증을 사용하고 있습니다. 테넌트와 사용자는 조건부 액세스 및/또는 Multi-Factor Authentication이 필요하도록 Microsoft Entra ID에 구성되어 있습니다(Dataverse 문서에 대한 이 링크 참조). 이러한 상황에서는 연결이 2021년 6월 8일 이전에 성공했습니다. 2021년 6월 9일부터 지역 검색 서비스의 사용 중단으로 인해 연결이 실패하기 시작합니다(이 링크참조).	테넌트와 사용자가 조건부 액세스를 위해 Microsoft Entra ID에 구성되어 있거나 Multi-Factor Authentication이 필요한 경우 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 operation failed with error code: {code}에서 Dynamics 작업의 오류 코드를 확인하고 웹 서비스 오류 코드 문서에서 자세한 정보를 참조합니다. 필요한 경우 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의 복사 작업은 실제 수보다 더 많은 행을 읽습니다.

• 증상: Dynamics 365의 복사 작업이 실제 수보다 더 많은 행을 읽습니다.

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

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

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

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

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

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

  • 모든 항목에 대한 개체 형식 코드를 찾는 방법을 참조하여 개체 형식 코드를 얻을 수 있습니다.
  • StringMap 엔터티를 대상 엔터티에 연결하고 연결된 값을 가져올 수 있습니다.

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

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

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

  

Dynamics 형식 변환

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

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

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

관련 콘텐츠

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

• 커넥터 문제 해결 가이드
• Data Factory 블로그
• Data Factory 기능 요청
• Azure 비디오
• Microsoft Q&A 페이지
• Data Factory에 대한 스택 오버플로 포럼
• Data Factory에 대한 X 정보