Freigeben über

Problembehandlung für FTP-, SFTP- und HTTP-Connectors in Fabric Data Factory und Azure Synapse

Dieser Artikel enthält Vorschläge zur Behandlung häufiger Probleme mit den FTP-, SFTP- und HTTP-Connectors in Fabric Data Factory und Azure Synapse.

FTP

Fehlercode: FtpFailedToConnectToFtpServer

  • Meldung: Failed to connect to FTP server. Please make sure the provided server information is correct, and try again.

  • Ursache: Möglicherweise wird ein falscher Verbindungstyp für den FTP-Server verwendet, z. B. wird der Secure FTP-Verbindungstyp (SFTP) verwendet, um eine Verbindung mit einem FTP-Server herzustellen.

  • Empfehlung: Überprüfen Sie den Port des Zielservers. FTP verwendet Port 21.

Fehlercode: FtpFailedToReadFtpData

  • Meldung: Failed to read data from ftp: The remote server returned an error: 227 Entering Passive Mode (*,*,*,*,*,*).

  • Ursache: Der Portbereich zwischen 1024 und 65535 ist nicht für die Datenübertragung im passiven Modus geöffnet, der von der Data Factory- oder Synapse-Pipeline unterstützt wird.

  • Empfehlung: Überprüfen Sie die Firewalleinstellungen des Zielservers. Öffnen Sie Port 1024-65535 oder den auf dem FTP-Server festgelegten Portbereich für die IP-Adresse der selbstgehosteten Integration Runtime/Azure IR.

SFTP

Fehlercode: SftpOperationFail

  • Meldung: Failed to '%operation;'. Check detailed error from SFTP.

  • Ursache: Ein Problem mit dem SFTP-Vorgang.

  • Empfehlung: Überprüfen Sie die Fehlerdetails aus dem SFTP.

Fehlercode: SftpRenameOperationFail

  • Meldung: 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.

  • Ursache: Der SFTP-Server unterstützt kein Umbenennen der temporären Datei.

  • Empfehlung: Legen Sie „useTempFileRename“ in der Kopiersenke auf „false“ fest, um das Hochladen in die temporäre Datei zu deaktivieren.

Fehlercode: SftpInvalidSftpCredential

  • Meldung: Invalid SFTP credential provided for '%type;' authentication type.

  • Ursache: Der Inhalt des privaten Schlüssels wird aus Azure Key Vault oder dem SDK abgerufen, ist aber nicht ordnungsgemäß codiert.

  • Empfehlung:

    Wenn der Inhalt des privaten Schlüssels aus Ihrem Schlüsseltresor stammt, kann die ursprüngliche Schlüsseldatei funktionieren, wenn Sie sie direkt in die SFTP-Verbindung hochladen.

    Der Inhalt des privaten Schlüssels ist der base64-codierte Inhalt eines privaten SSH-Schlüssels.

    Codieren Sie den gesamten Inhalt der ursprünglichen Datei mit dem privaten Schlüssel mit base64, und speichern Sie die codierte Zeichenfolge in Ihrem Schlüsseltresor. Die ursprüngliche Datei mit dem privaten Schlüssel funktioniert bei einem SFTP-Verbindungstyp, wenn Sie Hochladen in der Datei auswählen.

    Es folgen einige Beispiele, die Sie verwenden können, um die Zeichenfolge zu generieren:

    • In C#:

      byte[] keyContentBytes = File.ReadAllBytes(Private Key Path);
string keyContent = Convert.ToBase64String(keyContentBytes, Base64FormattingOptions.None);
      • In Python:
      import base64
rfd = open(r'{Private Key Path}', 'rb')
keyContent = rfd.read()
rfd.close()
print base64.b64encode(Key Content)

  • Ursache: Es wurde das falsche Format für den Schlüsselinhalt ausgewählt.

  • Empfehlung:

    Private SSH-Schlüssel im PKCS#8-Format (beginnt mit „-----BEGIN ENCRYPTED PRIVATE KEY-----“) werden derzeit nicht für den Zugriff auf den SFTP-Server unterstützt.

    Führen Sie die folgenden Befehle aus, um den Schlüssel in ein herkömmliches SSH-Schlüsselformat zu konvertieren (beginnend mit „-----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

  • Ursache: Die Anmeldeinformationen oder der Inhalt des privaten Schlüssels ist ungültig.

  • Empfehlung: Überprüfen Sie mit Tools wie WinSCP erneut, ob die Schlüsseldatei und das Kennwort richtig sind.

Fehler bei der SFTP-Kopieraktivität

  • Symptome:

    • Fehlercode: UserErrorInvalidColumnMappingColumnNotFound
    • Fehlermeldung: Column 'AccMngr' specified in column mapping cannot be found in source data.

  • Ursache: Die Quelle enthält keine Spalte mit dem Namen „AccMngr“.

  • Lösung: Um zu ermitteln, ob die Spalte „accmngr“ vorhanden ist, überprüfen Sie die Datasetkonfiguration erneut, indem Sie die Zieldatasetspalte zuordnen.

Fehlercode: SftpFailedToConnectToSftpServer

  • Meldung: Failed to connect to SFTP server '%server;'.

  • Ursache: Wenn die Fehlermeldung die Zeichenfolge „Timeout bei Socket-Lesevorgang nach 30.000 Millisekunden“, ist eine mögliche Ursache, dass ein falscher Verbindungstyp für den SFTP-Server verwendet wird. Beispielsweise wird mit einem FTP-Verbindungstyp versucht, eine Verbindung zum SFTP-Server herzustellen.

  • Empfehlung: Überprüfen Sie den Port des Zielservers. Standardmäßig verwendet SFTP Port 22.

  • Ursache: Wenn die Fehlermeldung die Zeichenfolge „Server response does not contain SSH protocol identification“ enthält, ist eine mögliche Ursache, dass der SFTP-Server die Verbindung gedrosselt hat. Es werden mehrere Verbindungen erstellt, um parallele Downloads vom SFTP-Server durchführen zu können. Manchmal tritt dabei eine SFTP-Serverdrosselung auf. Normalerweise geben verschiedene Server unterschiedliche Fehler zurück, wenn Drosselung auftritt.

  • Empfehlung:

    Geben Sie die maximale Anzahl gleichzeitiger Verbindungen des SFTP-Datasets als 1 an, und führen Sie die Kopieraktivität dann erneut aus. Wenn die Aktivität erfolgreich ist, können Sie sicher sein, dass Drosselung die Ursache ist.

    Wenn Sie den niedrigen Durchsatz steigern möchten, wenden Sie sich an die oder den SFTP-Administrator*in, um die Anzahl gleichzeitiger Verbindungen zu erhöhen, oder

    • Wenn Sie das lokale Datengateway (OPDG) verwenden, fügen Sie die IP des OPDG-Computers der Positivliste hinzu.

Fehlercode: SftpPermissionDenied

  • Meldung: Permission denied to access '%path;'

  • Ursache: Der angegebene Benutzer hat beim Betrieb keine Lese- oder Schreibberechtigung für den Ordner oder die Datei.

  • Empfehlung: Erteilen Sie dem Benutzer die Berechtigung zum Lesen oder Schreiben in den Ordner oder die Dateien auf dem SFTP-Server.

Fehlercode: SftpAuthenticationFailure

  • Meldung: 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.

  • Ursache: Die angegebenen Anmeldeinformationen (Ihr Kennwort oder Ihr privater Schlüssel) sind ungültig.

  • Empfehlung: Überprüfen Sie Ihre Anmeldeinformationen.

  • Ursache: Der angegebene Authentifizierungstyp ist nicht zulässig oder reicht nicht aus, um die Authentifizierung auf Ihrem SFTP-Server abzuschließen.

  • Empfehlung: Derzeit wird nur der Standardauthentifizierungstyp unterstützt

Es kann keine Verbindung mit SFTP hergestellt werden, weil von SFTP bereitgestellte Schlüsselaustauschalgorithmen in Data Factory nicht unterstützt werden

  • Symptome: Sie können keine Verbindung mit SFTP über Data Factory herstellen und erhalten die folgende Fehlermeldung: Failed to negotiate key exchange algorithm.

  • Ursache: Die vom SFTP-Server bereitgestellten Schlüsselaustauschalgorithmen werden in Data Factory nicht unterstützt. Die von der Data Factory unterstützten Schlüsselaustauschalgorithmen sind:

    • 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

Error Code: SftpInvalidHostKeyFingerprint

  • Meldung: Host key finger-print validation failed. Expected fingerprint is '<value in connection type>', real finger-print is '<server real value>'

  • Ursache: Data Factory unterstützt jetzt sicherere Hostschlüsselalgorithmen im SFTP-Connector. Für die neu hinzugefügten Algorithmen muss der entsprechende Fingerabdruck auf dem SFTP-Server abgerufen werden.

    Folgende Algorithmen werden neu unterstützt:

    • ssh-ed25519
    • ecdsa-sha2-nistp256
    • ecdsa-sha2-nistp384
    • ecdsa-sha2-nistp521

  • Empfehlung: Rufen Sie einen gültigen Fingerabdruck mithilfe des Hostschlüsselnamens in real finger-print aus der Fehlermeldung im SFTP-Server ab. Sie können den Befehl ausführen, um den Fingerabdruck auf Ihrem SFTP-Server abzurufen. Führen Sie beispielsweise ssh-keygen -E md5 -lf <keyFilePath> auf dem Linux-Server aus, um den Fingerabdruck abzurufen. Der Befehl kann zwischen verschiedenen Servertypen variieren.

Fehlercode: UnsupportedCompressionTypeWhenDisableChunking

  • Meldung: "Disable chunking" is not compatible with "ZipDeflate" decompression.

  • Ursache: Das Deaktivieren der Blockerstellung ist nicht mit der ZipDeflate-Dekomprimierung kompatibel.

  • Empfehlung: Laden Sie die Binärdaten in einen Stagingbereich (z. B. Azure Blob Storage), und dekomprimieren Sie sie in einer anderen Kopieraktivität.

HTTP

Fehlercode: HttpFileFailedToRead

  • Meldung: Failed to read data from http server. Check the error from http server：%message;

  • Ursache: Dieser Fehler tritt auf, wenn eine Data Factory- oder Synapse-Pipeline mit dem HTTP-Server kommuniziert, beim HTTP-Anforderungsvorgang jedoch ein Fehler auftritt.

  • Empfehlung: Überprüfen Sie den HTTP-Statuscode in der Fehlermeldung, und beheben Sie das Remoteserverproblem.

Fehlercode: HttpSourceUnsupportedStatusCode

  • Meldung: Http source doesn't support HTTP Status Code '%code;'.

  • Ursache: Dieser Fehler tritt auf, wenn Data Factory eine HTTP-Quelle anfordert, aber einen unerwarteten Statuscode erhält.

  • Empfehlung: Weitere Informationen zum HTTP-Statuscode finden Sie in diesem Dokument.

Zugehöriger Inhalt

Weitere Informationen zur Problembehandlung finden Sie in diesen Ressourcen: