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

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Cet article explique comment résoudre les problèmes liés aux connecteurs dans Azure Data Factory et Azure Synapse Analytics.

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 : 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 de runtime d’intégration, consultez Utiliser un runtime d’intégration auto-hébergé.

Code d’erreur : WildcardPathSinkNotSupported

  • Message : Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

  • Cause : Le jeu de données du récepteur ne prend pas en charge les caractères génériques.

  • Recommandation: Vérifiez le jeu de données du 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 pour une machine du runtime d'intégration auto-hébergé compatible FIPS avec le message d’erreur : 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 que Blob Azure, 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 ne recommandons plus le « mode FIPS », et déterminez si vous pouvez désactiver FIPS sur votre machine 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 est, en général, C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.

    2. Ouvrez le fichier diawp.exe.config et, à la fin de la section <runtime>, ajoutez <enforceFIPSPolicy enabled="false"/>, comme illustré ici :

      Capture d’écran d’une section du fichier diawp.exe.config montrant FIPS désactivé.

    3. Enregistrez le fichier, puis redémarrez la machine du runtime d’intégration auto-hébergé.

Code d’erreur : JniException

  • Message : An error occurred when invoking Java Native Interface.

  • Cause : Si le message d’erreur contient « Cannot create JVM: JNI return code [-6][JNI call failed: Invalid arguments.] » (« impossible de créer la JVM : code de retour JNI [-6] [échec de l’appel JNI : arguments non valides.] »), la cause possible est que la machine virtuelle Java (JVM) ne peut pas être créée, car certains arguments non conformes (globaux) sont définis.

  • Recommandation : Connectez-vous à la machine qui héberge chaque nœud de votre IR 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 : GetOAuth2AccessTokenErrorResponse

  • Message : Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

  • Cause : Votre ID client ou clé secrète client n’est pas valide, et l’authentification a échoué sur votre serveur d’autorisation.

  • Recommandation : Corrigez tous les paramètres de transmission des informations d’identification du client OAuth2 de votre serveur d’autorisation.

Code d’erreur : FailedToGetOAuth2AccessToken

  • Message : Failed to get access token from your token endpoint. Error message: %errorMessage;.

  • Cause : Les paramètres de transmission des informations d’identification du client OAuth2 ne sont pas valides.

  • Recommandation : Corrigez tous les paramètres de transmission des informations d’identification du client OAuth2 de votre serveur d’autorisation.

Code d’erreur : OAuth2AccessTokenTypeNotSupported

  • Message : The toke 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 : 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 de client valide.

Code d’erreur : 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 plus récente.

Code d’erreur : QueryMissingFormatSettingsInDataset

  • Message : The format settings are missing in dataset %dataSetName;.

  • Cause : Le type de jeu de données est binaire, ce qui n’est pas pris en charge.

  • Recommandation : Utilisez à la place le jeu de données DelimitedText, JSON, Avro, ORC ou Parquet.

  • Cause : Pour le stockage de fichiers, les paramètres de format sont absents du jeu de données.

  • Recommandation : Désélectionnez la « copie binaire » dans le jeu de données et définissez les paramètres de mise en forme appropriés.

Code d’erreur : QueryUnsupportedCommandBehavior

  • Message : The command behavior "%behavior;" is not supported.

  • Recommandation : N’ajoutez pas le comportement de la commande en tant que paramètre de l’URL de requête d’API en préversion ou GetSchema.

Code d’erreur : DataConsistencyFailedToGetSourceFileMetadata

  • Message : Failed to retrieve source file ('%name;') metadata to validate data consistency.

  • Cause : Il existe un problème temporaire dans le magasin de données récepteur ou bien la récupération des métadonnées à partir du magasin de données récepteur n’est pas autorisée.

Code d’erreur : DataConsistencyFailedToGetSinkFileMetadata

  • Message : Failed to retrieve sink file ('%name;') metadata to validate data consistency.

  • Cause : Il existe un problème temporaire dans le magasin de données récepteur ou bien la récupération des métadonnées à partir du magasin de données récepteur n’est pas autorisée.

Code d’erreur : DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

  • Message : Data consistency validation is not supported in current copy activity settings.

  • Cause : La validation de la cohérence des données est uniquement prise en charge 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 : DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

  • Message : 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • Recommandation : Vérifiez la version prise en charge du runtime d’intégration et mettez-la à niveau vers une version supérieure, ou supprimez la propriété « validateDataConsistency » des activités de copie.

Code d’erreur : 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 : 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 : 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 : 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 : 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 : 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 : 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 : 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 » du paramètre skipErrorFile dans la charge utile de l’activité de copie.

Code d’erreur : 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 la copie binaire directe.

Code d’erreur : 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 : FailedToDownloadCustomPlugins

  • Message : Failed to download custom plugins.

  • Cause : Liens de téléchargement non valides ou problèmes de connectivité temporaires.

  • 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 : UserErrorOdbcInvalidQueryString

  • Message : The following ODBC Query is not valid: '%'.

  • Cause : la requête est incorrecte ou invalide pour extraire les données/schémas.

  • Recommandation : vérifiez que votre requête est valide et peut renvoyer des données/schémas. Utilisez l’activité de script si vous souhaitez exécuter des scripts en tant que non-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 : FailToResolveParametersInExploratoryController

  • Message : The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.

  • Cause : Le service a une limitation pour prendre en charge le service lié qui fait référence à un autre service lié avec des paramètres de test de connexion ou d’aperçu des données. Par exemple, le passage d’un paramètre d’un Key Vault à un service lié peut se produire le problème. 

  • Recommandation : Supprimez les paramètres dans le service lié référencé pour éliminer l’erreur. Sinon, exécutez le pipeline sans tester la connexion ni afficher un aperçu des données. 

Étapes suivantes

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