Rozwiązywanie problemów z łącznikami usług Azure Data Factory i Azure Synapse Analytics

Artykuł
12/09/2023

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób rozwiązywania problemów z łącznikami w usługach Azure Data Factory i Azure Synapse Analytics.

Połączenie or określonych problemów

Możesz zapoznać się ze stronami rozwiązywania problemów dla każdego łącznika, aby zobaczyć problemy specyficzne dla niego wraz z wyjaśnieniami ich przyczyn i zaleceń, aby je rozwiązać.

Ogólne błędy działania kopiowania

Poniższe błędy są ogólne dla działania kopiowania i mogą wystąpić z dowolnym łącznikiem.

Kod błędu: JreNotFound

Komunikat: 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.
Przyczyna: Własne środowisko IR nie może znaleźć środowiska uruchomieniowego Java. Środowisko uruchomieniowe języka Java jest wymagane do odczytywania określonych źródeł.
Zalecenie: Sprawdź środowisko Integration Runtime, zobacz Use Self-hosted Integration Runtime (Korzystanie z własnego środowiska Integration Runtime).

Kod błędu: WildcardPathSinkNotSupported

Komunikat: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Przyczyna: zestaw danych ujścia nie obsługuje wartości wieloznacznych.
Zalecenie: Sprawdź zestaw danych ujścia i ponownie zapisz ścieżkę bez użycia wartości wieloznacznej.

Problem ze standardem FIPS

Objawy: działanie Kopiuj kończy się niepowodzeniem na maszynie środowiska IR z obsługą protokołu FIPS z następującym komunikatem o błędzie:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Przyczyna: Ten błąd może wystąpić podczas kopiowania danych z łącznikami, takimi jak Azure Blob, SFTP itd. Normy Federal Information Processing Standards (FIPS) definiują określony zestaw algorytmów kryptograficznych, które mogą być używane. Gdy tryb FIPS jest włączony na maszynie, niektóre klasy kryptograficzne, od których zależy działanie kopiowania, są blokowane w niektórych scenariuszach.
Rozwiązanie: Dowiedz się , dlaczego nie zalecamy już korzystania z trybu FIPS i oceń, czy możesz wyłączyć protokół FIPS na własnym komputerze IR.

Alternatywnie, jeśli chcesz pominąć tylko fiPS i sprawić, że działanie zakończy się pomyślnie, wykonaj następujące czynności:
1. Otwórz folder, w którym zainstalowano własne środowisko IR. Ścieżka jest zwykle C:\Program Files\Microsoft Integration Runtime <version>\Shared.
2. Otwórz plik diawp.exe.config, a następnie na końcu <runtime> sekcji dodaj <enforceFIPSPolicy enabled="false"/>element , jak pokazano poniżej:
3. Zapisz plik, a następnie uruchom ponownie maszynę własnego środowiska IR.

Kod błędu: JniException

Komunikat: An error occurred when invoking Java Native Interface.
Przyczyna: Jeśli komunikat o błędzie zawiera komunikat "Nie można utworzyć maszyny wirtualnej JVM: kod powrotny JNI [-6][wywołanie JNI nie powiodło się: Nieprawidłowe argumenty.]", możliwą przyczyną jest to, że nie można utworzyć maszyny wirtualnej JVM, ponieważ ustawiono niektóre niedozwolone (globalne) argumenty.
Zalecenie: zaloguj się do maszyny, która hostuje każdy węzeł własnego środowiska Integration Runtime. Sprawdź, czy zmienna systemowa jest poprawnie ustawiona w następujący sposób: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Uruchom ponownie wszystkie węzły środowiska Integration Runtime, a następnie uruchom ponownie potok.

Kod błędu: GetOAuth2AccessTokenErrorResponse

Komunikat: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Przyczyna: Identyfikator klienta lub klucz tajny klienta jest nieprawidłowy, a uwierzytelnianie nie powiodło się na serwerze autoryzacji.
Zalecenie: Popraw wszystkie ustawienia przepływu poświadczeń klienta protokołu OAuth2 serwera autoryzacji.

Kod błędu: FailedToGetOAuth2AccessToken

Komunikat: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Przyczyna: Ustawienia przepływu poświadczeń klienta OAuth2 są nieprawidłowe.
Zalecenie: Popraw wszystkie ustawienia przepływu poświadczeń klienta protokołu OAuth2 serwera autoryzacji.

Kod błędu: OAuth2AccessTokenTypeNotSupported

Komunikat: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Przyczyna: Serwer autoryzacji nie jest obsługiwany.
Zalecenie: użyj serwera autoryzacji, który może zwracać tokeny z obsługiwanymi typami tokenów.

Kod błędu: OAuth2ClientIdColonNotAllowed

Komunikat: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Przyczyna: Identyfikator klienta zawiera nieprawidłowy dwukropek znaków (:).
Zalecenie: użyj prawidłowego identyfikatora klienta.

Kod błędu: ManagedIdentityCredentialObjectNotSupported

Komunikat: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Zalecenie: Sprawdź obsługiwaną wersję i uaktualnij środowisko Integration Runtime do nowszej wersji.

Kod błędu: QueryMissingFormat Ustawienia InDataset

Komunikat: The format settings are missing in dataset %dataSetName;.
Przyczyna: Typ zestawu danych to Binary, który nie jest obsługiwany.
Zalecenie: zamiast tego użyj zestawu danych DelimitedText, Json, Avro, Orc lub Parquet.
Przyczyna: W przypadku magazynu plików w zestawie danych brakuje ustawień formatu.
Zalecenie: Usuń zaznaczenie opcji "Kopia binarna" w zestawie danych i ustaw prawidłowe ustawienia formatu.

Kod błędu: QueryUnsupportedCommandBehavior

Komunikat: The command behavior "%behavior;" is not supported.
Zalecenie: nie dodawaj zachowania polecenia jako parametru dla wersji zapoznawczej ani adresu URL żądania interfejsu API GetSchema.

Kod błędu: DataConsistencyFailedToGetSourceFileMetadata

Komunikat: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Przyczyna: Występuje przejściowy problem w magazynie danych ujścia lub pobieranie metadanych z magazynu danych ujścia jest niedozwolone.

Kod błędu: DataConsistencyFailedToGetSinkFileMetadata

Komunikat: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Przyczyna: Występuje przejściowy problem w magazynie danych ujścia lub pobieranie metadanych z magazynu danych ujścia jest niedozwolone.

Kod błędu: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Komunikat: Data consistency validation is not supported in current copy activity settings.
Przyczyna: Walidacja spójności danych jest obsługiwana tylko w scenariuszu bezpośredniego kopiowania binarnego.
Zalecenie: Usuń właściwość "validateDataConsistency" w ładunku działania kopiowania.

Kod błędu: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Komunikat: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Zalecenie: Sprawdź obsługiwaną wersję środowiska Integration Runtime i uaktualnij ją do wyższej wersji lub usuń właściwość "validateDataConsistency" z działań kopiowania.

Kod błędu: SkipMissingFileNotSupportedForNonDirectBinaryCopy

Komunikat: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Zalecenie: Usuń wartość "fileMissing" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Komunikat: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Zalecenie: Usuń wartość "dataInconsistency" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Komunikat: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Zalecenie: Usuń wartość "fileForbidden" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipForbiddenFileNotSupportedForThis Połączenie or

Komunikat: Skip forbidden file is not supported for this connector: ('%connectorName;').
Zalecenie: Usuń wartość "fileForbidden" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Komunikat: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Zalecenie: Usuń wartość "invalidFileName" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipInvalidFileNameNotSupportedForSource

Komunikat: Skip invalid file name is not supported for '%connectorName;' source.
Zalecenie: Usuń wartość "invalidFileName" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipInvalidFileNameNotSupportedForSink

Komunikat: Skip invalid file name is not supported for '%connectorName;' sink.
Zalecenie: Usuń wartość "invalidFileName" ustawienia skipErrorFile w ładunku działania kopiowania.

Kod błędu: SkipAllErrorFileNotSupportedForNonBinaryCopy

Komunikat: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Zalecenie: Usuń wartość "allErrorFile" w ustawieniu skipErrorFile w ładunku działania kopiowania.

Kod błędu: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Komunikat: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Zalecenie: usuń ustawienie "deleteFilesAfterCompletion" lub użyj bezpośredniego kopiowania binarnego.

Kod błędu: DeleteFilesAfterCompletionNotSupportedForThis Połączenie or

Komunikat: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Zalecenie: Usuń ustawienie "deleteFilesAfterCompletion" w ładunku działania kopiowania.

Kod błędu: FailedToDownloadCustomPlugins

Komunikat: Failed to download custom plugins.
Przyczyna: Nieprawidłowe linki pobierania lub przejściowe problemy z łącznością.
Zalecenie: spróbuj ponownie, jeśli komunikat pokazuje, że jest to problem przejściowy. Jeśli problem będzie się powtarzać, skontaktuj się z zespołem pomocy technicznej.

Ogólne błędy łącznika

Kod błędu: UserErrorOdbcInvalidQueryString

Komunikat: The following ODBC Query is not valid: '%'.
Przyczyna: Podano nieprawidłowe lub nieprawidłowe zapytanie, aby pobrać dane/schematy.
Zalecenie: Sprawdź, czy zapytanie jest prawidłowe i może zwracać dane/schematy. Użyj działania Skrypt, jeśli chcesz wykonywać skrypty inne niż zapytania, a magazyn danych jest obsługiwany. Alternatywnie rozważ użycie procedury składowanej, która zwraca fikcyjny wynik w celu wykonania skryptów innych niż zapytania.

Kod błędu: FailToResolveParametersInExploratoryController

Komunikat: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Przyczyna: Usługa ma ograniczenie obsługi połączonej usługi, która odwołuje się do innej połączonej usługi z parametrami dla danych testu połączenia lub podglądu. Na przykład przekazanie parametru z usługi Key Vault do połączonej usługi może spowodować wystąpienie problemu.
Zalecenie: Usuń parametry w określonej połączonej usłudze, aby wyeliminować błąd. W przeciwnym razie uruchom potok bez testowania połączenia lub wyświetlania podglądu danych.

Aby uzyskać pomoc dotyczącą rozwiązywania problemów, wypróbuj następujące zasoby: