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

Cikk
12/09/2023

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

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

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

Csatlakozás konkrét 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.

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

Az alábbi hibák általánosak a másolási tevékenységhez, és bármilyen összekötővel előfordulhatnak.

Hibakód: 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: 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, tegye a következőket:
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: 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: 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: 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: OAuth2AccessTokenTypeNotSupported

Üzenet: The toke 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: 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: 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: QueryMissingFormat Gépház InDataset

Ü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: 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: 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: 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: 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: 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: 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: 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: 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: SkipForbiddenFileNotSupportedForThis Csatlakozás or

Ü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: 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: 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: 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: 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: 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: DeleteFilesAfterCompletionNotSupportedForThis Csatlakozás or

Ü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: 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: 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 egy hamis eredményt ad vissza a nem lekérdezési szkriptek végrehajtásához.

Hibakód: FailToResolveParametersInExploratoryController

Üzenet: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Ok: A szolgáltatás korlátozottan támogatja a csatolt szolgáltatást, amely egy másik társított szolgáltatásra hivatkozik a tesztkapcsolat vagy az előzetes verzió adatainak paramétereivel. Előfordulhat például, hogy egy paraméter key vaultból egy társított szolgáltatásnak való átadása problémát okozhat.
Javaslat: Távolítsa el a hivatkozott társított szolgáltatás paramétereit a hiba elkerülése érdekében. Ellenkező esetben futtassa a folyamatot a kapcsolat tesztelése vagy az adatok előnézete nélkül.

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