Rozwiązywanie problemów z łącznikami usług Azure Data Factory i Azure Synapse Analytics
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ć.
- Azure Blob Storage
- Azure Cosmos DB (w tym łącznik usługi Azure Cosmos DB for NoSQL)
- Azure Data Lake (Gen1 i Gen2)
- Azure Database for PostgreSQL
- Azure Files Storage
- Azure Synapse Analytics, Azure SQL Database i SQL Server
- DB2
- Format tekstu rozdzielanego
- Dynamics 365, Dataverse (Common Data Service) i Dynamics CRM
- FTP, SFTP i HTTP
- Hive
- Oracle
- Format ORC
- Format Parquet
- REST
- Salesforce i Salesforce Service Cloud
- Lista usługi SharePoint Online
- Format XML
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:
Otwórz folder, w którym zainstalowano własne środowisko IR. Ścieżka jest zwykle C:\Program Files\Microsoft Integration Runtime <version>\Shared.
Otwórz plik diawp.exe.config, a następnie na końcu
<runtime>
sekcji dodaj<enforceFIPSPolicy enabled="false"/>
element , jak pokazano poniżej: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.
Powiązana zawartość
Aby uzyskać pomoc dotyczącą rozwiązywania problemów, wypróbuj następujące zasoby: