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.
Problemy specyficzne dla łącznika
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
Następujące błędy są ogólne dla działania kopiowania i mogą wystąpić z dowolnym łącznikiem.
Kod błędu: 2200
Komunikat:
The underlying connection was closed: An unexpected error occurred on a send.Przyczyna: Zazwyczaj wskazuje to niepowodzenie uwierzytelniania podczas operacji transferu danych. Taka sytuacja może wystąpić, gdy zdalna strona zamyka strumień transportu.
Reccomendation:
- Sprawdź połączenie źródłowe i przetestuj je, aby upewnić się, że działa prawidłowo.
- Sprawdź metodę uwierzytelniania używaną dla połączenia.
- Przejrzyj ustawienia konfiguracji zapory dla usługi Azure Cosmos DB, aby upewnić się, że zezwalają na wymagany ruch.
Kod błędu: 20000
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: 20002
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ż niektóre niedozwolone (globalne) argumenty są ustawione.
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: 20020
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 kroki:
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: 20150
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: 20151
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: 20152
Komunikat:
The token 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: 20153
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: 20523
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: 20551
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: 20552
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: 20701
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 nie jest dozwolone.
Kod błędu: 20703
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 nie jest dozwolone.
Kod błędu: 20704
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: 20705
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: 20741
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: 20742
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: 20743
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: 20744
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: 20745
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: 20746
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: 20747
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: 20748
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: 20771
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: 20772
Komunikat:
'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').Zalecenie: Usuń ustawienie "deleteFilesAfterCompletion" w ładunku działania kopiowania.
Kod błędu: 27002
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: 9611
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 wykonać skrypty inne niżquery, 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żquery.
Kod błędu: 11775
Komunikat:
Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'Przyczyna: Dokładna przyczyna zależy od tekstu zwróconego w pliku
'%'. Jeśli operacja przekroczyła limit czasu, może to być spowodowane tym, że wystąpienie bazy danych PostgreSQL zostało zatrzymane lub ponieważ metoda łączności sieciowej skonfigurowana dla wystąpienia nie zezwala na połączenia z wybranego środowiska Integration Runtime. Podany użytkownik lub hasło jest niepoprawne. Jeśli jest to 28P01: uwierzytelnianie hasłem nie powiodło się dla użytkownika <użytkownika>, oznacza to, że podany użytkownik nie istnieje w wystąpieniu lub że hasło jest niepoprawne. Jeśli jest to 28000: brak wpisu pg_hba.conf dla hosta "#.##.#", użytkownik "youruser>", baza danych "<<yourdatabase>", brak szyfrowania, oznacza to, że wybrana metoda szyfrowania nie jest zgodna z konfiguracją serwera.Zalecenie: Upewnij się, że podany użytkownik istnieje w twoim wystąpieniu bazy danych PostgreSQL i że hasło odpowiada obecnie przypisanemu użytkownikowi. Upewnij się, że wybrana metoda szyfrowania jest akceptowana przez wystąpienie bazy danych PostgreSQL na podstawie bieżącej konfiguracji. Jeśli metoda łączności sieciowej wystąpienia jest skonfigurowana pod kątem dostępu prywatnego (integracja z siecią wirtualną), użyj własnego środowiska Integration Runtime (IR), aby nawiązać z nim połączenie. Jeśli skonfigurowano dostęp publiczny (dozwolone adresy IP), zaleca się użycie środowiska Azure IR z zarządzaną siecią wirtualną i wdrożenie zarządzanego prywatnego punktu końcowego w celu nawiązania połączenia z wystąpieniem. Po skonfigurowaniu dostępu publicznego (dozwolonych adresów IP) mniej zalecana alternatywa polega na tworzeniu reguł zapory w wystąpieniu w celu zezwolenia na ruch pochodzący z adresów IP używanych przez środowisko Azure IR.
Powiązana zawartość
Aby uzyskać pomoc dotyczącą rozwiązywania problemów, wypróbuj następujące zasoby: