Problembehandlung für Connectors in Azure Data Factory und Azure Synapse Analytics

Artikel
10/20/2023

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel wird beschrieben, wie Sie Probleme mit Connectors in Azure Data Factory und Azure Synapse Analytics behandeln.

Connectorspezifische Probleme

Sie können sich die Problembehandlungsseiten für jeden Connector ansehen, um spezifische Probleme mit Erklärungen zu deren Ursachen und Empfehlungen zur Lösung anzuzeigen.

Fehler bei allgemeiner Kopieraktivität

Die folgenden Fehler gelten allgemein für die Kopieraktivität und können bei jedem Connector auftreten.

Fehlercode: JreNotFound

Meldung: 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.
Ursache: Die selbstgehostete IR kann die Java-Laufzeit nicht finden. Die Java-Laufzeit ist zum Lesen bestimmter Quellen erforderlich.
Empfehlung: Überprüfen Sie Ihre Integration Runtime-Umgebung. Informationen dazu finden Sie unter Verwenden einer selbstgehosteten Integration Runtime.

Fehlercode: WildcardPathSinkNotSupported

Meldung: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Ursache: Das Senkendataset unterstützt keine Platzhalterwerte.
Empfehlung: Überprüfen Sie das Senkendataset, und korrigieren Sie den Pfad, ohne einen Platzhalterwert zu verwenden.

FIPS-Problem

Symptome: Fehler bei der Kopieraktivität auf einem auf einem selbstgehosteten IR-Computer mit aktiviertem FIPS mit folgender Fehlermeldung: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Ursache: Dieser Fehler kann auftreten, wenn Sie Daten mit Connectors wie Azure Blob, SFTP usw. kopieren. FIPS (Federal Information Processing Standards) definiert eine bestimmte Gruppe von Kryptografiealgorithmen, die verwendet werden können. Wenn der FIPS-Modus auf dem Computer aktiviert ist, werden einige Kryptografieklassen, von denen die Kopieraktivität abhängig ist, in einigen Szenarien blockiert.
Lösung: Informieren Sie sich, warum wir den „FIPS-Modus“ nicht mehr empfehlen, und ermitteln Sie, ob Sie FIPS auf Ihrem selbstgehosteten IR-Computer deaktivieren können.

Wenn Sie jedoch nur FIPS umgehen und erfolgreiche Aktivitätsausführungen ermöglichen möchten, können Sie folgendermaßen vorgehen:
1. Öffnen Sie den Ordner, in dem die selbstgehostete IR installiert ist. Der Pfad lautet in der Regel C:\Programme\Microsoft Integration Runtime <IR-Version>\Shared.
2. Öffnen Sie die Datei diawp.exe.config, und fügen Sie dann am Ende des <runtime>-Abschnitts <enforceFIPSPolicy enabled="false"/> wie hier gezeigt hinzu:
3. Speichern Sie die Datei, und starten Sie den Computer mit der selbstgehosteten IR neu.

Fehlercode: JniException

Meldung: An error occurred when invoking Java Native Interface.
Ursache: Wenn die Fehlermeldung „Cannot create JVM: JNI return code [-6][JNI call failed: Invalid arguments.]“ (JVM kann nicht erstellt werden: JNI-Rückgabecode [-6][Fehler bei JNI-Aufruf: ungültige Argumente.]) enthält, ist die mögliche Ursache, dass JVM nicht erstellt werden kann, da einige ungültige (globale) Argumente festgelegt sind.
Empfehlung: Melden Sie sich beim Computer an, auf dem die einzelnen Knoten Ihrer selbstgehosteten Integration Runtime gehostet werden. Stellen Sie wie folgt sicher, dass die Systemvariable ordnungsgemäß festgelegt ist: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Starten Sie alle Integration Runtime-Knoten neu, und führen Sie dann die Pipeline erneut aus.

Fehlercode: GetOAuth2AccessTokenErrorResponse

Meldung: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Ursache: Ihre Client-ID oder Ihr geheimer Clientschlüssel ist ungültig, und bei der Authentifizierung auf dem Autorisierungsserver ist ein Fehler aufgetreten.
Empfehlung: Korrigieren Sie alle Floweinstellungen für OAuth2-Clientanmeldeinformationen Ihres Autorisierungsservers.

Fehlercode: FailedToGetOAuth2AccessToken

Meldung: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Ursache: Die Floweinstellungen für OAuth2-Clientanmeldeinformationen sind ungültig.
Empfehlung: Korrigieren Sie alle Floweinstellungen für OAuth2-Clientanmeldeinformationen Ihres Autorisierungsservers.

Fehlercode: OAuth2AccessTokenTypeNotSupported

Meldung: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Ursache: Ihr Autorisierungsserver wird nicht unterstützt.
Empfehlung: Verwenden Sie einen Autorisierungsserver, der Token mit unterstützten Tokentypen zurückgeben kann.

Fehlercode: OAuth2ClientIdColonNotAllowed

Meldung: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Ursache: Ihre Client-ID enthält einen Doppelpunkt (:). Dies ist ein ungültiges Zeichen.
Empfehlung: Verwenden Sie eine gültige Client-ID.

Fehlercode: ManagedIdentityCredentialObjectNotSupported

Meldung: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Empfehlung: Überprüfen Sie die unterstützte Version, und führen Sie für die Integration Runtime ein Upgrade auf eine höhere Version durch.

Fehlercode: QueryMissingFormatSettingsInDataset

Meldung: The format settings are missing in dataset %dataSetName;.
Ursache: Es ist ein binärer Datasettyp festgelegt. Dieser Typ wird nicht unterstützt.
Empfehlung: Verwenden Sie stattdessen das DelimitedText-, Json-, Avro-, Orc- oder Parquet-Dataset.
Ursache: Für den Dateispeicher fehlen die Formateinstellungen im Dataset.
Empfehlung: Deaktivieren Sie die Option „Binärkopie“ im Dataset, und legen Sie die richtigen Formateinstellungen fest.

Fehlercode: QueryUnsupportedCommandBehavior

Meldung: The command behavior "%behavior;" is not supported.
Empfehlung: Fügen Sie das Befehlsverhalten nicht als Parameter für die Vorschau- oder GetSchema-API-Anforderungs-URL hinzu.

Fehlercode: DataConsistencyFailedToGetSourceFileMetadata

Meldung: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Ursache: Es liegt ein vorübergehendes Problem im Senkendatenspeicher vor, oder das Abrufen von Metadaten aus dem Senkendatenspeicher ist nicht zulässig.

Fehlercode: DataConsistencyFailedToGetSinkFileMetadata

Meldung: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Ursache: Es liegt ein vorübergehendes Problem im Senkendatenspeicher vor, oder das Abrufen von Metadaten aus dem Senkendatenspeicher ist nicht zulässig.

Fehlercode: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Meldung: Data consistency validation is not supported in current copy activity settings.
Ursache: Die Datenkonsistenzüberprüfung wird nur im direkten Binärkopierszenario unterstützt.
Empfehlung: Entfernen Sie die Eigenschaft „validateDataConsistency“ in den Nutzdaten der Kopieraktivität.

Fehlercode: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Meldung: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Empfehlung: Überprüfen Sie die unterstützte Integration Runtime-Version, und führen Sie ein Upgrade auf eine höhere Version durch, oder entfernen Sie die Eigenschaft „validateDataConsistency“ aus Kopieraktivitäten.

Fehlercode: SkipMissingFileNotSupportedForNonDirectBinaryCopy

Meldung: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Empfehlung: Entfernen Sie „fileMissing“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Meldung: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Empfehlung: Entfernen Sie „dataInconsistency“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Meldung: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Empfehlung: Entfernen Sie „fileForbidden“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipForbiddenFileNotSupportedForThisConnector

Meldung: Skip forbidden file is not supported for this connector: ('%connectorName;').
Empfehlung: Entfernen Sie „fileForbidden“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Meldung: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Empfehlung: Entfernen Sie „invalidFileName“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipInvalidFileNameNotSupportedForSource

Meldung: Skip invalid file name is not supported for '%connectorName;' source.
Empfehlung: Entfernen Sie „invalidFileName“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipInvalidFileNameNotSupportedForSink

Meldung: Skip invalid file name is not supported for '%connectorName;' sink.
Empfehlung: Entfernen Sie „invalidFileName“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: SkipAllErrorFileNotSupportedForNonBinaryCopy

Meldung: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Empfehlung: Entfernen Sie „allErrorFile“ der skipErrorFile-Einstellung in den Nutzdaten der Kopieraktivität.

Fehlercode: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Meldung: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Empfehlung: Entfernen Sie die Einstellung „deleteFilesAfterCompletion“, oder verwenden Sie eine direkte Binärkopie.

Fehlercode: DeleteFilesAfterCompletionNotSupportedForThisConnector

Meldung: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Empfehlung: Entfernen Sie die Einstellung „deleteFilesAfterCompletion“ in den Nutzdaten der Kopieraktivität.

Fehlercode: FailedToDownloadCustomPlugins

Meldung: Failed to download custom plugins.
Ursache: Ungültige Downloadlinks oder vorübergehende Konnektivitätsprobleme.
Empfehlung: Wiederholen Sie den Vorgang, wenn in der Meldung angezeigt wird, dass es sich um ein vorübergehendes Problem handelt. Sollte das Problem weiterhin bestehen, wenden Sie sich an das Supportteam.

Allgemeine Verbinderfehler

Fehlercode: UserErrorOdbcInvalidQueryString

Meldung: The following ODBC Query is not valid: '%'.
Ursache: Sie stellen eine falsche oder ungültige Abfrage bereit, um die Daten/Schemas abzurufen.
Empfehlung: Überprüfen Sie, ob Ihre Abfrage gültig ist und Daten/Schemas zurückgeben können. Verwenden Sie Skriptaktivitäten, wenn Sie Skripts ohne Abfrage ausführen möchten, und Ihr Datenspeicher wird unterstützt. Alternativ sollten Sie eine gespeicherte Prozedur verwenden, die ein Dummy-Ergebnis zurückgibt, um Ihre Skripts ohne Abfrage auszuführen.

Fehlercode: FailToResolveParametersInExploratoryController

Meldung: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Ursache: Beim Dienst bestehen Einschränkungen hinsichtlich der Unterstützung des verknüpften Diensts, der auf einen anderen verknüpften Dienst mit Parametern für Testverbindungen oder Vorschaudaten verweist. Das Problem kann beispielsweise beim Übergeben eines Parameters von einer Key Vault-Instanz an einen verknüpften Dienst auftreten.
Empfehlung: Entfernen Sie die Parameter im referenzierten verknüpften Dienst, um den Fehler zu beseitigen. Führen Sie andernfalls die Pipeline aus, ohne die Verbindung zu testen oder eine Vorschau der Daten anzuzeigen.

Weitere Informationen zur Problembehandlung finden Sie in diesen Ressourcen: