Řešení potíží s konektory služeb Azure Data Factory a Azure Synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek popisuje, jak řešit potíže s konektory ve službě Azure Data Factory a Azure Synapse Analytics.

Problémy specifické pro konektor

Můžete se podívat na stránky pro řešení potíží pro jednotlivé konektory a zobrazit problémy specifické pro něj s vysvětlením jejich příčin a doporučeními k jejich řešení.

• Azure Blob Storage
• Azure Cosmos DB (včetně konektoru Azure Cosmos DB for NoSQL)
• Azure Data Lake (Gen1 a Gen2)
• Azure Database for PostgreSQL
• Azure Files Storage
• Azure Synapse Analytics, Azure SQL Database a SQL Server
• DB2
• Formát textu s oddělovači
• Dynamics 365, Dataverse (Common Data Service) a Dynamics CRM
• FTP, SFTP a HTTP
• Hive
• Oracle
• Formát ORC
• Formát Parquet
• REST
• Salesforce a Cloud služeb Salesforce
• Seznam SharePointu Online
• Formát XML

Obecné chyby aktivity kopírování

Následující chyby jsou obecné pro aktivitu kopírování a můžou nastat u jakéhokoli konektoru.

Kód chyby: 2200 – UserErrorOdbcOperationFailed

• Zpráva: The underlying connection was closed: An unexpected error occurred on a send.

• Příčina: Obvykle to značí selhání ověřování během operací přenosu dat. K tomu může dojít, když vzdálená strana zavře přenosový proud.

• Doporučená aplikace:

  • Ověřte zdrojové připojení a otestujte ho, abyste měli jistotu, že funguje správně.
  • Zkontrolujte metodu ověřování použitou pro připojení.
  • Zkontrolujte nastavení konfigurace brány firewall pro službu Azure Cosmos DB a ujistěte se, že umožňují potřebný provoz.

Kód chyby: 20000 – JreNotFound

• Zpráva: 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.

• Příčina: Místní prostředí IR nemůže najít modul runtime Java. Modul runtime Java se vyžaduje pro čtení konkrétních zdrojů.

• Doporučení: Zkontrolujte prostředí Integration Runtime a přečtěte si téma Použití místního prostředí Integration Runtime.

Kód chyby: 20002 – JniException

• Zpráva: An error occurred when invoking Java Native Interface.

• Příčina: Pokud chybová zpráva obsahuje "Nelze vytvořit JVM: Návratový kód JNI [-6][Volání JNI selhalo: Neplatné argumenty." Možná příčina je, že JVM nelze vytvořit, protože jsou nastaveny některé neplatné (globální) argumenty.

• Doporučení: Přihlaste se k počítači, který je hostitelem každého uzlu místního prostředí Integration Runtime. Zkontrolujte, jestli je systémová proměnná správně nastavená, a to následujícím způsobem: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Restartujte všechny uzly prostředí Integration Runtime a pak znovu spusťte kanál.

Kód chyby: 20020 – WildcardPathSinkNotSupported

• Zpráva: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

• Příčina: Datová sada jímky nepodporuje hodnoty zástupných znaků.

• Doporučení: Zkontrolujte datovou sadu jímky a přepište cestu bez použití hodnoty se zástupným znakem.

Problém s FIPS

• Příznaky: aktivita Copy selže na počítači s místním prostředím IR s podporou FIPS s následující chybovou zprávou:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

• Příčina: K této chybě může dojít při kopírování dat pomocí konektorů, jako jsou Azure Blob, SFTP atd. Standard FIPS (Federal Information Processing Standards) definuje určitou sadu kryptografických algoritmů, které je možné použít. Pokud je na počítači povolený režim FIPS, některé kryptografické třídy, na nichž aktivita kopírování závisí, jsou v některých scénářích blokované.

• Řešení: Zjistěte , proč už nedoporučujeme režim FIPS, a vyhodnoťte, jestli můžete fiPS zakázat na počítači s místním prostředím IR.

  Případně pokud chcete obejít jenom FIPS a provést úspěšné spuštění aktivity, proveďte následující kroky:

  1. Otevřete složku, ve které je nainstalované místní prostředí IR. Cesta je obvykle C:\Program Files\Microsoft Integration Runtime <IR verze>\Shared.

  2. Otevřete soubor diawp.exe.config a pak na konci oddílu <runtime> přidejte <enforceFIPSPolicy enabled="false"/>, jak je znázorněno zde:

     

  3. Uložte soubor a restartujte počítač místního prostředí IR.

Kód chyby: 20150 – GetOAuth2AccessTokenErrorResponse

• Zpráva: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

• Příčina: ID klienta nebo tajný klíč klienta je neplatné a ověřování se nezdařilo na autorizačním serveru.

• Doporučení: Opravte všechna nastavení toku přihlašovacích údajů klienta OAuth2 vašeho autorizačního serveru.

Kód chyby: 20151 – FailedToGetOAuth2AccessToken

• Zpráva: Failed to get access token from your token endpoint. Error message: %errorMessage;.

• Příčina: Nastavení toku přihlašovacích údajů klienta OAuth2 je neplatné.

• Doporučení: Opravte všechna nastavení toku přihlašovacích údajů klienta OAuth2 vašeho autorizačního serveru.

Kód chyby: 20152 – OAuth2AccessTokenTypeNotSupported

• Zpráva: The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

• Příčina: Váš autorizační server není podporovaný.

• Doporučení: Použijte autorizační server, který může vracet tokeny s podporovanými typy tokenů.

Kód chyby: 20153 – OAuth2ClientIdColonNotAllowed

• Zpráva: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

• Příčina: ID klienta obsahuje neplatné dvojtečky znaků (:).

• Doporučení: Použijte platné ID klienta.

Kód chyby: 20523 – ManagedIdentityCredentialObjectNotSupported

• Zpráva: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

• Doporučení: Zkontrolujte podporovanou verzi a upgradujte prostředí Integration Runtime na vyšší verzi.

Kód chyby: 20551 – QueryMissingFormatSettingsInDataset

• Zpráva: The format settings are missing in dataset %dataSetName;.

• Příčina: Typ datové sady je Binary, který se nepodporuje.

• Doporučení: Místo toho použijte datovou sadu DelimitedText, Json, Avro, Orc nebo Parquet.

• Příčina: V datové sadě chybí nastavení formátu.

• Doporučení: Zrušte výběr binární kopie v datové sadě a nastavte správné nastavení formátu.

Kód chyby: 20552 – QueryUnsupportedCommandBehavior

• Zpráva: The command behavior "%behavior;" is not supported.

• Doporučení: Nepřidávejte chování příkazu jako parametr pro adresu URL požadavku rozhraní API GetSchema ve verzi Preview nebo GetSchema.

Kód chyby: 20701 – DataConsistencyFailedToGetSourceFileMetadata

• Zpráva: Failed to retrieve source file ('%name;') metadata to validate data consistency.

• Příčina: V úložišti dat jímky došlo k přechodnému problému nebo není povolené načítání metadat z úložiště dat jímky.

Kód chyby: 20703 – DataConsistencyFailedToGetSinkFileMetadata

• Zpráva: Failed to retrieve sink file ('%name;') metadata to validate data consistency.

• Příčina: V úložišti dat jímky došlo k přechodnému problému nebo není povolené načítání metadat z úložiště dat jímky.

Kód chyby: 20704 – DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

• Zpráva: Data consistency validation is not supported in current copy activity settings.

• Příčina: Ověření konzistence dat je podporováno pouze ve scénáři přímé binární kopie.

• Doporučení: Odeberte vlastnost validateDataConsistency v datové části aktivity kopírování.

Kód chyby: 20705 – DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

• Zpráva: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

• Doporučení: Zkontrolujte podporovanou verzi prostředí Integration Runtime a upgradujte ji na vyšší verzi nebo odeberte vlastnost validateDataConsistency z aktivit kopírování.

Kód chyby: 20741 – SkipMissingFileNotSupportedForNonDirectBinaryCopy

• Zpráva: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

• Doporučení: Odeberte fileMissing nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20742 – SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

• Zpráva: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.

• Doporučení: Odeberte dataInconsistency nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20743 – SkipForBiddenFileNotSupportedForNonDirectBinaryCopy

• Zpráva: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

• Doporučení: Odeberte souborForbidden nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20744 – SkipForBiddenFileNotSupportedForThisConnector

• Zpráva: Skip forbidden file is not supported for this connector: ('%connectorName;').

• Doporučení: Odeberte souborForbidden nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20745 – SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

• Zpráva: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

• Doporučení: Odeberte hodnotu invalidFileName nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20746 – SkipInvalidFileNameNotSupportedForSource

• Zpráva: Skip invalid file name is not supported for '%connectorName;' source.

• Doporučení: Odeberte hodnotu invalidFileName nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20747 – SkipInvalidFileNameNotSupportedForSink

• Zpráva: Skip invalid file name is not supported for '%connectorName;' sink.

• Doporučení: Odeberte hodnotu invalidFileName nastavení skipErrorFile v datové části aktivity kopírování.

Kód chyby: 20748 – SkipAllErrorFileNotSupportedForNonBinaryCopy

• Zpráva: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

• Doporučení: V nastavení skipErrorFile v datové části aktivity kopírování odeberte allErrorFile.

Kód chyby: 20771 – DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

• Zpráva: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

• Doporučení: Odeberte nastavení deleteFilesAfterCompletion nebo použijte přímou binární kopii.

Kód chyby: 20772 – DeleteFilesAfterCompletionNotSupportedForThisConnector

• Zpráva: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

• Doporučení: Odeberte nastavení deleteFilesAfterCompletion v datové části aktivity kopírování.

Kód chyby: 27002 – FailedToDownloadCustomPlugins

• Zpráva: Failed to download custom plugins.

• Příčina: Neplatné odkazy ke stažení nebo přechodné problémy s připojením

• Doporučení: Zkuste to znovu, pokud zpráva ukazuje, že se jedná o přechodný problém. Pokud problém přetrvává, obraťte se na tým podpory.

Obecné chyby konektoru

Kód chyby: 9611 – UserErrorOdbcInvalidQueryString

• Zpráva: The following ODBC Query is not valid: '%'.

• Příčina: Zadáte nesprávný nebo neplatný dotaz, který načte data nebo schémata.

• Doporučení: Ověřte platnost dotazu a může vracet data nebo schémata. Aktivitu skriptů použijte, pokud chcete spouštět skripty bez dotazu a vaše úložiště dat je podporováno. Případně zvažte použití uložené procedury, která vrací fiktivní výsledek ke spuštění nequery skriptů.

Kód chyby: 11775

• Zpráva: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

• Příčina: Přesná příčina závisí na textu vráceného v '%'. Pokud vypršel časový limit operace, může to být proto, že je instance PostgreSQL zastavená nebo protože metoda síťového připojení nakonfigurovaná pro vaši instanci neumožňuje připojení z vybraného prostředí Integration Runtime. Zadané uživatelské jméno nebo heslo je nesprávné. Pokud se jedná o 28P01: Ověření hesla uživatele <>se nezdařilo, znamená to, že zadaný uživatel v instanci neexistuje nebo že heslo není správné. Pokud je to 28000: žádná položka pg_hba.conf pro hostitele ###.#.#,##,, uživatel< "youruser>", databáze "<yourdatabase>", bez šifrování, znamená to, že vybraná metoda šifrování není kompatibilní s konfigurací serveru.

• Doporučení: Ověřte, že zadaný uživatel existuje ve vaší instanci PostgreSQL a že heslo odpovídá uživateli, který je aktuálně přiřazený danému uživateli. Ujistěte se, že vaše instance PostgreSQL přijímá vybranou metodu šifrování na základě aktuální konfigurace. Pokud je metoda síťového připojení vaší instance nakonfigurovaná pro privátní přístup (integrace virtuální sítě), připojte se k ní pomocí místního prostředí Integration Runtime (IR). Pokud je nakonfigurovaná pro veřejný přístup (povolené IP adresy), doporučujeme použít prostředí Azure IR se spravovanou virtuální sítí a nasadit spravovaný privátní koncový bod pro připojení k vaší instanci. Pokud je nakonfigurovaný pro veřejný přístup (povolené IP adresy), méně doporučenou alternativou je vytvoření pravidel brány firewall ve vaší instanci, která umožňují provoz pocházející z IP adres používaných prostředím Azure IR, který používáte.

Související obsah

Další nápovědu k řešení potíží najdete v těchto zdrojích informací:

• Blog věnovaný Data Factory
• Žádosti o funkce služby Data Factory
• Videa k Azure
• Stránka Microsoft Q&A
• Fórum Stack Overflow pro Službu Data Factory
• X informace o službě Data Factory