Az Azure Data Factory- és Azure Synapse Analytics-összekötők hibaelhárítása

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Ez a cikk az Azure Data Factory és az Azure Synapse Analytics összekötőinek hibaelhárítását ismerteti.

Összekötőkre vonatkozó problémák

Az egyes összekötők hibaelhárítási oldalaira kattintva megtekintheti az adott összekötővel kapcsolatos problémákat az okok magyarázatával és a megoldásukra vonatkozó javaslatokkal.

• Azure Blob Storage
• Azure Cosmos DB (beleértve az Azure Cosmos DB for NoSQL-összekötőt)
• Azure Data Lake (Gen1 és Gen2)
• Azure Database for PostgreSQL
• Azure Files Storage
• Azure Synapse Analytics, Azure SQL Database és SQL Server
• DB2
• Tagolt szövegformátum
• Dynamics 365, Dataverse (Common Data Service) és Dynamics CRM
• FTP, SFTP és HTTP
• Hive
• Oracle
• ORC formátum
• Parquet formátum
• REST
• Salesforce és Salesforce szolgáltatásfelhő
• SharePoint Online-lista
• XML-formátum

Általános másolási tevékenység hibái

A másolási tevékenység során az alábbi hibák általánosak, és bármely összekötőnél előfordulhatnak.

Hibakód: 2200 – UserErrorOdbcOperationFailed

• Üzenet: The underlying connection was closed: An unexpected error occurred on a send.

• Ok: Ez általában hitelesítési hibát jelez az adatátviteli műveletek során. Ez akkor fordulhat elő, ha a távoli fél bezárja az átviteli adatfolyamot.

• Visszahívás:

  • Ellenőrizze a forráskapcsolatot, és tesztelje, hogy megfelelően működik-e.
  • Ellenőrizze a kapcsolathoz használt hitelesítési módszert.
  • Tekintse át az Azure Cosmos DB tűzfalkonfigurációs beállításait, és győződjön meg arról, hogy engedélyezik a szükséges forgalmat.

Hibakód: 20000 – JreNotFound

• Üzenet: 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.

• Ok: A saját üzemeltetésű integrációs modul nem találja a Java-futtatókörnyezetet. Bizonyos források olvasásához Java-futtatókörnyezet szükséges.

• Javaslat: Ellenőrizze az integrációs futtatókörnyezetet, lásd : Saját üzemeltetésű integrációs modul használata.

Hibakód: 20002 – JniException

• Üzenet: An error occurred when invoking Java Native Interface.

• Ok: Ha a hibaüzenet a következőt tartalmazza: "Nem hozható létre JVM: JNI visszatérési kód [-6][A JNI-hívás sikertelen: Érvénytelen argumentumok.]", a lehetséges ok az, hogy a JVM nem hozható létre, mert néhány érvénytelen (globális) argumentum be van állítva.

• Javaslat: Jelentkezzen be a saját üzemeltetésű integrációs modul minden csomópontját üzemeltető gépre. Ellenőrizze, hogy a rendszerváltozó megfelelően van-e beállítva, az alábbiak szerint: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Indítsa újra az összes integrációs futtatókörnyezeti csomópontot, majd futtassa újra a folyamatot.

Hibakód: 20020 – WildcardPathSinkNotSupported

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

• Ok: A fogadó adatkészlete nem támogatja a helyettesítő karakterek értékeit.

• Javaslat: Ellenőrizze a fogadó adatkészletét, és írja át az elérési utat helyettesítő karakter használata nélkül.

FIPS-probléma

• Tünetek: Copy tevékenység a FIPS-kompatibilis, saját üzemeltetésű integrációs modult futtató gépen a következő hibaüzenet jelenik meg:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

• Ok: Ez a hiba akkor fordulhat elő, ha olyan összekötőkkel másol adatokat, mint az Azure Blob, az SFTP stb. A Federal Information Processing Standards (FIPS) meghatározza, hogy melyek azok a titkosítási algoritmusok, amelyek használata engedélyezett. Ha a FIPS mód engedélyezve van a gépen, bizonyos esetekben a másolási tevékenységtől függő titkosítási osztályok blokkolva lesznek.

• Megoldás: Megtudhatja , miért nem javasoljuk többé a "FIPS mód" használatát, és értékelje ki, hogy letilthatja-e a FIPS-et a saját üzemeltetésű integrációs modulon.

  Ha csak a FIPS megkerülését és a tevékenység sikeres futtatását szeretné elérni, hajtsa végre a következő lépéseket:

  1. Nyissa meg azt a mappát, amelyben a helyi integrációs modul telepítve van. Az elérési út általában C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.

  2. Nyissa meg a diawp.exe.config fájlt, majd a szakasz végén adja hozzá <enforceFIPSPolicy enabled="false"/>az <runtime> alábbi módon:

     

  3. Mentse a fájlt, majd indítsa újra a saját üzemeltetésű integrációs modult.

Hibakód: 20150 – GetOAuth2AccessTokenErrorResponse

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

• Ok: Az ügyfélazonosító vagy az ügyfél titkos kódja érvénytelen, és a hitelesítés nem sikerült az engedélyezési kiszolgálón.

• Javaslat: Javítsa ki az engedélyezési kiszolgáló összes OAuth2-ügyfél hitelesítőadat-folyamatbeállítását.

Hibakód: 20151 – FailedToGetOAuth2AccessToken

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

• Ok: Az OAuth2 ügyfél hitelesítőadat-folyamatának beállításai érvénytelenek.

• Javaslat: Javítsa ki az engedélyezési kiszolgáló összes OAuth2-ügyfél hitelesítőadat-folyamatbeállítását.

Hibakód: 20152 – OAuth2AccessTokenTypeNotSupported

• Üzenet: The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

• Ok: Az engedélyezési kiszolgáló nem támogatott.

• Javaslat: Használjon olyan engedélyezési kiszolgálót, amely a támogatott jogkivonattípusokkal rendelkező jogkivonatokat képes visszaadni.

Hibakód: 20153 – OAuth2ClientIdColonNotAllowed

• Üzenet: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

• Ok: Az ügyfélazonosító érvénytelen karakter kettőspontot (:) tartalmaz.

• Javaslat: Használjon érvényes ügyfél-azonosítót.

Hibakód: 20523 – ManagedIdentityCredentialObjectNotSupported

• Üzenet: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

• Javaslat: Ellenőrizze a támogatott verziót, és frissítse az integrációs modult egy magasabb verzióra.

Hibakód: 20551 – QueryMissingFormatSettingsInDataset

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

• Ok: Az adathalmaz típusa bináris, amely nem támogatott.

• Javaslat: Használja helyette a DelimitedText, a Json, az Avro, az Orc vagy a Parquet adatkészletet.

• Ok: A fájltároló formátumbeállításai hiányoznak az adathalmazból.

• Javaslat: Törölje a "Bináris másolás" kijelölését az adathalmazban, és állítsa be a megfelelő formátumbeállításokat.

Hibakód: 20552 – QueryUnsupportedCommandBehavior

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

• Javaslat: Ne adja hozzá a parancs viselkedését paraméterként az előzetes verzióhoz vagy a GetSchema API-kérés URL-címéhez.

Hibakód: 20701 – DataConsistencyFailedToGetSourceFileMetadata

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

• Ok: Átmeneti probléma van a fogadóadattárban, vagy a metaadatok lekérése a fogadó adattárból nem engedélyezett.

Hibakód: 20703 – DataConsistencyFailedToGetSinkFileMetadata

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

• Ok: Átmeneti probléma van a fogadóadattárban, vagy a metaadatok lekérése a fogadó adattárból nem engedélyezett.

Hibakód: 20704 – DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

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

• Ok: Az adatkonzisztencia érvényesítése csak a közvetlen bináris másolási forgatókönyvben támogatott.

• Javaslat: Távolítsa el a "validateDataConsistency" tulajdonságot a másolási tevékenység hasznos adatai között.

Hibakód: 20705 – DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

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

• Javaslat: Ellenőrizze a támogatott integrációs modul verzióját, és frissítse azt egy magasabb verzióra, vagy távolítsa el a "validateDataConsistency" tulajdonságot a másolási tevékenységekből.

Hibakód: 20741 – SkipMissingFileNotSupportedForNonDirectBinaryCopy

• Üzenet: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

• Javaslat: Távolítsa el a skipErrorFile beállítás "fileMissing" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20742 – SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

• Üzenet: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.

• Javaslat: Távolítsa el a skipErrorFile beállítás "dataInconsistency" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20743 – SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

• Üzenet: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

• Javaslat: Távolítsa el a skipErrorFile beállítás "fileForbidden" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20744 – SkipForbiddenFileNotSupportedForThisConnector

• Üzenet: Skip forbidden file is not supported for this connector: ('%connectorName;').

• Javaslat: Távolítsa el a skipErrorFile beállítás "fileForbidden" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20745 – SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

• Üzenet: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

• Javaslat: Távolítsa el a skipErrorFile beállítás "invalidFileName" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20746 – SkipInvalidFileNameNotSupportedForSource

• Üzenet: Skip invalid file name is not supported for '%connectorName;' source.

• Javaslat: Távolítsa el a skipErrorFile beállítás "invalidFileName" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20747 – SkipInvalidFileNameNotSupportedForSink

• Üzenet: Skip invalid file name is not supported for '%connectorName;' sink.

• Javaslat: Távolítsa el a skipErrorFile beállítás "invalidFileName" elemét a másolási tevékenység hasznos adatai között.

Hibakód: 20748 – SkipAllErrorFileNotSupportedForNonBinaryCopy

• Üzenet: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

• Javaslat: Távolítsa el az "allErrorFile" fájlt a skipErrorFile beállításból a másolási tevékenység hasznos adatai között.

Hibakód: 20771 – DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

• Üzenet: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

• Javaslat: Távolítsa el a deleteFilesAfterCompletion beállítást, vagy használjon közvetlen bináris másolatot.

Hibakód: 20772 – DeleteFilesAfterCompletionNotSupportedForThisConnector

• Üzenet: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

• Javaslat: Távolítsa el a "deleteFilesAfterCompletion" beállítást a másolási tevékenység hasznos adatai között.

Hibakód: 27002 – FailedToDownloadCustomPlugins

• Üzenet: Failed to download custom plugins.

• Ok: Érvénytelen letöltési hivatkozások vagy átmeneti csatlakozási problémák.

• Javaslat: Próbálkozzon újra, ha az üzenet azt mutatja, hogy átmeneti probléma. Ha a probléma továbbra is fennáll, forduljon a támogatási csoporthoz.

Általános összekötőhibák

Hibakód: 9611 – UserErrorOdbcInvalidQueryString

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

• Ok: Hibás vagy érvénytelen lekérdezést ad meg az adatok/sémák lekéréséhez.

• Javaslat: Ellenőrizze, hogy a lekérdezés érvényes-e, és képes-e adatokat/sémákat visszaadni. Használjon szkripttevékenységet , ha nem lekérdezési szkripteket szeretne végrehajtani, és az adattár támogatott. Másik lehetőségként érdemes lehet olyan tárolt eljárást használni, amely hamis eredményt ad vissza a nem lekérdezési szkriptek végrehajtásához.

Hibakód: 11775

• Üzenet: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

• Ok: A pontos ok a visszaadott '%'szövegtől függ. Ha a művelet túllépte az időtúllépést, az lehet, hogy a PostgreSQL-példány leállt, vagy azért, mert a példányhoz konfigurált hálózati kapcsolati módszer nem engedélyezi a kiválasztott integrációs modulból származó kapcsolatokat. A megadott felhasználó vagy jelszó helytelen. Ha 28P01: a jelszó-hitelesítés nem sikerült a felhasználó <felhasználója> számára, az azt jelenti, hogy a megadott felhasználó nem létezik a példányban, vagy hogy a jelszó helytelen. Ha ez 28000: nincs pg_hba.conf bejegyzés a következő gazdagéphez: "##.###.##.#", felhasználó "<youruser>", adatbázis "<yourdatabase>", nincs titkosítás, ez azt jelenti, hogy a kiválasztott titkosítási módszer nem kompatibilis a kiszolgáló konfigurációjával.

• Javaslat: Ellenőrizze, hogy a megadott felhasználó létezik-e a PostgreSQL-példányban, és hogy a jelszó megegyezik-e az adott felhasználóhoz jelenleg hozzárendelt jelszóval. Győződjön meg arról, hogy a kiválasztott titkosítási módszert a PostgreSQL-példány elfogadja az aktuális konfigurációja alapján. Ha a példány hálózati kapcsolati módszere privát hozzáférésre (virtuális hálózati integrációra) van konfigurálva, használjon egy saját üzemeltetésű integrációs modult (IR) a csatlakozáshoz. Ha nyilvános hozzáférésre (engedélyezett IP-címekre) van konfigurálva, javasoljuk, hogy felügyelt virtuális hálózattal rendelkező Azure IR-t használjon, és helyezzen üzembe egy felügyelt privát végpontot a példányhoz való csatlakozáshoz. Ha nyilvános hozzáférésre (engedélyezett IP-címekre) van konfigurálva, a kevésbé ajánlott alternatíva az, ha tűzfalszabályokat hoz létre a példányban a használt Azure IR által használt IP-címekről származó forgalom engedélyezéséhez.

Kapcsolódó tartalom

További hibaelhárítási segítségért próbálja ki az alábbi erőforrásokat:

• Data Factory-blog
• Data Factory-funkciókérések
• Azure-videók
• Microsoft Q&A lap
• Stack Overflow fórum a Data Factoryhez
• X információ a Data Factoryről