Résoudre les problèmes des connecteurs Azure Data Factory et Azure Synapse Analytics

2025-04-30

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analytique en un seul pour les entreprises. Microsoft Fabric couvre tout, du déplacement des données à la science des données, à l’analytique en temps réel, au décisionnel et aux rapports. Découvrez comment démarrer une nouvelle version d’évaluation gratuitement !

Cet article explique comment résoudre les problèmes liés aux connecteurs dans Azure Data Factory et Azure Synapse Analytics. Si vous ne voyez pas votre message d’erreur spécifique répertorié ici, vous pouvez suivre ces étapes :

Vérifiez le message d’erreur complet. Certains messages d’erreur fournissent des conseils pour résoudre le problème.
Pour plus d’informations, consultez la page de résolution des problèmes de votre connecteur .
Ouvrez un ticket avec support pour résoudre le problème.

Problèmes spécifiques au connecteur

Vous pouvez consulter les pages de résolution des problèmes pour chaque connecteur afin de voir les problèmes qui lui sont spécifiques avec les explications de leurs causes et des recommandations pour les résoudre.

Erreurs générales de l’activité Copy

Les erreurs ci-dessous sont générales à l’activité Copy et peuvent se produire avec n’importe quel connecteur.

Code d’erreur : 2200 – UserErrorOdbcOperationFailed

Message : The underlying connection was closed: An unexpected error occurred on a send.
Cause : cela indique généralement un échec d’authentification lors des opérations de transfert de données. Elle peut se produire quand un tiers distant ferme la diffusion en continu du flux de transport.
Recommandation :
- Vérifiez la connexion source et testez-la pour veiller à ce qu’elle fonctionne correctement.
- Vérifiez la méthode d’authentification utilisée pour la connexion.
- Passez en revue les paramètres de configuration du pare-feu pour Azure Cosmos DB afin de vérifier qu’ils autorisent le trafic nécessaire.

Code d’erreur : 20000 – JreNotFound

Message : Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.
Cause : l’IR auto-hébergé ne trouve pas le runtime Java. Le runtime Java est requis pour la lecture de sources spécifiques.
Recommandation : Vérifiez votre environnement d’exécution d’intégration, consultez Utiliser le runtime d’intégration auto-hébergé.

Code d’erreur : 20002 – JniException

Message : An error occurred when invoking Java Native Interface.
Cause : Si le message d’erreur contient « Impossible de créer JVM : code de retour JNI [-6][Échec de l’appel JNI : arguments non valides.] », la cause possible est que JVM ne peut pas être créée, car certains arguments (globaux) non valides sont définis.
Recommandation : Connectez-vous à l’ordinateur qui héberge chaque nœud de votre runtime d’intégration auto-hébergé. Vérifiez que la variable système est définie correctement, comme suit : _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Redémarrez tous les nœuds de l’IR, puis réexécutez le pipeline.

Code d’erreur : 20020 – WildcardPathSinkNotSupported

Message : Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Cause : le jeu de données de récepteur ne prend pas en charge les valeurs de caractères génériques.
Recommandation : vérifiez le jeu de données de récepteur et corrigez le chemin d’accès sans la valeur de caractère générique.

Problème FIPS

Symptômes : L’activité de copie échoue sur une machine ir auto-hébergée compatible FIPS avec le message d’erreur suivant : This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Cause : cette erreur peut se produire lorsque vous copiez des données avec des connecteurs tels qu’Azure Blob, SFTP, etc. FIPS (Federal Information Processing Standards) définit un certain ensemble d’algorithmes de chiffrement qui peuvent être utilisés. Lorsque le mode FIPS est activé sur l’ordinateur, certaines classes de chiffrement dont dépend l’activité de copie sont bloquées dans certains scénarios.
Résolution : découvrez pourquoi nous vous déconseillons de recommander le « mode FIPS » et d’évaluer si vous pouvez désactiver FIPS sur votre ordinateur IR auto-hébergé.

Par ailleurs, si vous souhaitez simplement contourner FIPS et faire en sorte que l’exécution de l’activité aboutisse, procédez comme suit :
1. Ouvrez le dossier dans lequel le runtime d’intégration auto-hébergé est installé. Le chemin d’accès est généralement C :\Program Files\Microsoft Integration Runtime <IR version>\Shared.
2. Ouvrez le fichier diawp.exe.config , puis, à la fin de la <runtime> section, ajoutez <enforceFIPSPolicy enabled="false"/>, comme indiqué ici :
3. Enregistrez le fichier, puis redémarrez la machine du runtime d’intégration auto-hébergé.

Code d’erreur : 20150 – GetOAuth2AccessTokenErrorResponse

Message : Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Cause : votre ID client ou secret client n’est pas valide et l’authentification a échoué dans votre serveur d’autorisation.
Recommandation : Corrigez tous les paramètres de flux d’informations d’identification du client OAuth2 de votre serveur d’autorisation.

Code d’erreur : 20151 – FailedToGetOAuth2AccessToken

Message : Failed to get access token from your token endpoint. Error message: %errorMessage;.
Cause : les paramètres de flux d’informations d’identification du client OAuth2 ne sont pas valides.
Recommandation : Corrigez tous les paramètres de flux d’informations d’identification du client OAuth2 de votre serveur d’autorisation.

Code d’erreur : 20152 – OAuth2AccessTokenTypeNotSupported

Message : The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Cause : votre serveur d’autorisation n’est pas pris en charge.
Recommandation : utilisez un serveur d’autorisation qui peut retourner des jetons avec des types de jetons pris en charge.

Code d’erreur : 20153 – OAuth2ClientIdColonNotAllowed

Message : The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Cause : votre ID client comprend le caractère deux-points (:) non valide.
Recommandation : Utilisez un ID client valide.

Code d’erreur : 20523 – ManagedIdentityCredentialObjectNotSupported

Message : Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recommandation : vérifiez la version prise en charge et mettez à niveau le runtime d’intégration vers une version ultérieure.

Code d’erreur : 20551 – QueryMissingFormatSettingsInDataset

Message : The format settings are missing in dataset %dataSetName;.
Cause : le type de jeu de données est Binary, qui n’est pas pris en charge.
Recommandation : utilisez plutôt le jeu de données DelimitedText, JSON, Avro, Orc ou Parquet.
Cause : Pour le stockage de fichiers, les paramètres de format sont manquants dans le jeu de données.
Recommandation : Désélectionnez la « copie binaire » dans le jeu de données et définissez les paramètres de format corrects.

Code d’erreur : 20552 – QueryUnsupportedCommandBehavior

Message : The command behavior "%behavior;" is not supported.
Recommandation : n’ajoutez pas le comportement de la commande en tant que paramètre pour l’URL de demande d’API GetSchema ou d’aperçu.

Code d’erreur : 20701 – DataConsistencyFailedToGetSourceFileMetadata

Message : Failed to retrieve source file ('%name;') metadata to validate data consistency.
Cause : il existe un problème temporaire sur le magasin de données récepteur, ou la récupération des métadonnées à partir du magasin de données récepteur n’est pas autorisée.

Code d’erreur : 20703 – DataConsistencyFailedToGetSinkFileMetadata

Message : Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Cause : il existe un problème temporaire sur le magasin de données récepteur, ou la récupération des métadonnées à partir du magasin de données récepteur n’est pas autorisée.

Code d’erreur : 20704 – DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Message : Data consistency validation is not supported in current copy activity settings.
Cause : la validation de cohérence des données est prise en charge uniquement dans le scénario de copie binaire directe.
Recommandation : Supprimez la propriété « validateDataConsistency » dans la charge utile de l’activité de copie.

Code d’erreur : 20705 – DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Message : 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recommandation : vérifiez la version du runtime d’intégration prise en charge et mettez-la à niveau vers une version ultérieure, ou supprimez la propriété « validateDataConsistency » des activités de copie.

Code d’erreur : 20741 – SkipMissingFileNotSupportedForNonDirectBinaryCopy

Message : Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recommandation : Supprimez « fileMissing » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20742 – SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Message : Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Recommandation : Supprimez « dataInconsistency » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20743 – SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Message : Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recommandation : Supprimez « fileForbidden » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20744 – SkipForbiddenFileNotSupportedForThisConnector

Message : Skip forbidden file is not supported for this connector: ('%connectorName;').
Recommandation : Supprimez « fileForbidden » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20745 – SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Message : Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recommandation : Supprimez « invalidFileName » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20746 – SkipInvalidFileNameNotSupportedForSource

Message : Skip invalid file name is not supported for '%connectorName;' source.
Recommandation : Supprimez « invalidFileName » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20747 – SkipInvalidFileNameNotSupportedForSink

Message : Skip invalid file name is not supported for '%connectorName;' sink.
Recommandation : Supprimez « invalidFileName » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20748 – SkipAllErrorFileNotSupportedForNonBinaryCopy

Message : Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Recommandation : supprimez « allErrorFile » dans le paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 20771 – DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Message : 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Recommandation : supprimez le paramètre « deleteFilesAfterCompletion » ou utilisez une copie binaire directe.

Code d’erreur : 20772 – DeleteFilesAfterCompletionNotSupportedForThisConnector

Message : 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Recommandation : supprimez le paramètre « deleteFilesAfterCompletion » dans la charge utile de l’activité de copie.

Code d’erreur : 27002 – FailedToDownloadCustomPlugins

Message : Failed to download custom plugins.
Cause : liens de téléchargement non valides ou problèmes de connectivité temporaire.
Recommandation : réessayez si le message indique qu’il s’agit d’un problème temporaire. Si le problème persiste, contactez l’équipe du support technique.

Erreurs générales du connecteur

Code d’erreur : 9611 – UserErrorOdbcInvalidQueryString

Message : The following ODBC Query is not valid: '%'.
Cause : Vous fournissez une requête incorrecte ou non valide pour extraire les données/schémas.
Recommandation : vérifiez que votre requête est valide et peut retourner des données/schémas. Utilisez l’activité de script si vous souhaitez exécuter des scripts sans requêtes et que votre magasin de données est pris en charge. Vous pouvez également utiliser la procédure stockée qui retourne un résultat factice pour exécuter vos scripts en tant que non-requêtes.

Code d’erreur : 11775

Message : Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'
Cause : la cause exacte dépend du texte retourné dans '%'. S’il s’agit du délai d’attente de l’opération, cela peut être dû au fait que l’instance de PostgreSQL est arrêtée ou que la méthode de connectivité réseau configurée pour votre instance n’autorise pas les connexions à partir du runtime d’intégration sélectionné. L’utilisateur ou le mot de passe fourni sont incorrects. S’il s’agit de 28P01 : l’authentification par mot de passe a échoué pour l’utilisateur <que votre utilisateur> a fourni, cela signifie que l’utilisateur fourni n’existe pas dans l’instance ou que le mot de passe est incorrect. S'il s'agit de 28000 : aucune entrée pg_hba.conf pour l'hôte « ###.###.###.### », l'utilisateur « <youruser> », la base de données « <yourdatabase> », pas de chiffrement, cela signifie que la méthode de chiffrement sélectionnée n'est pas compatible avec la configuration du serveur.
Recommandation : vérifiez que l’utilisateur fourni existe dans votre instance de PostgreSQL et que le mot de passe correspond à celui actuellement affecté à cet utilisateur. Vérifiez que la méthode de chiffrement sélectionnée est acceptée par votre instance de PostgreSQL, en fonction de sa configuration actuelle. Si la méthode de connectivité réseau de votre instance est configurée pour l’accès privé (intégration au réseau virtuel), utilisez un runtime d’intégration auto-hébergé pour vous y connecter. S’il est configuré pour l’accès public (adresses IP autorisées), il est recommandé d’utiliser un runtime d’intégration Azure avec un réseau virtuel managé et de déployer un point de terminaison privé managé pour vous connecter à votre instance. Lorsqu’il est configuré pour l’accès public (adresses IP autorisées), une alternative moins recommandée consiste à créer des règles de pare-feu dans votre instance pour autoriser le trafic provenant des adresses IP utilisées par le runtime d’intégration Azure que vous utilisez.

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