Résoudre les problèmes liés aux connecteurs Dynamics 365, Dataverse (Common Data Service) et Dynamics CRM dans Azure Data Factory et Azure Synapse

S'APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Cet article fournit des suggestions pour résoudre les problèmes courants liés aux connecteurs Dynamics 365, Dataverse (Common Data Service) et Dynamics CRM dans Azure Data Factory et Azure Synapse.

Code d’erreur : DynamicsCreateServiceClientError

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

• Cause : le problème est un problème temporaire côté serveur Dynamics.

• Recommandation : Réexécutez le pipeline. Si l’échec persiste, essayez de réduire le parallélisme. Si le problème persiste, contactez Dynamics support technique.

Colonnes manquantes lorsque vous importez un schéma ou prévisualisez des données

• Symptômes : Certaines colonnes sont manquantes lorsque vous importez un schéma ou prévisualisez des données. Message d’erreur : The valid structure information (column name and type) are required for Dynamics source.

• Cause : Ce problème est lié à la conception, car Data Factory et les pipelines Synapse ne peuvent pas afficher les colonnes qui ne contiennent pas de valeurs dans les 10 premiers enregistrements. Assurez-vous que les colonnes que vous avez ajoutées sont au format correct.

• Recommandation : ajoutez manuellement les colonnes dans l’onglet mappage. Pour plus d’informations, consultez Mappage explicite.

Code d’erreur : DynamicsMissingTargetForMultiTargetLookupField

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

• Cause : La colonne cible n’existe pas dans la source ou dans le mappage de colonnes.

• Recommandation :

  1. Assurez-vous que la source contient la colonne cible.
  2. Ajoutez la colonne cible dans le mappage de colonnes. Assurez-vous que la colonne du récepteur est au format {fieldName}@EntityReference.

Code d’erreur : DynamicsInvalidTargetForMultiTargetLookupField

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

• Cause : Un nom d’entité incorrect est fourni en tant qu’entité cible d’un champ de recherche à plusieurs cibles.

• Recommandation : Fournissez un nom d’entité valide pour le champ de recherche à plusieurs cibles.

Code d’erreur : DynamicsInvalidTypeForMultiTargetLookupField

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

• Cause : La valeur dans la colonne cible n’est pas une chaîne.

• Recommandation : Fournissez une chaîne valide dans la colonne cible de recherche multi-cibles.

Code d’erreur : DynamicsFailedToRequestServer

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

• Cause : le serveur Dynamics est instable ou inaccessible, ou le réseau rencontre des problèmes.

• Recommendation : pour plus d’informations, vérifiez la connectivité réseau ou vérifiez le journal du serveur Dynamics. Pour obtenir de l’aide supplémentaire, contactez Dynamics support technique.

Code d’erreur : DynamicsFailedToConnect

• Message : Failed to connect to Dynamics: %message;

• Causes et recommandations : Différentes causes peuvent être à l’origine de cette erreur. Consultez la liste ci-dessous pour obtenir une analyse des causes possibles et des recommandations associées.

  Analyse de la cause	Recommandation
  Vous voyez ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. ou sinon 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'. Si votre cas d'usage répond à toutes les trois conditions suivantes : Vous vous connectez à Dynamics 365, Common Data Service ou Dynamics CRM. Vous utilisez l’authentification Office365. Votre locataire et votre utilisateur sont configurés dans Microsoft Entra ID pour l’accès conditionnel et/ou Multifactor Authentication est requis (voir ce lien vers la documentation de Dataverse). Dans ces circonstances, la connexion aboutissait avant le 08/06/2021. À compter du 9/06/2021, la connexion commencera à échouer en raison du décommissionnement du service de découverte régional (voir ce lien).	Si votre locataire et votre utilisateur sont configurés dans Microsoft Entra ID pour l'accès conditionnel et/ou l'authentification multifacteur est nécessaire, vous devez utiliser 'Microsoft Entra service principal' pour vous authentifier après le 8/6/2021. Pour obtenir des instructions détaillées, référez-vous à ce lien.
  Si vous voyez Office 365 auth with OAuth failed dans le message d’erreur, cela signifie que votre serveur peut avoir certaines configurations non compatibles avec OAuth.	Contactez Dynamics équipe de support technique avec le message d’erreur détaillé pour obtenir de l’aide. Utilisez l’authentification du principal de service et vous pouvez consulter cet article : Example : Dynamics en ligne à l’aide du principal de service Microsoft Entra et de l’authentification par certificat.
  Si vous voyez Unable to retrieve authentication parameters from the serviceUri dans le message d'erreur, cela signifie que vous avez saisi l'URL incorrecte du service Dynamics ou que le proxy ou pare-feu bloque le trafic.	Assurez-vous que vous avez placé l’URI de service correct dans le service lié. Si vous utilisez le runtime d’intégration auto-hébergé, assurez-vous que le pare-feu/proxy n’intercepte pas les demandes adressées au serveur Dynamics.
  Si vous voyez An unsecured or incorrectly secured fault was received from the other party dans le message d’erreur, cela signifie que des réponses inattendues ont été obtenues du côté serveur.	Vérifiez que votre nom d’utilisateur et votre mot de passe sont corrects si vous utilisez l’authentification Office 365. Vérifiez que vous avez entré le bon URI de service. Si vous utilisez l’URL CRM régionale (l’URL comporte un chiffre après « crm »), veillez à utiliser le bon identifiant régional. Contactez l’équipe du support technique Dynamics pour obtenir de l’aide.
  Si vous voyez No Organizations Found dans le message d’erreur, cela signifie que le nom de votre organisation est incorrect ou que vous avez utilisé un identificateur de région CRM erroné dans l’URL du service.	Vérifiez que vous avez entré le bon URI de service. Si vous utilisez l’URL CRM régionale (l’URL comporte un chiffre après « crm »), veillez à utiliser le bon identifiant régional. Contactez l’équipe du support technique Dynamics pour obtenir de l’aide.
  Si vous voyez 401 Unauthorized et un message d'erreur associé à Microsoft Entra, cela signifie qu'il existe un problème avec l'objet principal de service.	Suivez les instructions du message d’erreur pour corriger le problème du principal de service.
  Pour les autres erreurs, le problème se trouve généralement côté serveur.	Utilisez XrmToolBox pour établir la connexion. Si l’erreur persiste, contactez l’équipe du support technique Dynamics pour obtenir de l’aide.

Code d’erreur : DynamicsOperationFailed

• Message : Dynamics operation failed with error code: %code;, error message: %message;.

• Cause : L’opération a échoué côté serveur.

• Recommandation: extrayez le code d’erreur de l’opération Dynamics à partir du message d’erreur : Dynamics operation failed with error code: {code}, puis reportez-vous à l’article Codes d’erreur du service Web pour obtenir plus d’informations. Vous pouvez contacter l’équipe du support technique Dynamics si nécessaire.

Code d’erreur : DynamicsInvalidFetchXml

• Message : The Fetch Xml query specified is invalid.

• Cause : une erreur existe dans le code XML d’extraction.

• Recommandation : Corrigez l’erreur dans le fichier XML récupéré (fetch).

Code d’erreur : DynamicsMissingKeyColumns

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

• Cause : les données sources ne contiennent pas la colonne clé de l’entité cible.

• Recommandation : Confirmez que les colonnes clés se trouvent dans les données sources ou mappez une colonne source à la colonne clé de l’entité récepteur.

Code d’erreur : DynamicsPrimaryKeyMustBeGuid

• Message : The primary key attribute '%attribute;' must be of type guid.

• Cause : le type de la colonne de clé primaire n’est pas « GUID ».

• Recommandation : Assurez-vous que la colonne de clé primaire dans les données sources est de type « GUID ».

Code d’erreur : DynamicsAlternateKeyNotFound

• Message : Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

• Cause : la clé alternative fournie n’existe pas, ce qui peut être dû à des noms de clés incorrects ou à des autorisations insuffisantes.

• Recommandation :
  

  • Corrigez les fautes de frappe dans le nom de la clé.
    
  • Assurez-vous que vous disposez des autorisations suffisantes sur l’entité.

Code d’erreur : DynamicsInvalidSchemaDefinition

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

• Cause : Les colonnes de récepteur dans le mappage de colonne n’ont pas la propriété « type ».

• Recommandation : Vous pouvez ajouter la propriété « type »à ces colonnes dans le mappage de colonnes à l’aide de l’éditeur JSON sur le portail.

Code d’erreur : UserErrorUnsupportedAttributeType

• Message : The attribute type 'Lookup' of field %attributeName; is not supported

• Cause : lors du chargement de données sur le récepteur Dynamics, Azure Data Factory impose une validation sur les métadonnées de l’attribut de recherche. Toutefois, il existe le problème connu de certaines entités Dynamics qui n'ont pas de métadonnées d'attribut de recherche valides qui contiennent une liste de cibles, ce qui échouerait la validation.

• Recommendation : contactez l’équipe du support technique Dynamics pour atténuer le problème.

L’activité de copie du Dynamics 365 lit plus de lignes que le nombre réel

• Symptoms : l’activité de copie du Dynamics 365 lit plus de lignes que le nombre réel.

• Cause : le serveur Dynamics 365 indique toujours plus d’enregistrements disponibles.

• Recommandation : utilisez XrmToolBox pour tester le FetchXML avec la pagination. XrmToolBox avec certains outils installés peut obtenir le nombre d’enregistrements. Pour plus d'informations, consultez XrmToolBox.

Impossible d’accéder aux colonnes virtuelles à partir de sources Dynamics dans l’activité de copie

• Symptoms : vous ne pouvez pas accéder aux colonnes virtuelles à partir de sources Dynamics dans l’activité de copie.

• Cause : la colonne virtuelle n’est pas prise en charge pour le moment.

• Recommandation : pour la valeur Groupe d’options, suivez les options ci-dessous pour l’obtenir :

  • Vous pouvez lier l’entité StringMap à votre entité cible et obtenir les valeurs associées.

La copie parallèle dans un magasin de données Dynamics CRM

• Symptoms : vous ne savez pas s'il est possible de configurer la copie parallèle dans un magasin de données CRM Dynamics et que vous ne connaissez pas également la plage de valeurs qui peuvent être définies dans la section « Degré de parallélisme de copie ».

• Recommandation : la copie parallèle contrôle le parallélisme et la section « Degré de parallélisme de la copie » peut être définie sur une valeur différente de zéro. Un grand nombre peut entraîner une limitation du côté du serveur Dynamics, ce qui peut réduire le débit, mais la limitation est maintenant gérée avec le kit de développement logiciel (SDK) public.

  

conversion de type Dynamics

• Symptoms : vous essayez de convertir le GUID en chaîne dans la source Dynamics, mais vous rencontrez une erreur.

• Cause : quand Dynamics est utilisé comme source, la conversion de type n’est pas prise en charge.

• Recommandation : activez la mise en scène et réessayez.

Contenu connexe

Si vous avez besoin d’une aide supplémentaire, essayez les ressources suivantes :

• Guide de résolution des problèmes de connecteur
• Blog de Data Factory
• Demandes de fonctionnalités Data Factory
• Vidéos Azure
• Page Microsoft Questions et Réponses
• Forum Stack Overflow pour Data Factory
• Informations de X sur Data Factory