Problemen met Azure Data Factory en Azure Synapse Analytics-connectors oplossen

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u problemen met connectors in Azure Data Factory en Azure Synapse Analytics oplost.

Connectorspecifieke problemen

U kunt de pagina's voor probleemoplossing voor elke connector raadplegen om problemen te zien die specifiek zijn voor deze connector met uitleg over de oorzaken en aanbevelingen om ze op te lossen.

• Azure Blob-opslag
• Azure Cosmos DB (inclusief Azure Cosmos DB for NoSQL-connector)
• Azure Data Lake (Gen1 en Gen2)
• Azure Database for PostgreSQL
• Azure Files Storage
• Azure Synapse Analytics, Azure SQL Database en SQL Server
• DB2
• Tekstindeling met scheidingstekens
• Dynamics 365, Dataverse (Common Data Service) en Dynamics CRM
• FTP, SFTP en HTTP
• Hive
• Oracle
• ORC-indeling
• Parquet-indeling
• REST
• Salesforce en Salesforce Service Cloud
• SharePoint Online-lijst
• XML-indeling

Algemene fouten bij kopieeractiviteit

De volgende fouten zijn algemeen voor de kopieeractiviteit en kunnen optreden bij elke connector.

Foutcode: 20000

• Bericht: 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.

• Oorzaak: De zelf-hostende IR kan Java Runtime niet vinden. Java Runtime is vereist voor het lezen van bepaalde bronnen.

• Aanbeveling: Controleer uw Integration Runtime-omgeving, zie Zelf-hostende Integration Runtime gebruiken.

Foutcode: 20002

• Bericht: An error occurred when invoking Java Native Interface.

• Oorzaak: Als het foutbericht 'Kan JVM niet maken: JNI-retourcode [-6][JNI-aanroep is mislukt: ongeldige argumenten.]', is de mogelijke oorzaak dat JVM niet kan worden gemaakt omdat sommige ongeldige (globale) argumenten zijn ingesteld.

• Aanbeveling: Meld u aan bij de computer waarop elk knooppunt van uw zelf-hostende Integration Runtime wordt gehost. Controleer of de systeemvariabele correct is ingesteld, als volgt: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G Start alle integration runtime-knooppunten opnieuw en voer de pijplijn opnieuw uit.

Foutcode: 20020

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

• Oorzaak: De sink-gegevensset biedt geen ondersteuning voor jokertekenwaarden.

• Aanbeveling: Controleer de sinkgegevensset en herschrijf het pad zonder een jokertekenwaarde te gebruiken.

FIPS-probleem

• Symptomen: Copy-activiteit mislukt op een zelf-hostende IR-computer met FIPS met het volgende foutbericht:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

• Oorzaak: Deze fout kan optreden wanneer u gegevens kopieert met connectors zoals Azure Blob, SFTP, enzovoort. De Federal Information Processing Standards (FIPS) definieert een bepaalde set cryptografische algoritmen die mogen worden gebruikt. Wanneer de FIPS-modus op de computer is ingeschakeld, worden sommige cryptografische klassen waarvoor kopieeractiviteit afhankelijk is, in sommige scenario's geblokkeerd.

• Oplossing: ontdek waarom we 'FIPS-modus' niet meer aanbevelen en evalueren of u FIPS kunt uitschakelen op uw zelf-hostende IR-computer.

  Als u FIPS alleen wilt omzeilen en de uitvoering van de activiteit wilt voltooien, voert u de volgende stappen uit:

  1. Open de map waarin zelf-hostende IR is geïnstalleerd. Het pad is meestal C:\Program Files\Microsoft Integration Runtime <IR version>\Shared.

  2. Open het bestand diawp.exe.config en voeg <enforceFIPSPolicy enabled="false"/>vervolgens aan het einde van de <runtime> sectie toe, zoals hier wordt weergegeven:

     

  3. Sla het bestand op en start de zelf-hostende IR-computer opnieuw op.

Foutcode: 20150

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

• Oorzaak: uw client-id of clientgeheim is ongeldig en de verificatie is mislukt op uw autorisatieserver.

• Aanbeveling: Corrigeer alle instellingen voor de OAuth2-clientreferentiestroom van uw autorisatieserver.

Foutcode: 20151

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

• Oorzaak: instellingen voor OAuth2-clientreferentiestroom zijn ongeldig.

• Aanbeveling: Corrigeer alle instellingen voor de OAuth2-clientreferentiestroom van uw autorisatieserver.

Foutcode: 20152

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

• Oorzaak: uw autorisatieserver wordt niet ondersteund.

• Aanbeveling: Gebruik een autorisatieserver die tokens met ondersteunde tokentypen kan retourneren.

Foutcode: 20153

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

• Oorzaak: de client-id bevat de ongeldige dubbele punt (:).

• Aanbeveling: Gebruik een geldige client-id.

Foutcode: 20523

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

• Aanbeveling: Controleer de ondersteunde versie en werk de integration runtime bij naar een hogere versie.

Foutcode: 20551

• Bericht: The format settings are missing in dataset %dataSetName;.

• Oorzaak: Het gegevenssettype is Binair, dat niet wordt ondersteund.

• Aanbeveling: gebruik in plaats daarvan de gegevensset DelimitedText, Json, Avro, Orc of Parquet.

• Oorzaak: Voor de bestandsopslag ontbreken de indelingsinstellingen in de gegevensset.

• Aanbeveling: Hef de selectie van de binaire kopie in de gegevensset op en stel de juiste indelingsinstellingen in.

Foutcode: 20552

• Bericht: The command behavior "%behavior;" is not supported.

• Aanbeveling: voeg het opdrachtgedrag niet toe als een parameter voor preview- of GetSchema API-aanvraag-URL.

Foutcode: 20701

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

• Oorzaak: Er is een tijdelijk probleem in het sinkgegevensarchief of het ophalen van metagegevens uit het sink-gegevensarchief is niet toegestaan.

Foutcode: 20703

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

• Oorzaak: Er is een tijdelijk probleem in het sinkgegevensarchief of het ophalen van metagegevens uit het sink-gegevensarchief is niet toegestaan.

Foutcode: 20704

• Bericht: Data consistency validation is not supported in current copy activity settings.

• Oorzaak: De validatie van gegevensconsistentie wordt alleen ondersteund in het scenario voor directe binaire kopie.

• Aanbeveling: verwijder de eigenschap 'validateDataConsistency' in de nettolading van de kopieeractiviteit.

Foutcode: 20705

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

• Aanbeveling: Controleer de ondersteunde integration runtime-versie en werk deze bij naar een hogere versie of verwijder de eigenschap validateDataConsistency uit kopieeractiviteiten.

Foutcode: 20741

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

• Aanbeveling: Verwijder fileMissing van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20742

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

• Aanbeveling: Verwijder 'dataInconsistency' van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20743

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

• Aanbeveling: Verwijder fileForbidden van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20744

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

• Aanbeveling: Verwijder fileForbidden van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20745

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

• Aanbeveling: Verwijder 'invalidFileName' van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20746

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

• Aanbeveling: Verwijder 'invalidFileName' van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20747

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

• Aanbeveling: Verwijder 'invalidFileName' van de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20748

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

• Aanbeveling: verwijder 'allErrorFile' in de instelling skipErrorFile in de nettolading van de kopieeractiviteit.

Foutcode: 20771

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

• Aanbeveling: verwijder de instelling deleteFilesAfterCompletion of gebruik directe binaire kopie.

Foutcode: 20772

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

• Aanbeveling: Verwijder de instelling deleteFilesAfterCompletion in de nettolading van de kopieeractiviteit.

Foutcode: 27002

• Bericht: Failed to download custom plugins.

• Oorzaak: Ongeldige downloadkoppelingen of tijdelijke verbindingsproblemen.

• Aanbeveling: Probeer het opnieuw als in het bericht wordt aangegeven dat het een tijdelijk probleem is. Neem contact op met het ondersteuningsteam als het probleem zich blijft voordoen.

Algemene connectorfouten

Foutcode: 9611

• Bericht: The following ODBC Query is not valid: '%'.

• Oorzaak: U geeft een verkeerde of ongeldige query op om de gegevens/schema's op te halen.

• Aanbeveling: Controleer of uw query geldig is en kan gegevens/schema's retourneren. Gebruik scriptactiviteit als u niet-queryscripts wilt uitvoeren en uw gegevensarchief wordt ondersteund. U kunt ook een opgeslagen procedure gebruiken die een dummy-resultaat retourneert om uw niet-queryscripts uit te voeren.

Foutcode: 11775

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

• Oorzaak: De exacte oorzaak is afhankelijk van de tekst die wordt geretourneerd in '%'. Als er een time-out optreedt voor de bewerking, kan dit komen doordat het exemplaar van PostgreSQL is gestopt of omdat de netwerkverbindingsmethode die is geconfigureerd voor uw exemplaar, geen verbindingen van integration runtime toestaat. De opgegeven gebruiker of het opgegeven wachtwoord is onjuist. Als dit 28P01 is : wachtwoordverificatie is mislukt voor de gebruiker <die uw gebruiker gebruikt>, betekent dit dat de opgegeven gebruiker niet bestaat in het exemplaar of dat het wachtwoord onjuist is. Als dit 28000 is : geen pg_hba.conf-vermelding voor host "##.#.##.##.##", gebruiker "<youruser>", database "<yourdatabase>", geen versleuteling, betekent dit dat de geselecteerde versleutelingsmethode niet compatibel is met de configuratie van de server.

• Aanbeveling: controleer of de opgegeven gebruiker bestaat in uw exemplaar van PostgreSQL en of het wachtwoord overeenkomt met het wachtwoord dat momenteel aan die gebruiker is toegewezen. Zorg ervoor dat de geselecteerde versleutelingsmethode wordt geaccepteerd door uw exemplaar van PostgreSQL, op basis van de huidige configuratie. Als de netwerkverbindingsmethode van uw exemplaar is geconfigureerd voor privétoegang (integratie van virtueel netwerk), gebruikt u een zelf-hostende Integration Runtime (IR) om er verbinding mee te maken. Als deze is geconfigureerd voor openbare toegang (toegestane IP-adressen), is het raadzaam om een Azure IR met een beheerd virtueel netwerk te gebruiken en een beheerd privé-eindpunt te implementeren om verbinding te maken met uw exemplaar. Wanneer deze is geconfigureerd voor openbare toegang (toegestane IP-adressen) bestaat een minder aanbevolen alternatief uit het maken van firewallregels in uw exemplaar om verkeer toe te staan dat afkomstig is van de IP-adressen die worden gebruikt door de Azure IR die u gebruikt.

Gerelateerde inhoud

Voor meer hulp bij het oplossen van problemen kunt u de volgende bronnen proberen:

• Data Factory-blog
• Data Factory-functieaanvragen
• Azure-video's
• Microsoft Q&A-pagina
• Stack Overflow-forum voor Data Factory
• X-informatie over Data Factory