Jaa

Ftp-, SFTP- ja HTTP-liittimien vianmääritys Fabric Data Factoryssa ja Azure Synapse

Tässä artikkelissa annetaan ehdotuksia ftp-, SFTP- ja HTTP-liittimien yleisten ongelmien vianmääritykseen Data Factoryssa ja Azure Synapse.

FTP

Virhekoodi: FtpFailedToConnectToFtpServer

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

  • Syy: FTP-palvelimessa voidaan käyttää virheellistä yhteystyyppiä, kuten suojatun FTP (SFTP) -yhteystyypin käyttämistä yhteyden muodostamiseksi FTP-palvelimeen.

  • Suositus: Tarkista kohdepalvelimen portti. FTP käyttää porttia 21.

Virhekoodi: FtpFailedToReadFtpData

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

  • Syy: Porttialue 1024–65535 ei ole avoinna tiedonsiirrolle passiivitilassa, jota tietotehdas tai Synapse-putki tukee.

  • Suositus: Tarkista kohdepalvelimen palomuuriasetukset. Avoin portti 1024-65535 tai porttialue, joka on määritetty FTP-palvelimessa SHIR/Azure IR IP -osoitteeseen.

SFTP

Virhekoodi: SftpOperationFail

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

  • Syy: SFTP-toiminnon ongelma.

  • Suositus: Tarkista virhetiedot kohteesta SFTP.

Virhekoodi: SftpRenameOperationFail

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

  • Syy: SFTP-palvelimesi ei tue tilapäistiedoston uudelleennimeämistä.

  • Suositus: Määritä "useTempFileRename" -arvoksi epätosi kopioinninaltaan kohdalla, jotta temp-tiedostoon lataaminen ei ole käytössä.

Virhekoodi: SftpInvalidSftpCredential

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

  • Syy: Yksityisen avaimen sisältö noudetaan Azure Key Vaultista tai SDK:sta, mutta sitä ei ole koodattu oikein.

  • Suositus:

    Jos yksityisen avaimen sisältö on peräisin avainsäilöstäsi, alkuperäinen avaintiedosto voi toimia, jos lataat sen suoraan SFTP-yhteyteen.

    Yksityisen avaimen sisältö on base64-koodattu yksityisen SSH-avaimen sisältö.

    Koodaa koko alkuperäinen yksityisavaintiedosto Base64-koodauksen avulla ja tallenna koodattu merkkijono avainsäilöön. Alkuperäinen yksityisen avaimen tiedosto on se, jota voidaan käyttää SFTP-yhteystyypissä, jos valitset tiedostosta Lataa .

    Tässä on joitakin malleja, joiden avulla voit luoda merkkijonon:

    • Käytä C#-koodia:

      byte[] keyContentBytes = File.ReadAllBytes(Private Key Path);
string keyContent = Convert.ToBase64String(keyContentBytes, Base64FormattingOptions.None);
      • Käytä Python-koodia:
      import base64
rfd = open(r'{Private Key Path}', 'rb')
keyContent = rfd.read()
rfd.close()
print base64.b64encode(Key Content)
      • Käytä kolmannen osapuolen base64-muuntotyökalua. Suosittelemme Base64-muodon koodaustyökalua.

  • Syy: Valittiin väärä avainsisältömuoto.

  • Suositus:

    PKCS#8-muotoista yksityistä SSH-avainta (aloita "-----BEGIN ENCRYPTED PRIVATE KEY-----") ei tällä hetkellä tueta SFTP-palvelimen käyttämisessä.

    Jos haluat muuntaa avaimen perinteiseen SSH-avainmuotoon, suorita seuraavat komennot " -----BEGIN RSA PRIVATE KEY-----" -komennolla:

    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

  • Syy: Virheelliset tunnistetiedot tai yksityisen avaimen sisältö.

  • Suositus: Jos haluat nähdä, onko avaintiedosto tai salasana oikein, tarkista se työkaluilla, kuten WinSCP.

SFTP-kopiointitoiminto epäonnistui

  • Oireet:

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

  • Syy: Lähde ei sisällä saraketta nimeltä AccMngr.

  • Ratkaisu: Voit selvittää, onko AccMngr-sarake olemassa, tarkistamalla tietojoukon määritykset yhdistämällä kohdetietojoukon sarake.

Virhekoodi: SftpFailedToConnectToSftpServer

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

  • Syy: Jos virhesanoma sisältää merkkijonon "Socket read operation timed out after 30,000 millisekuntia", yksi mahdollinen syy on se, että SFTP-palvelimessa käytetään virheellistä yhteystyyppiä. Voit esimerkiksi käyttää FTP-yhteystyyppiä yhteyden muodostamiseksi SFTP-palvelimeen.

  • Suositus: Tarkista kohdepalvelimen portti. SFTP käyttää oletusarvoisesti porttia 22.

  • Syy: Jos virhesanoma sisältää merkkijonon "Palvelimen vastaus ei sisällä SSH-protokollan tunnistamista", yksi mahdollinen syy on se, että SFTP-palvelin rajoittaa yhteyttä. Useita yhteyksiä luodaan ladattavaksi SFTP-palvelimesta rinnakkain, ja joskus se kohtaa SFTP-palvelimen rajoittamista. Tavallisesti eri palvelimet palauttavat erilaisia virheitä, kun ne kohtaavat rajoittamista.

  • Suositus:

    Määritä SFTP-tietojoukon samanaikaisten yhteyksien enimmäismäärä luvuksi 1 ja suorita kopiointitoiminto uudelleen. Jos toiminta onnistuu, voit olla varma siitä, että syynä on rajoittaminen.

    Jos haluat ylentää pienen siirtomäärän, ota yhteyttä SFTP-järjestelmänvalvojaan samanaikaisten yhteyksien määrän rajoittamiseksi, tai

    • Jos käytät paikallista tietoyhdyskäytävää (OPDG), lisää OPDG-tietokoneen IP-osoite sallittujen luetteloon.

Virhekoodi: SftpPermissionDenied

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

  • Syy: Määritetyllä käyttäjällä ei ole kansion tai tiedoston luku- tai kirjoitusoikeutta, kun se on käytössä.

  • Suositus: anna käyttäjälle oikeus lukea tai kirjoittaa SFTP-palvelimen kansioon tai tiedostoihin.

Virhekoodi: SftpAuthenticationFailure

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

  • Syy: Määritetty tunnistetieto (salasana tai yksityinen avain) on virheellinen.

  • Suositus: Tarkista tunnistetietosi.

  • Syy: Määritettyä todennustyyppiä ei sallita eikä se riitä SFTP-palvelimesi todennuksen suorittamiseen.

  • Suositus: Tällä hetkellä vain perustodentamista tuetaan

Yhteyden muodostaminen SFTP:hen ei onnistu SFTP:n tarjoamien avaintenvaihtoalgoritmien vuoksi ei ole tuettua Data Factoryssa

  • Oireet: Et pysty muodostamaan yhteyttä SFTP:hen datatehtaan kautta ja täyttämään seuraavan virhesanoman: Failed to negotiate key exchange algorithm.

  • Syy: SFTP-palvelimen tarjoamia tärkeimpiä exchange-algoritmeja ei tueta datatehtaassa. Datatehtaan tukemia tärkeimpiä exchange-algoritmeja ovat seuraavat:

    • käyrä25519-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

Virhekoodi: SftpInvalidHostKeyFingerprint

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

  • Syy: Data Factory tukee nyt turvallisempia isäntäavainalgoritmeja SFTP-liittimessä. Uusille lisätyille algoritmeille se edellyttää vastaavan sormenjäljen noutamista SFTP-palvelimessa.

    Äskettäin tuetut algoritmit ovat seuraavat:

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

  • Suositus: Hanki kelvollinen sormenjälki käyttämällä isäntäavaimen nimeä real finger-print SFTP-palvelimen virhesanomasta. Voit suorittaa komennon saadaksesi sormenjäljen SFTP-palvelimessasi. Suorita esimerkiksi ssh-keygen -E md5 -lf <keyFilePath> Linux-palvelimessa sormenjäljen saamiseksi. Komento voi vaihdella eri palvelintyyppien mukaan.

Virhekoodi: UnsupportedCompressionTypeWhenDisableChunking

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

  • Syy: Paloittelu ei ole yhteensopiva ZipDeflate-purkupakkauksen kanssa.

  • Suositus: Lataa binaaritiedot valmistelualueelle (esimerkiksi Azure Blob -säilö) ja pura ne toisessa kopiointitoiminnossa.

HTTP

Virhekoodi: HttpFileFailedToRead

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

  • Syy: Tämä virhe ilmenee, kun tietotehdas tai Synapse-putki puhuu HTTP-palvelimelle, mutta HTTP-pyyntötoiminto epäonnistuu.

  • Suositus: Tarkista virhesanomassa HTTP-tilakoodi ja korjaa etäpalvelimen ongelma.

Virhekoodi: HttpSourceUnsupportedStatusCode

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

  • Syy: Tämä virhe ilmenee, kun Data Factory pyytää HTTP-lähdettä, mutta saa odottamattoman tilakoodin.

  • Suositus: Lisätietoja HTTP-tilakoodista on tässä asiakirjassa.

Liittyvä sisältö

Saat lisätietoja vianmäärityksen ohjeista seuraavista resursseista: