Felsöka Azure Data Factory och anslutningsprogram för Azure Synapse Analytics

Artikel
12/09/2023

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln beskriver hur du felsöker anslutningsappar i Azure Data Factory och Azure Synapse Analytics.

Anslut eller specifika problem

Du kan läsa felsökningssidorna för varje anslutningsapp för att se problem som är specifika för den med förklaringar av deras orsaker och rekommendationer för att lösa dem.

Allmänna kopieringsaktivitetsfel

Felen nedan är allmänna för kopieringsaktiviteten och kan inträffa med alla anslutningsappar.

Felkod: JreNotFound

Meddelande: 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.
Orsak: Den lokalt installerade IR:en kan inte hitta Java Runtime. Java Runtime krävs för att läsa vissa källor.
Rekommendation: Kontrollera din integreringskörningsmiljö. Mer information finns i Använda lokalt installerad integrationskörning.

Felkod: WildcardPathSinkNotSupported

Meddelande: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Orsak: Datauppsättningen mottagare stöder inte jokerteckenvärden.
Rekommendation: Kontrollera datauppsättningen för mottagare och skriv om sökvägen utan att använda ett jokerteckenvärde.

FIPS-problem

Symptom: aktiviteten Kopiera misslyckas på en FIPS-aktiverad IR-dator med egen värd med följande felmeddelande:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Orsak: Det här felet kan inträffa när du kopierar data med anslutningsappar som Azure Blob, SFTP och så vidare. FIPS (Federal Information Processing Standards) definierar en viss uppsättning krypteringsalgoritmer som är tillåtna att användas. När FIPS-läget är aktiverat på datorn blockeras vissa kryptografiska klasser som kopieringsaktiviteten är beroende av i vissa scenarier.
Lösning: Lär dig varför vi inte längre rekommenderar "FIPS-läge" och utvärdera om du kan inaktivera FIPS på din lokala IR-dator.

Du kan också göra följande om du bara vill kringgå FIPS och göra så att aktivitetskörningarna lyckas:
1. Öppna mappen där lokalt installerad IR är installerad. Sökvägen är vanligtvis C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.
2. Öppna filen diawp.exe.config och lägg sedan till <enforceFIPSPolicy enabled="false"/>, som du ser här i slutet av <runtime> avsnittet:
3. Spara filen och starta sedan om den lokalt installerade IR-datorn.

Felkod: JniException

Meddelande: An error occurred when invoking Java Native Interface.
Orsak: Om felmeddelandet innehåller "Det går inte att skapa JVM: JNI-returkoden [-6][JNI-anropet misslyckades: Ogiltiga argument.]", är den möjliga orsaken att JVM inte kan skapas eftersom vissa olagliga (globala) argument har angetts.
Rekommendation: Logga in på datorn som är värd för varje nod i din lokala integrationskörning. Kontrollera att systemvariabeln är korrekt inställd på följande sätt: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Starta om alla integreringskörningsnoder och kör sedan pipelinen igen.

Felkod: GetOAuth2AccessTokenErrorResponse

Meddelande: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Orsak: Klient-ID:t eller klienthemligheten är ogiltig och autentiseringen misslyckades på auktoriseringsservern.
Rekommendation: Korrigera alla autentiseringsflödesinställningar för OAuth2-klienten för din auktoriseringsserver.

Felkod: FailedToGetOAuth2AccessToken

Meddelande: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Orsak: Flödesinställningarna för OAuth2-klientens autentiseringsuppgifter är ogiltiga.
Rekommendation: Korrigera alla autentiseringsflödesinställningar för OAuth2-klienten för din auktoriseringsserver.

Felkod: OAuth2AccessTokenTypeNotSupported

Meddelande: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Orsak: Auktoriseringsservern stöds inte.
Rekommendation: Använd en auktoriseringsserver som kan returnera token med tokentyper som stöds.

Felkod: OAuth2ClientIdColonNotAllowed

Meddelande: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Orsak: Klient-ID:t innehåller det ogiltiga teckenkolonet (:).
Rekommendation: Använd ett giltigt klient-ID.

Felkod: ManagedIdentityCredentialObjectNotSupported

Meddelande: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Rekommendation: Kontrollera vilken version som stöds och uppgradera integreringskörningen till en högre version.

Felkod: QueryMissingFormat Inställningar InDataset

Meddelande: The format settings are missing in dataset %dataSetName;.
Orsak: Datamängdstypen är Binär, vilket inte stöds.
Rekommendation: Använd datauppsättningen DelimitedText, Json, Avro, Orc eller Parquet i stället.
Orsak: För fillagringen saknas formatinställningarna i datauppsättningen.
Rekommendation: Avmarkera "Binär kopia" i datauppsättningen och ange rätt formatinställningar.

Felkod: QueryUnsupportedCommandBehavior

Meddelande: The command behavior "%behavior;" is not supported.
Rekommendation: Lägg inte till kommandobeteendet som en parameter för förhandsversion eller URL för GetSchema API-begäran.

Felkod: DataConsistencyFailedToGetSourceFileMetadata

Meddelande: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Orsak: Det finns ett tillfälligt problem i datalagret för mottagare, eller att hämta metadata från datalagret för mottagare är inte tillåtet.

Felkod: DataConsistencyFailedToGetSinkFileMetadata

Meddelande: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Orsak: Det finns ett tillfälligt problem i datalagret för mottagare, eller att hämta metadata från datalagret för mottagare är inte tillåtet.

Felkod: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Meddelande: Data consistency validation is not supported in current copy activity settings.
Orsak: Valideringen av datakonsekvens stöds endast i scenariot med direkt binär kopiering.
Rekommendation: Ta bort egenskapen "validateDataConsistency" i kopieringsaktivitetens nyttolast.

Felkod: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Meddelande: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Rekommendation: Kontrollera den integreringskörningsversion som stöds och uppgradera den till en högre version, eller ta bort egenskapen "validateDataConsistency" från kopieringsaktiviteter.

Felkod: SkipMissingFileNotSupportedForNonDirectBinaryCopy

Meddelande: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Rekommendation: Ta bort "fileMissing" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Meddelande: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Rekommendation: Ta bort "dataInkonsekvens" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: Hoppa överForbiddenFileNotSupportedForNonDirectBinaryCopy

Meddelande: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Rekommendation: Ta bort "fileForbidden" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: SkipForbiddenFileNotSupportedForThis Anslut or

Meddelande: Skip forbidden file is not supported for this connector: ('%connectorName;').
Rekommendation: Ta bort "fileForbidden" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Meddelande: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Rekommendation: Ta bort "invalidFileName" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: SkipInvalidFileNameNotSupportedForSource

Meddelande: Skip invalid file name is not supported for '%connectorName;' source.
Rekommendation: Ta bort "invalidFileName" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: SkipInvalidFileNameNotSupportedForSink

Meddelande: Skip invalid file name is not supported for '%connectorName;' sink.
Rekommendation: Ta bort "invalidFileName" för inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: SkipAllErrorFileNotSupportedForNonBinaryCopy

Meddelande: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Rekommendation: Ta bort "allErrorFile" i inställningen skipErrorFile i kopieringsaktivitetens nyttolast.

Felkod: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Meddelande: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Rekommendation: Ta bort inställningen "deleteFilesAfterCompletion" eller använd direkt binär kopia.

Felkod: DeleteFilesAfterCompletionNotSupportedForThis Anslut or

Meddelande: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Rekommendation: Ta bort inställningen "deleteFilesAfterCompletion" i kopieringsaktivitetens nyttolast.

Felkod: FailedToDownloadCustomPlugins

Meddelande: Failed to download custom plugins.
Orsak: Ogiltiga nedladdningslänkar eller tillfälliga anslutningsproblem.
Rekommendation: Försök igen om meddelandet visar att det är ett tillfälligt problem. Kontakta supportteamet om problemet kvarstår.

Allmänna anslutningsfel

Felkod: UserErrorOdbcInvalidQueryString

Meddelande: The following ODBC Query is not valid: '%'.
Orsak: Du anger en felaktig eller ogiltig fråga för att hämta data/scheman.
Rekommendation: Kontrollera att frågan är giltig och kan returnera data/scheman. Använd Skriptaktivitet om du vill köra skript som inte är frågeskript och ditt datalager stöds. Du kan också överväga att använda lagrad procedur som returnerar ett dummy-resultat för att köra skript som inte är frågeskript.

Felkod: FailToResolveParametersInExploratoryController

Meddelande: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Orsak: Tjänsten har begränsningar för att stödja den länkade tjänsten som refererar till en annan länkad tjänst med parametrar för testanslutning eller förhandsgranskningsdata. Om du till exempel skickar en parameter från ett Key Vault till en länkad tjänst kan problemet uppstå.
Rekommendation: Ta bort parametrarna i den länkade tjänsten för att eliminera felet. Annars kör du pipelinen utan att testa anslutningen eller förhandsgranska data.

Om du vill ha mer felsökningshjälp kan du prova dessa resurser: