Řešení potíží s konektory Dynamics 365, Dataverse (Common Data Service) a Dynamics CRM ve službě Azure Data Factory a Azure Synapse

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek obsahuje návrhy pro řešení běžných problémů s konektory Dynamics 365, Dataverse (Common Data Service) a Dynamics CRM ve službě Azure Data Factory a Azure Synapse.

Kód chyby: DynamicsCreateServiceClientError

  • Zpráva: This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • Příčina: Problém je přechodný problém na straně serveru Dynamics.

  • Doporučení: Znovu spusťte kanál. Pokud selže znovu, zkuste snížit paralelismus. Pokud potíže potrvají, obraťte se na podporu Dynamics.

Chybějící sloupce při importu schématu nebo náhledu dat

  • Příznaky: Při importu schématu nebo náhledu dat chybí některé sloupce. Chybová zpráva: The valid structure information (column name and type) are required for Dynamics source.

  • Příčina: Tento problém je záměrně, protože kanály Data Factory a Synapse nemůžou zobrazit sloupce, které v prvních 10 záznamech neobsahují žádné hodnoty. Ujistěte se, že přidané sloupce jsou ve správném formátu.

  • Doporučení: Ručně přidejte sloupce na kartě mapování. Další podrobnosti najdete v tématu Explicitní mapování.

Kód chyby: DynamicsMissingTargetForMultiTargetLookupField

  • Zpráva: Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • Příčina: Cílový sloupec ve zdroji nebo v mapování sloupců neexistuje.

  • Doporučení:

    1. Ujistěte se, že zdroj obsahuje cílový sloupec.
    2. Přidejte cílový sloupec do mapování sloupců. Ujistěte se, že je sloupec jímky ve formátu {fieldName}@EntityReference.

Kód chyby: DynamicsInvalidTargetForMultiTargetLookupField

  • Zpráva: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • Příčina: Jako cílovou entitu vyhledávacího pole s více cíli je zadaný nesprávný název entity.

  • Doporučení: Zadejte platný název entity pro vyhledávací pole s více cíli.

Kód chyby: DynamicsInvalidTypeForMultiTargetLookupField

  • Zpráva: The provided target type is not a valid string. Field: '%fieldName;'.

  • Příčina: Hodnota v cílovém sloupci není řetězec.

  • Doporučení: Zadejte platný řetězec ve sloupci cíle vyhledávání s více cíli.

Kód chyby: DynamicsFailedToRequetServer

  • Zpráva: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • Příčina: Server Dynamics je nepřístupný nebo je nepřístupný nebo dochází k problémům se sítí.

  • Doporučení: Další podrobnosti najdete v síťovém připojení nebo v protokolu serveru Dynamics. Pokud potřebujete další pomoc, obraťte se na podporu Dynamics.

Kód chyby: DynamicsFailedTo Připojení

  • Zpráva: Failed to connect to Dynamics: %message;

  • Příčiny a doporučení: K této chybě můžou vést různé příčiny. Projděte si následující seznam možných analýz příčin a souvisejících doporučení.

    Analýza příčin Doporučení
    Vidíte ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. nebo jinak 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' Pokud váš případ použití splňuje všechny následující tři podmínky:
  • Připojujete se k Dynamics 365, Common Data Service nebo Dynamics CRM.
  • Používáte ověřování Office365.
  • Váš tenant a uživatel je nakonfigurovaný v Microsoft Entra ID pro podmíněný přístup nebo vícefaktorové ověřování (viz tento odkaz na dokumentaci k Dataverse).
  • Za těchto okolností bylo připojení použito k úspěchu před 8. 6. 2021. Od 9. 6. 2021 dojde k selhání připojení kvůli vyřazení regionální služby zjišťování (viz tento odkaz).
    Pokud je váš tenant a uživatel nakonfigurovaný v Microsoft Entra ID pro podmíněný přístup nebo multi-Factor Authentication, musíte k ověření použít instanční objekt Microsoft Entra po 8. 6. 2021. Podrobný postup najdete na tomto odkazu .
    Pokud se v chybové zprávě zobrazí Office 365 auth with OAuth failed , znamená to, že váš server může mít některé konfigurace, které nejsou kompatibilní s OAuth.
  • Požádejte o pomoc tým podpory Dynamics s podrobnou chybovou zprávou.
  • Použijte ověřování instančního objektu a můžete se podívat na tento článek: Příklad: Dynamics online pomocí instančního objektu Microsoft Entra a ověřování certifikátů.
  • Pokud se v chybové zprávě zobrazí Unable to retrieve authentication parameters from the serviceUri , znamená to, že buď zadáte nesprávnou adresu URL služby Dynamics, nebo proxy server nebo bránu firewall, aby se provoz zachytil.
  • Ujistěte se, že jste do propojené služby umístili správný identifikátor URI služby.
  • Pokud používáte místní prostředí IR, ujistěte se, že brána firewall nebo proxy server nezachytí požadavky na server Dynamics.
  • Pokud se v chybové zprávě zobrazí An unsecured or incorrectly secured fault was received from the other party , znamená to, že se ze strany serveru dostaly neočekávané odpovědi.
  • Pokud používáte ověřování Office 365, ujistěte se, že je vaše uživatelské jméno a heslo správné.
  • Ujistěte se, že jste zadali správný identifikátor URI služby.
  • Pokud používáte místní adresu URL CRM (adresa URL obsahuje číslo za "crm"), ujistěte se, že používáte správný místní identifikátor.
  • Požádejte o pomoc tým podpory Dynamics.
  • Pokud se v chybové zprávě zobrazí No Organizations Found , znamená to, že název vaší organizace je nesprávný nebo jste v adrese URL služby použili nesprávný identifikátor oblasti CRM.
  • Ujistěte se, že jste zadali správný identifikátor URI služby.
  • Pokud používáte místní adresu URL CRM (adresa URL má číslo za "crm"), ujistěte se, že používáte správný místní identifikátor.
  • Požádejte o pomoc tým podpory Dynamics.
  • Pokud se zobrazí 401 Unauthorized chybová zpráva související s Microsoft Entra, znamená to, že došlo k problému s instančním objektem. Při řešení problému s instančním objektem postupujte podle pokynů v chybové zprávě.
    V případě jiných chyb obvykle dochází k problému na straně serveru. K vytvoření připojení použijte XrmToolBox . Pokud chyba přetrvává, požádejte o pomoc tým podpory Dynamics.

Kód chyby: DynamicsOperationFailed

  • Zpráva: Dynamics operation failed with error code: %code;, error message: %message;.

  • Příčina: Operace se nezdařila na straně serveru.

  • Doporučení: Extrahujte kód chyby operace dynamics z chybové zprávy: Dynamics operation failed with error code: {code}a podrobnější informace najdete v článku Kódy chyb webové služby. V případě potřeby se můžete obrátit na tým podpory Dynamics.

Kód chyby: DynamicsInvalidFetchXml

  • Zpráva: The Fetch Xml query specified is invalid.

  • Příčina: V fetch XML existovala chyba.

  • Doporučení: Opravte chybu v souboru XML pro načtení.

Kód chyby: DynamicsMissingKeyColumns

  • Zpráva: Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • Příčina: Zdrojová data neobsahují klíčový sloupec entity jímky.

  • Doporučení: Ověřte, že klíčové sloupce jsou ve zdrojových datech, nebo namapujte zdrojový sloupec na klíčový sloupec v entitě jímky.

Kód chyby: DynamicsPrimaryKeyMustBeGuid

  • Zpráva: The primary key attribute '%attribute;' must be of type guid.

  • Příčina: Typ sloupce primárního klíče není guid.

  • Doporučení: Ujistěte se, že sloupec primárního klíče ve zdrojových datech má typ Guid.

Kód chyby: DynamicsAlternateKeyNotFound

  • Zpráva: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • Příčina: Zadaný alternativní klíč neexistuje, což může být způsobeno nesprávnými názvy klíčů nebo nedostatečnými oprávněními.

  • Doporučení:

    • Opravte překlepy v názvu klíče.
    • Ujistěte se, že máte dostatečná oprávnění k entitě.

Kód chyby: DynamicsInvalidSchemaDefinition

  • Zpráva: The valid structure information (column name and type) are required for Dynamics source.

  • Příčina: Sloupce jímky v mapování sloupců chybí vlastnost Type.

  • Doporučení: Vlastnost Type můžete do těchto sloupců v mapování sloupců přidat pomocí editoru JSON na portálu.

Kód chyby: UserErrorUnsupportedAttributeType

  • Zpráva: The attribute type 'Lookup' of field %attributeName; is not supported

  • Příčina: Při načítání dat do jímky Dynamics azure Data Factory ukládá ověřování metadat vyhledávacího atributu. Existuje však známý problém některých entit Dynamics, které nemají platná metadata atributu vyhledávání, která obsahuje seznam cílů, což by selhalo ověření.

  • Doporučení: Pokud chcete tento problém zmírnit, obraťte se na tým podpory Dynamics.

Aktivita kopírování z Dynamics 365 čte více řádků než skutečné číslo.

  • Příznaky: Aktivita kopírování z Dynamics 365 čte více řádků než skutečné číslo.

  • Příčina: Server Dynamics 365 vždy označuje více dostupných záznamů.

  • Doporučení: Použijte XrmToolBox k otestování FetchXML se stránkováním. XrmToolBox s některými nainstalovanými nástroji může získat počet záznamů. Další informace naleznete v tématu XrmToolBox.

Nejde získat přístup k virtuálním sloupcům ze zdrojů Dynamics v aktivitě kopírování

  • Příznaky: V aktivitě kopírování nelze získat přístup k virtuálním sloupcům ze zdrojů Dynamics.

  • Příčina: Virtuální sloupec se teď nepodporuje.

  • Doporučení: Pokud chcete získat hodnotu sady možností, postupujte podle následujících možností:

Paralelní kopírování v úložišti dat Dynamics CRM

  • Příznaky: Nevíte, jestli je možné nakonfigurovat paralelní kopírování v úložišti dat Dynamics CRM a také neznáte rozsah hodnot, které lze nastavit v části Stupeň kopírování paralelismu.

  • Doporučení: Paralelní kopírování řídí paralelismus a část Stupeň paralelismu kopírování je možné nastavit na nenulovou hodnotu. Velké číslo může způsobit omezování na straně serveru Dynamics, což může snížit propustnost, ale teď se omezování zpracovává převzetím veřejné sady SDK.

    Diagram of Degree of copy parallelism section.

Převod typu Dynamics

  • Příznaky: Pokusíte se převést identifikátor GUID na řetězec ve zdroji Dynamics, ale dojde k chybě.

  • Příčina: Pokud se Dynamics používá jako zdroj, převod typu se nepodporuje.

  • Doporučení: Povolte přípravnou přípravu a zkuste to znovu.

Další nápovědu k řešení potíží najdete v těchto zdrojích informací: