Résoudre les problèmes liés aux connecteurs FTP, SFTP et HTTP dans Fabric Data Factory et Azure Synapse

2024-11-19

Cet article fournit des suggestions pour résoudre les problèmes courants liés aux connecteurs FTP, SFTP et HTTP dans Data Factory et Azure Synapse.

FTP

Code d’erreur : FtpFailedToConnectToFtpServer

Message : Failed to connect to FTP server. Please make sure the provided server information is correct, and try again.
Cause : un type de connexion incorrect peut être utilisé pour le serveur FTP, comme l’utilisation du type de connexion FTP sécurisé (SFTP) pour se connecter à un serveur FTP.
Recommandation : Vérifiez le port du serveur cible. FTP utilise le port 21.

Code d’erreur : FtpFailedToReadFtpData

Message : Failed to read data from ftp: The remote server returned an error: 227 Entering Passive Mode (*,*,*,*,*,*).
Cause : La plage de ports comprise entre 1024 et 65535 n’est pas ouverte pour le transfert de données en mode passif pris en charge par le pipeline Data Factory ou Synapse.
Recommandation : Vérifiez les paramètres de pare-feu du serveur cible. Ouvrez le port 1024-65535 ou la plage de ports spécifié dans le serveur FTP à l’adresse IP SHIR/Azure IR.

SFTP

Code d’erreur : SftpOperationFail

Message : Failed to '%operation;'. Check detailed error from SFTP.
Cause : Problème avec l’opération SFTP.
Recommandation : Consultez les détails de l’erreur dans SFTP.

Code d’erreur : SftpRenameOperationFail

Message : Failed to rename the temp file. Your SFTP server doesn't support renaming temp file, set "useTempFileRename" as false in copy sink to disable uploading to temp file.
Cause : Votre serveur SFTP ne prend pas en charge le changement de nom du fichier temporaire.
Recommandation : Définissez « useTempFileRename » sur false dans le récepteur de copie pour désactiver le chargement dans le fichier temporaire.

Code d’erreur : SftpInvalidSftpCredential

Message : Invalid SFTP credential provided for '%type;' authentication type.
Cause : Le contenu de la clé privée est extrait d’Azure Key Vault ou du SDK, mais il n’est pas correctement encodé.
Recommandation :

Si le contenu de la clé privée provient de votre coffre de clés, le fichier de clé d’origine peut fonctionner si vous le chargez directement dans la connexion SFTP.

Le contenu de la clé privée est un contenu de clé privée SSH encodé en base64.

Encodez l’intégralité du contenu du fichier de clé privée d’origine avec un encodage en base64 et stockez la chaîne encodée dans votre coffre de clés. Le fichier de clé privée d’origine est celui qui peut fonctionner dans le type de connexion SFTP si vous sélectionnez Charger à partir d’un fichier.

Voici quelques exemples que vous pouvez utiliser pour générer la chaîne :
- Utilisation de code C# :
```
byte[] keyContentBytes = File.ReadAllBytes(Private Key Path);
string keyContent = Convert.ToBase64String(keyContentBytes, Base64FormattingOptions.None);
```
  - Utilisation de code Python :
```
import base64
rfd = open(r'{Private Key Path}', 'rb')
keyContent = rfd.read()
rfd.close()
print base64.b64encode(Key Content)
```
  - Utilisez un outil de conversion en base64 tiers. Nous vous recommandons d’utiliser l’outil Encoder au format Base64.
Cause : Le format choisi pour le contenu de la clé était incorrect.
Recommandation :

La clé privée SSH au format PKCS#8 (commençant par « -----BEGIN ENCRYPTED PRIVATE KEY----- ») n’est actuellement pas prise en charge pour l’accès au serveur SFTP.

Exécutez les commandes ci-dessous pour convertir la clé au format de clé SSH classique (commençant par « ------BEGIN RSA PRIVATE KEY----- ») :
```
openssl pkcs8 -in pkcs8_format_key_file -out traditional_format_key_file
chmod 600 traditional_format_key_file
ssh-keygen -f traditional_format_key_file -p
```
Cause : Contenu de clé privée ou informations d’identification non valides.
Recommandation : Servez-vous d’un outil comme WinSCP pour vérifier si votre fichier de clé ou votre mot de passe est correct.

Échec de l’activité de copie SFTP

Symptômes :
- Code d’erreur : UserErrorInvalidColumnMappingColumnNotFound
- Message d’erreur : Column 'AccMngr' specified in column mapping cannot be found in source data.
Cause : La source ne comporte pas de colonne nommée « AccMngr ».
Résolution : Pour déterminer si la colonne « AccMngr » existe, vérifiez la configuration de votre jeu de données en mappant la colonne du jeu de données de destination.

Code d’erreur : SftpFailedToConnectToSftpServer

Message : Failed to connect to SFTP server '%server;'.
Cause : si le message d’erreur contient la chaîne « L’opération de lecture de socket a expiré après 30 000 millisecondes », il est possible que le type de connexion soit incorrect pour le serveur SFTP. Par exemple, vous utilisez peut-être le type de connexion FTP pour vous connecter au serveur SFTP.
Recommandation : Vérifiez le port du serveur cible. Par défaut, SFTP utilise le port 22.
Cause : Si le message d’erreur contient la chaîne « La réponse du serveur ne contient pas d’identification de protocole SSH », il est possible que le serveur SFTP limite la connexion. Plusieurs connexions sont créées pour opérer des téléchargements parallèles à partir du serveur SFTP, lequel atteint parfois la limitation de serveur SFTP. En règle générale, les différents serveurs retournent des erreurs différentes lorsqu’ils rencontrent une limitation.
Recommandation :

Définissez le nombre maximal de connexions simultanées du jeu de données SFTP sur 1, puis réexécutez l’activité de copie. Si elle aboutit, cela est le signe que la limitation est en cause.

Si vous souhaitez promouvoir le faible débit, contactez votre administrateur SFTP pour augmenter le nombre limite de connexions simultanées ou :
- Si vous utilisez la passerelle de données locale (OPDG), ajoutez l’adresse IP de l’ordinateur OPDG à la liste d’autorisation.

Code d’erreur : SftpPermissionDenied

Message : Permission denied to access '%path;'
Cause : L’utilisateur indiqué n’a pas d’autorisation de lecture ou d’écriture sur le dossier ou le fichier lors de son fonctionnement.
Recommandation : Accordez à l’utilisateur l’autorisation de lire ou d’écrire dans le dossier ou les fichiers sur le serveur SFTP.

Code d’erreur : SftpAuthenticationFailure

Message : Meet authentication failure when connect to Sftp server '%server;' using '%type;' authentication type. Please make sure you are using the correct authentication type and the credential is valid. For more details, see our troubleshooting docs.
Cause : Les informations d’identification spécifiées (votre mot de passe ou votre clé privée) ne sont pas valides.
Recommandation : Vérifiez vos informations d’identification.
Cause : Le type d’authentification spécifié n’est pas autorisé ou n’est pas suffisant pour terminer l’authentification sur votre serveur SFTP.
Recommandation : actuellement, seul le type d’authentification de base est pris en charge

Impossible de se connecter à SFTP, car les algorithmes d’échange de clés fournis par SFTP ne sont pas pris en charge dans Data Factory

Symptômes : vous ne parvenez pas à vous connecter à SFTP via Data Factory et observez le message d’erreur suivant : Failed to negotiate key exchange algorithm.
Cause : les algorithmes d’échange de clés fournis par le serveur SFTP ne sont pas pris en charge dans Data Factory. Les algorithmes d’échange de clés pris en charge par Data Factory sont les suivants :
- curve25519-sha256
- curve25519-sha256@libssh.org
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
- diffie-hellman-group-exchange-sha256
- diffie-hellman-group-exchange-sha1
- diffie-hellman-group16-sha512
- diffie-hellman-group14-sha256
- diffie-hellman-group14-sha1
- diffie-hellman-group1-sha1

Code d’erreur : SftpInvalidHostKeyFingerprint

Message : Host key finger-print validation failed. Expected fingerprint is '<value in connection type>', real finger-print is '<server real value>'
Cause : Data Factory prend désormais en charge des algorithmes de clé hôte plus sécurisés dans le connecteur SFTP. Pour les algorithmes nouvellement ajoutés, il doit obtenir l’empreinte digitale correspondante dans le serveur SFTP.

Les algorithmes nouvellement pris en charge sont :
- ssh-ed25519
- ecdsa-sha2-nistp256
- ecdsa-sha2-nistp384
- ecdsa-sha2-nistp521
Recommandation : obtenez une empreinte digitale valide à l’aide du nom de clé d’hôte dans real finger-print à partir du message d’erreur du serveur SFTP. Vous pouvez exécuter la commande pour obtenir l’empreinte digitale sur votre serveur SFTP. Par exemple : exécutez ssh-keygen -E md5 -lf <keyFilePath> sur le serveur Linux pour obtenir l’empreinte digitale. La commande peut varier entre différents types de serveurs.

Code d’erreur : UnsupportedCompressionTypeWhenDisableChunking

Message : "Disable chunking" is not compatible with "ZipDeflate" decompression.
Cause : la désactivation de la segmentation n’est pas compatible avec la décompression ZipDeflate.
Recommandation : chargez les données binaires dans une zone intermédiaire (par exemple, Stockage Blob Azure) et décompressez-les dans une autre activité de copie.

HTTP

Code d’erreur : HttpFileFailedToRead

Message : Failed to read data from http server. Check the error from http server：%message;
Cause : Cette erreur se produit quand une fabrique de données ou un pipeline Synapse communique avec le serveur HTTP, mais que l’opération de requête HTTP échoue.
Recommandation : Vérifiez le code d’état HTTP dans le message d’erreur, puis corrigez le problème du serveur distant.

Code d’erreur : HttpSourceUnsupportedStatusCode

Message : Http source doesn't support HTTP Status Code '%code;'.
Cause : cette erreur se produit lorsque Data Factory demande une source HTTP, mais obtient un code d’état inattendu.
Recommandation : pour plus d’informations sur le code d’état HTTP, consultez ce document.

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