Problemen met Azure Data Factory- en Synapse-pijplijnen 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 worden algemene probleemoplossingsmethoden voor externe controleactiviteiten in Azure Data Factory- en Synapse-pijplijnen besproken.

Connector- en kopieeractiviteiten

Raadpleeg het artikel Probleemoplossing Verbinding maken ors voor connectorproblemen zoals een fout bij het gebruik van de kopieeractiviteit.

Azure Databricks

Foutcode: 3200

• Bericht: Fout 403.

• Oorzaak: The Databricks access token has expired.

• Aanbeveling: Standaard is het Azure Databricks-toegangstoken 90 dagen geldig. Maak een nieuw token en werk de gekoppelde service bij.

Foutcode: 3201

• Bericht: Missing required field: settings.task.notebook_task.notebook_path.

• Oorzaak: Bad authoring: Notebook path not specified correctly.

• Aanbeveling: Geef het notebookpad op in de Databricks-activiteit.

• Bericht: Cluster... does not exist.

• Oorzaak: Authoring error: Databricks cluster does not exist or has been deleted.

• Aanbeveling: Controleer of het Databricks-cluster bestaat.

• Bericht: Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.

• Oorzaak: Bad authoring.

• Aanbeveling: Geef absolute paden op voor werkruimteadresseringsschema's of dbfs:/folder/subfolder/foo.py voor bestanden die zijn opgeslagen in het Databricks File System (DFS).

• Bericht: {0} LinkedService should have domain and accessToken as required properties.

• Oorzaak: Bad authoring.

• Aanbeveling: Controleer de definitie van de gekoppelde service.

• Bericht: {0} LinkedService should specify either existing cluster ID or new cluster information for creation.

• Oorzaak: Bad authoring.

• Aanbeveling: Controleer de definitie van de gekoppelde service.

• Bericht: Node type Standard_D16S_v3 is not supported. Supported node types: Standard_DS3_v2, Standard_DS4_v2, Standard_DS5_v2, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D64s_v3, Standard_D3_v2, Standard_D8_v3, Standard_D16_v3, Standard_D32_v3, Standard_D64_v3, Standard_D12_v2, Standard_D13_v2, Standard_D14_v2, Standard_D15_v2, Standard_DS12_v2, Standard_DS13_v2, Standard_DS14_v2, Standard_DS15_v2, Standard_E8s_v3, Standard_E16s_v3, Standard_E32s_v3, Standard_E64s_v3, Standard_L4s, Standard_L8s, Standard_L16s, Standard_L32s, Standard_F4s, Standard_F8s, Standard_F16s, Standard_H16, Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_NC12, Standard_NC24, Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_L8s_v2, Standard_L16s_v2, Standard_L32s_v2, Standard_L64s_v2, Standard_L80s_v2.

• Oorzaak: Bad authoring.

• Aanbeveling: Raadpleeg het foutbericht.

Foutcode: 3202

• Bericht: There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.

• Oorzaak: Too many Databricks runs in an hour.

• Aanbeveling: Controleer alle pijplijnen die gebruikmaken van deze Databricks-werkruimte voor het maken van hun taak. Als er te veel Databricks-pijplijnen worden gestart, migreert u enkele pijplijnen naar een nieuwe werkruimte.

• Bericht: Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.

• Oorzaak: Authoring error: No value provided for the parameter.

• Aanbeveling: Inspecteer de JSON van de pijplijn en zorg ervoor dat alle parameters in het baseParameters-notebook een lege waarde opgeven.

• Bericht: User: SimpleUserContext{userId=..., name=user@company.com, orgId=...} is not authorized to access cluster.

• Oorzaak: De gebruiker die het toegangstoken heeft gegenereerd, heeft geen toegang tot het Databricks-cluster dat is opgegeven in de gekoppelde service.

• Aanbeveling: Zorg ervoor dat de gebruiker over de vereiste machtigingen in de werkruimte beschikt.

• Bericht: Job is not fully initialized yet. Please retry later.

• Oorzaak: De taak is niet geïnitialiseerd.

• Aanbeveling: Wacht en probeer het later opnieuw.

Foutcode: 3203

• Bericht: The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.

• Oorzaak: Het cluster is beëindigd. Voor interactieve clusters kan dit probleem een racevoorwaarde zijn.

• Aanbeveling: Gebruik taakclusters om deze fout te voorkomen.

Foutcode: 3204

• Bericht: Job execution failed.

• Oorzaak: Foutberichten geven verschillende problemen aan, zoals een onverwachte clusterstatus of een specifieke activiteit. Vaak wordt er geen foutbericht weergegeven.

• Aanbeveling: N/B

Foutcode: 3208

• Bericht: An error occurred while sending the request.

• Oorzaak: De netwerkverbinding met de Databricks-service is onderbroken.

• Aanbeveling: Als u een zelf-hostende Integration Runtime gebruikt, moet u ervoor zorgen dat de netwerkverbinding betrouwbaar is vanaf de integration runtime-knooppunten. Als u Azure Integration Runtime gebruikt, werkt het meestal opnieuw.

De Booleaanse uitvoer wordt gestart als tekenreeks in plaats van verwacht int

• Symptomen: De Booleaanse uitvoer wordt gestart als tekenreeks (bijvoorbeeld "0" of "1") in plaats van verwachte int (bijvoorbeeld 0 of 1).

  

  U hebt deze wijziging gezien op 28 september 2021 om ongeveer 9:00 uur IST toen uw pijplijn die vertrouwt op deze uitvoer, is mislukt. Er is geen wijziging aangebracht in de pijplijn en de Booleaanse uitvoergegevens zijn zoals verwacht vóór de fout aangekomen.

  

• Oorzaak: Dit probleem wordt veroorzaakt door een recente wijziging. Dit is standaard. Als het resultaat na de wijziging een getal is dat begint met nul, converteert Azure Data Factory het getal naar de octale waarde, wat een fout is. Dit getal is altijd 0 of 1, wat nooit problemen heeft veroorzaakt vóór de wijziging. Om de octale conversie te herstellen, wordt de tekenreeksuitvoer doorgegeven vanuit de Notebook-uitvoering.

• Aanbeveling: wijzig de if-voorwaarde in iets als if(value=="0").

Azure Data Lake Analytics

De volgende tabel is van toepassing op U-SQL.

Foutcode: 2709

• Bericht: The access token is from the wrong tenant.

• Oorzaak: Onjuiste Microsoft Entra-tenant.

• Aanbeveling: Onjuiste Microsoft Entra-tenant.

• Bericht: We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.

• Oorzaak: Deze fout wordt veroorzaakt door beperking in Data Lake Analytics.

• Aanbeveling: Verminder het aantal ingediende taken naar Data Lake Analytics. Wijzig triggers en gelijktijdigheidsinstellingen voor activiteiten of verhoog de limieten voor Data Lake Analytics.

• Bericht: This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.

• Oorzaak: Deze fout wordt veroorzaakt door beperking in Data Lake Analytics.

• Aanbeveling: Verminder het aantal ingediende taken naar Data Lake Analytics. Wijzig triggers en gelijktijdigheidsinstellingen voor activiteiten of verhoog de limieten voor Data Lake Analytics.

Foutcode: 2705

• Bericht: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

• Oorzaak: De service-principal of het certificaat heeft geen toegang tot het bestand in de opslag.

• Aanbeveling: Controleer of de service-principal of het certificaat dat de gebruiker biedt voor Data Lake Analytics-taken toegang heeft tot zowel het Data Lake Analytics-account als het standaard Data Lake Storage-exemplaar uit de hoofdmap.

Foutcode: 2711

• Bericht: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

• Oorzaak: De service-principal of het certificaat heeft geen toegang tot het bestand in de opslag.

• Aanbeveling: Controleer of de service-principal of het certificaat dat de gebruiker biedt voor Data Lake Analytics-taken toegang heeft tot zowel het Data Lake Analytics-account als het standaard Data Lake Storage-exemplaar uit de hoofdmap.

• Bericht: Cannot find the 'Azure Data Lake Store' file or folder.

• Oorzaak: Het pad naar het U-SQL-bestand is onjuist of de gekoppelde servicereferenties hebben geen toegang.

• Aanbeveling: Controleer het pad en de referenties die zijn opgegeven in de gekoppelde service.

Foutcode: 2704

• Bericht: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

• Oorzaak: De service-principal of het certificaat heeft geen toegang tot het bestand in de opslag.

• Aanbeveling: Controleer of de service-principal of het certificaat dat de gebruiker biedt voor Data Lake Analytics-taken toegang heeft tot zowel het Data Lake Analytics-account als het standaard Data Lake Storage-exemplaar uit de hoofdmap.

Foutcode: 2707

• Bericht: Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.

• Oorzaak: Het Data Lake Analytics-account in de gekoppelde service is onjuist.

• Aanbeveling: Controleer of het juiste account is opgegeven.

Foutcode: 2703

• Bericht: Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").

• Oorzaak: De fout is afkomstig van Data Lake Analytics.

• Aanbeveling: de taak is verzonden naar Data Lake Analytics en het script daar is mislukt. Onderzoek in Data Lake Analytics. Ga in de portal naar het Data Lake Analytics-account en zoek de taak met behulp van de run-id van de Data Factory-activiteit (gebruik de pijplijnuitvoerings-id niet). De taak daar biedt meer informatie over de fout en helpt u bij het oplossen van problemen.

  Als de oplossing niet duidelijk is, neemt u contact op met het ondersteuningsteam van Data Lake Analytics en geeft u de taak Universal Resource Locator (URL) op, die uw accountnaam en de taak-id bevat.

Azure Functions

Foutcode: 3602

• Bericht: Invalid HttpMethod: '%method;'.

• Oorzaak: De Httpmethod die is opgegeven in de nettolading van de activiteit, wordt niet ondersteund door azure-functieactiviteit.

• Aanbeveling: De ondersteunde Httpmethods zijn: PUT, POST, GET, DELETE, OPTIONS, HEAD en TRACE.

Foutcode: 3603

• Bericht: Response Content is not a valid JObject.

• Oorzaak: De Azure-functie die is aangeroepen, heeft geen JSON-nettolading in het antwoord geretourneerd. Azure Data Factory- en Synapse-pijplijn Azure-functieactiviteit bieden alleen ondersteuning voor JSON-antwoordinhoud.

• Aanbeveling: Werk de Azure-functie bij om een geldige JSON-nettolading te retourneren, zoals een C#-functie, kan retourneren (ActionResult)new OkObjectResult("{\"Id\":\"123\"}");

Foutcode: 3606

• Bericht: Azure-functieactiviteit ontbreekt in functiesleutel.

• Oorzaak: De azure-functieactiviteitsdefinitie is niet voltooid.

• Aanbeveling: Controleer of de JSON-definitie van de azure-functieactiviteit een eigenschap heeft met de naam functionKey.

Foutcode: 3607

• Bericht: Azure function activity missing function name.

• Oorzaak: De azure-functieactiviteitsdefinitie is niet voltooid.

• Aanbeveling: Controleer of de JSON-definitie van de azure-functieactiviteit een eigenschap heeft met de naam functionName.

Foutcode: 3608

• Bericht: Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.

• Oorzaak: De details van de Azure-functie in de activiteitsdefinitie zijn mogelijk onjuist.

• Aanbeveling: Corrigeer de details van de Azure-functie en probeer het opnieuw.

Foutcode: 3609

• Bericht: Azure function activity missing functionAppUrl.

• Oorzaak: De azure-functieactiviteitsdefinitie is niet voltooid.

• Aanbeveling: Controleer of de JSON-definitie van de azure-functieactiviteit een eigenschap heeft met de naam functionAppUrl.

Foutcode: 3610

• Bericht: There was an error while calling endpoint.

• Oorzaak: De functie-URL is mogelijk onjuist.

• Aanbeveling: Controleer of de waarde voor functionAppUrl de JSON van de activiteit juist is en probeer het opnieuw.

Foutcode: 3611

• Bericht: Azure function activity missing Method in JSON.

• Oorzaak: De azure-functieactiviteitsdefinitie is niet voltooid.

• Aanbeveling: Controleer of de JSON-definitie van de azure-functieactiviteit een eigenschap heeft met de naam method.

Foutcode: 3612

• Bericht: Azure function activity missing LinkedService definition in JSON.

• Oorzaak: De azure-functieactiviteitsdefinitie is niet voltooid.

• Aanbeveling: Controleer of de JSON-definitie van de JSON-invoerfunctieactiviteit gekoppelde servicegegevens bevat.

Azure Machine Learning

Foutcode: 4101

• Bericht: AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.

• Oorzaak: Ongeldige indeling of ontbrekende definitie van eigenschap %propertyName;.

• Aanbeveling: Controleer of de activiteit %activityName; de eigenschap %propertyName; heeft gedefinieerd met de juiste gegevens.

Foutcode: 4110

• Bericht: AzureMLExecutePipeline activity missing LinkedService definition in JSON.

• Oorzaak: De azureMLExecutePipeline-activiteitsdefinitie is niet voltooid.

• Aanbeveling: Controleer of de JSON-definitie van de ingevoerde AzureMLExecutePipeline-activiteit correct gekoppelde servicegegevens bevat.

Foutcode: 4111

• Bericht: AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.

• Oorzaak: Onjuiste activiteitsdefinitie.

• Aanbeveling: Controleer of de JSON-definitie van de ingevoerde AzureMLExecutePipeline-activiteit correct gekoppelde servicegegevens bevat.

Foutcode: 4112

• Bericht: AzureMLService linked service has invalid value for property '%propertyName;'.

• Oorzaak: Ongeldige indeling of ontbrekende definitie van eigenschap %propertyName;.

• Aanbeveling: Controleer of de gekoppelde service de eigenschap %propertyName; heeft gedefinieerd met de juiste gegevens.

Foutcode: 4121

• Bericht: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

• Oorzaak: De referentie die wordt gebruikt voor toegang tot Azure Machine Learning, is verlopen.

• Aanbeveling: Controleer of de referentie geldig is en probeer het opnieuw.

Foutcode: 4122

• Bericht: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

• Oorzaak: de referentie die is opgegeven in de gekoppelde Azure Machine Learning-service is ongeldig of heeft geen machtiging voor de bewerking.

• Aanbeveling: controleer of de referentie in de gekoppelde service geldig is en gemachtigd is voor toegang tot Azure Machine Learning.

Foutcode: 4123

• Bericht: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

• Oorzaak: De eigenschappen van de activiteit, zoals pipelineParameters ongeldig zijn voor de Azure Machine Learning-pijplijn (ML).

• Aanbeveling: controleer of de waarde van activiteitseigenschappen overeenkomt met de verwachte nettolading van de gepubliceerde Azure Machine Learning-pijplijn die is opgegeven in de gekoppelde service.

Foutcode: 4124

• Bericht: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

• Oorzaak: Het gepubliceerde Azure Machine Learning-pijplijneindpunt bestaat niet.

• Aanbeveling: Controleer of het gepubliceerde Azure Machine Learning-pijplijneindpunt dat is opgegeven in de gekoppelde service, bestaat in Azure Machine Learning.

Foutcode: 4125

• Bericht: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

• Oorzaak: Er is een serverfout op Azure Machine Learning.

• Aanbeveling: probeer het later opnieuw. Neem contact op met het Azure Machine Learning-team voor hulp als het probleem zich blijft voordoen.

Foutcode: 4126

• Bericht: Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Azure Machine Learning for more error logs.

• Oorzaak: De uitvoering van de Azure Machine Learning-pijplijn is mislukt.

• Aanbeveling: Controleer Azure Machine Learning op meer foutenlogboeken en herstel vervolgens de ML-pijplijn.

Azure Synapse Analytics

Foutcode: 3250

• Bericht: There are not enough resources available in the workspace, details: '%errorMessage;'

• Oorzaak: Onvoldoende resources

• Aanbeveling: Probeer de actieve taak(en) in de werkruimte te beëindigen, het aantal aangevraagde vCores te verminderen, het quotum van de werkruimte te verhogen of een andere werkruimte te gebruiken.

Foutcode: 3251

• Bericht: There are not enough resources available in the pool, details: '%errorMessage;'

• Oorzaak: Onvoldoende resources

• Aanbeveling: Probeer de actieve taak(en) in de pool te beëindigen, het aantal aangevraagde vCores te verminderen, de maximale grootte van de pool te verhogen of een andere pool te gebruiken.

Foutcode: 3252

• Bericht: There are not enough vcores available for your spark job, details: '%errorMessage;'

• Oorzaak: Onvoldoende virtuele kernen

• Aanbeveling: Verminder het aantal aangevraagde vCores of verhoog uw vCore-quotum. Zie De belangrijkste concepten van Apache Spark voor meer informatie.

Foutcode: 3253

• Bericht: There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.

• Oorzaak: drempelwaarde voor bandbreedtebeperking is bereikt.

• Aanbeveling: voer de aanvraag opnieuw uit na een wachttijd.

Foutcode: 3254

• Bericht: AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.

• Oorzaak: Ongeldige indeling of ontbrekende definitie van eigenschap %propertyName;.

• Aanbeveling: controleer of de gekoppelde service de eigenschap %propertyName heeft die is gedefinieerd met de juiste gegevens.

Gemeenschappelijk

Foutcode: 2103

• Bericht: Please provide value for the required property '%propertyName;'.

• Oorzaak: De vereiste waarde voor de eigenschap is niet opgegeven.

• Aanbeveling: Geef de waarde van het bericht op en probeer het opnieuw.

Foutcode: 2104

• Bericht: The type of the property '%propertyName;' is incorrect.

• Oorzaak: Het opgegeven eigenschapstype is niet juist.

• Aanbeveling: Los het type van de eigenschap op en probeer het opnieuw.

Foutcode: 2105

• Bericht: An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.

• Oorzaak: De waarde voor de eigenschap is ongeldig of heeft niet de verwachte indeling.

• Aanbeveling: Raadpleeg de documentatie voor de eigenschap en controleer of de opgegeven waarde de juiste indeling en het juiste type bevat.

Foutcode: 2106

• Bericht: The storage connection string is invalid. %errorMessage;

• Oorzaak: de verbindingsreeks voor de opslag is ongeldig of heeft een onjuiste indeling.

• Aanbeveling: Ga naar Azure Portal en zoek uw opslag, kopieer en plak de verbindingsreeks vervolgens in uw gekoppelde service en probeer het opnieuw.

Foutcode: 2110

• Bericht: The linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.

• Oorzaak: De gekoppelde service die is opgegeven in de activiteit, is onjuist.

• Aanbeveling: Controleer of het gekoppelde servicetype een van de ondersteunde typen voor de activiteit is. Het gekoppelde servicetype voor HDI-activiteiten kan bijvoorbeeld HDInsight of HDInsightOnDemand zijn.

Foutcode: 2111

• Bericht: The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.

• Oorzaak: Het type van de opgegeven eigenschap is niet juist.

• Aanbeveling: Herstel het eigenschapstype en probeer het opnieuw.

Foutcode: 2112

• Bericht: The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.

• Oorzaak: het cloudtype wordt niet ondersteund of kan niet worden bepaald voor opslag vanuit het EndpointSuffix.

• Aanbeveling: Gebruik opslag in een andere cloud en probeer het opnieuw.

Aanpassen

De volgende tabel is van toepassing op Azure Batch.

Foutcode: 2500

• Bericht: Hit unexpected exception and execution failed.

• Oorzaak: Can't launch command, or the program returned an error code.

• Aanbeveling: Zorg ervoor dat het uitvoerbare bestand bestaat. Als het programma is gestart, controleert u of stdout.txt en stderr.txt zijn geüpload naar het opslagaccount. Het is een goede gewoonte om logboeken in uw code op te nemen voor foutopsporing.

Foutcode: 2501

• Bericht: Cannot access user batch account; please check batch account settings.

• Oorzaak: Onjuiste Batch-toegangssleutel of groepsnaam.

• Aanbeveling: Controleer de naam van de pool en de Batch-toegangssleutel in de gekoppelde service.

Foutcode: 2502

• Bericht: Cannot access user storage account; please check storage account settings.

• Oorzaak: Onjuiste naam van opslagaccount of toegangssleutel.

• Aanbeveling: Controleer de naam van het opslagaccount en de toegangssleutel in de gekoppelde service.

Foutcode: 2504

• Bericht: Operation returned an invalid status code 'BadRequest'.

• Oorzaak: Te veel bestanden in de folderPath aangepaste activiteit. De totale grootte mag resourceFiles niet langer zijn dan 32.768 tekens.

• Aanbeveling: Verwijder overbodige bestanden of zip ze en voeg een opdracht uitpakken toe om ze te extraheren.

  Gebruik bijvoorbeeld powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe

Foutcode: 2505

• Bericht: Cannot create Shared Access Signature unless Account Key credentials are used.

• Oorzaak: Aangepaste activiteiten ondersteunen alleen opslagaccounts die gebruikmaken van een toegangssleutel.

• Aanbeveling: Raadpleeg de beschrijving van de fout.

Foutcode: 2507

• Bericht: The folder path does not exist or is empty: ...

• Oorzaak: Er bevinden zich geen bestanden in het opslagaccount op het opgegeven pad.

• Aanbeveling: het mappad moet de uitvoerbare bestanden bevatten die u wilt uitvoeren.

Foutcode: 2508

• Bericht: There are duplicate files in the resource folder.

• Oorzaak: Meerdere bestanden met dezelfde naam bevinden zich in verschillende submappen van folderPath.

• Aanbeveling: Aangepaste activiteiten platmaken mapstructuur onder folderPath. Als u de mapstructuur wilt behouden, zipt u de bestanden en extraheert u deze in Azure Batch met behulp van een opdracht uitpakken.

  Gebruik bijvoorbeeld powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe

Foutcode: 2509

• Bericht: Batch url ... is invalid; it must be in Uri format.

• Oorzaak: Batch-URL's moeten vergelijkbaar zijn met https://mybatchaccount.eastus.batch.azure.com

• Aanbeveling: Raadpleeg de beschrijving van de fout.

Foutcode: 2510

• Bericht: An error occurred while sending the request.

• Oorzaak: de batch-URL is ongeldig.

• Aanbeveling: Controleer de batch-URL.

HDInsight

Foutcode: 206

• Bericht: The batch ID for Spark job is invalid. Please retry your job.

• Oorzaak: Er is een intern probleem met de service die deze fout heeft veroorzaakt.

• Aanbeveling: dit probleem kan tijdelijk zijn. Probeer uw taak na enige tijd opnieuw.

Foutcode: 207

• Bericht: Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.

• Oorzaak: er is een interne fout opgetreden tijdens het bepalen van de regio van het primaire opslagaccount.

• Aanbeveling: Probeer een andere opslag.

Foutcode: 208

• Bericht: Service Principal or the MSI authenticator are not instantiated. Please consider providing a Service Principal in the HDI on demand linked service which has permissions to create an HDInsight cluster in the provided subscription and try again.

• Oorzaak: er is een interne fout opgetreden tijdens het lezen van de service-principal of het instantiëren van de MSI-verificatie.

• Aanbeveling: Overweeg een service-principal op te geven die machtigingen heeft om een HDInsight-cluster te maken in het opgegeven abonnement en probeer het opnieuw. Controleer of de beheeridentiteiten juist zijn ingesteld.

Foutcode: 2300

• Bericht: Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.

• Oorzaak: Het foutbericht bevat een bericht dat lijkt op The remote name could not be resolved.. De opgegeven cluster-URI is mogelijk ongeldig.

• Aanbeveling: controleer of het cluster niet is verwijderd en of de opgegeven URI juist is. Wanneer u de URI in een browser opent, ziet u de Ambari-gebruikersinterface. Als het cluster zich in een virtueel netwerk bevindt, moet de URI de privé-URI zijn. Als u deze wilt openen, gebruikt u een virtuele machine (VM) die deel uitmaakt van hetzelfde virtuele netwerk.

  Zie Rechtstreeks verbinding maken met Apache Hadoop-services voor meer informatie.

• Oorzaak: Als het foutbericht een bericht bevat dat vergelijkbaar is met A task was canceled., is er een time-out opgetreden bij het indienen van de taak.

• Aanbeveling: Het probleem kan algemene HDInsight-connectiviteit of netwerkverbinding zijn. Controleer eerst of de GEBRUIKERSinterface van HDInsight Ambari beschikbaar is in elke browser. Controleer vervolgens of uw referenties nog geldig zijn.

  Als u een zelf-hostende Integrated Runtime (IR) gebruikt, voert u deze stap uit vanaf de VM of computer waarop de zelf-hostende IR is geïnstalleerd. Probeer de taak vervolgens opnieuw in te dienen.

  Lees de Ambari-webgebruikersinterface voor meer informatie.

• Oorzaak: Wanneer het foutbericht een bericht bevat dat lijkt op User admin is locked out in Ambari of Unauthorized: Ambari user name or password is incorrect, zijn de referenties voor HDInsight onjuist of verlopen.

• Aanbeveling: Corrigeer de referenties en implementeer de gekoppelde service opnieuw. Controleer eerst of de referenties in HDInsight werken door de cluster-URI in een browser te openen en u aan te melden. Als de referenties niet werken, kunt u deze opnieuw instellen vanuit Azure Portal.

  Voor ESP-cluster stelt u het wachtwoord opnieuw in via selfservice voor wachtwoordherstel.

• Oorzaak: Wanneer het foutbericht een bericht bevat dat lijkt op 502 - Web server received an invalid response while acting as a gateway or proxy server, wordt deze fout geretourneerd door de HDInsight-service.

• Aanbeveling: Er treedt vaak een 502-fout op wanneer uw Ambari-serverproces is afgesloten. U kunt de Ambari-services opnieuw starten door het hoofdknooppunt opnieuw op te starten.

  1. Verbinding maken naar een van uw knooppunten in HDInsight met behulp van SSH.

  2. Identificeer uw actieve hoofdknooppunthost door uit te voeren ping headnodehost.

  3. Verbinding maken naar het actieve hoofdknooppunt als Ambari-server zich op het actieve hoofdknooppunt bevindt met behulp van SSH.

  4. Start het actieve hoofdknooppunt opnieuw op.

     Raadpleeg de documentatie voor het oplossen van problemen met Azure HDInsight voor meer informatie. Voorbeeld:

     • 502-fout in de Ambari-gebruikersinterface
     • RpcTimeoutException voor Apache Spark-riftserver
     • Problemen met ongeldige gatewayfouten in Application Gateway oplossen.

• Oorzaak: Wanneer het foutbericht een bericht bevat dat lijkt op Unable to service the submit job request as templeton service is busy with too many submit job requests of Queue root.joblauncher already has 500 applications, cannot accept submission of application, worden er te veel taken tegelijk naar HDInsight verzonden.

• Aanbeveling: Beperk het aantal gelijktijdige taken dat is verzonden naar HDInsight. Raadpleeg gelijktijdigheid van activiteiten als de taken door dezelfde activiteit worden verzonden. Wijzig de triggers zodat de gelijktijdige pijplijnuitvoeringen in de loop van de tijd worden verdeeld.

  Raadpleeg de HDInsight-documentatie om aan te passen templeton.parallellism.job.submit zoals de fout suggereert.

Foutcode: 2301

• Bericht: Could not get the status of the application '%physicalJobId;' from the HDInsight service. Received the following error: %message;. Please refer to HDInsight troubleshooting documentation or contact their support for further assistance.

• Oorzaak: HDInsight-cluster of -service heeft problemen.

• Aanbeveling: deze fout treedt op wanneer de service geen antwoord van het HDInsight-cluster ontvangt wanneer de status van de actieve taak wordt aangevraagd. Dit probleem kan zich in het cluster zelf bevinden of de HDInsight-service kan een storing hebben.

  Raadpleeg de documentatie voor het oplossen van problemen met HDInsight of neem contact op met De ondersteuning van Microsoft voor meer hulp.

Foutcode: 2302

• Bericht: Hadoop job failed with exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Contact HDInsight team for further support.

• Oorzaak: de taak is verzonden naar het HDI-cluster en is daar mislukt.

• Aanbeveling:

1. Controleer de Ambari-gebruikersinterface:
   1. Zorg ervoor dat alle services nog actief zijn.
   2. Controleer vanuit de Ambari-gebruikersinterface de sectie met waarschuwingen in uw dashboard.
      1. Zie Een cluster beheren en bewaken voor meer informatie over waarschuwingen en oplossingen voor waarschuwingen.
   3. Controleer uw YARN-geheugen. Als uw YARN-geheugen hoog is, kan de verwerking van uw taken worden vertraagd. Als er onvoldoende resources zijn voor uw Spark-toepassing/taak, schaalt u het cluster zodanig dat het cluster voldoende geheugen en kernen heeft.
2. Voer een voorbeeldtesttaak uit.
   1. Als u dezelfde taak uitvoert op de HDInsight-back-end, controleert u of deze is geslaagd. Zie De MapReduce-voorbeelden uitvoeren die zijn opgenomen in HDInsight voor voorbeelden van voorbeelduitvoeringen
3. Als de taak nog steeds is mislukt in HDInsight, controleert u de toepassingslogboeken en -informatie die u aan ondersteuning wilt bieden:
   1. Controleer of de taak is ingediend bij YARN. Als de taak niet naar yarn is verzonden, gebruikt u --master yarn.
   2. Als de uitvoering van de toepassing is voltooid, verzamelt u de begin- en eindtijd van de YARN-toepassing. Als de uitvoering van de toepassing niet is voltooid, verzamelt u de begintijd/starttijd.
   3. Controleer en verzamel het toepassingslogboek met yarn logs -applicationId <Insert_Your_Application_ID>.
   4. Controleer en verzamel de yarn Resource Manager-logboeken onder de /var/log/hadoop-yarn/yarn map.
   5. Als deze stappen niet voldoende zijn om het probleem op te lossen, neemt u contact op met het Azure HDInsight-team voor ondersteuning en geeft u de bovenstaande logboeken en tijdstempels op.

Foutcode: 2303

• Bericht: Hadoop job failed with transient exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Try again or contact HDInsight team for further support.

• Oorzaak: de taak is verzonden naar het HDI-cluster en is daar mislukt.

• Aanbeveling:

1. Controleer de Ambari-gebruikersinterface:
   1. Zorg ervoor dat alle services nog actief zijn.
   2. Controleer vanuit de Ambari-gebruikersinterface de sectie met waarschuwingen in uw dashboard.
      1. Zie Een cluster beheren en bewaken voor meer informatie over waarschuwingen en oplossingen voor waarschuwingen.
   3. Controleer uw YARN-geheugen. Als uw YARN-geheugen hoog is, kan de verwerking van uw taken worden vertraagd. Als er onvoldoende resources zijn voor uw Spark-toepassing/taak, schaalt u het cluster zodanig dat het cluster voldoende geheugen en kernen heeft.
2. Voer een voorbeeldtesttaak uit.
   1. Als u dezelfde taak uitvoert op de HDInsight-back-end, controleert u of deze is geslaagd. Zie De MapReduce-voorbeelden uitvoeren die zijn opgenomen in HDInsight voor voorbeelden van voorbeelduitvoeringen
3. Als de taak nog steeds is mislukt in HDInsight, controleert u de toepassingslogboeken en -informatie die u aan ondersteuning wilt bieden:
   1. Controleer of de taak is ingediend bij YARN. Als de taak niet naar yarn is verzonden, gebruikt u --master yarn.
   2. Als de uitvoering van de toepassing is voltooid, verzamelt u de begin- en eindtijd van de YARN-toepassing. Als de uitvoering van de toepassing niet is voltooid, verzamelt u de begintijd/starttijd.
   3. Controleer en verzamel het toepassingslogboek met yarn logs -applicationId <Insert_Your_Application_ID>.
   4. Controleer en verzamel de yarn Resource Manager-logboeken onder de /var/log/hadoop-yarn/yarn map.
   5. Als deze stappen niet voldoende zijn om het probleem op te lossen, neemt u contact op met het Azure HDInsight-team voor ondersteuning en geeft u de bovenstaande logboeken en tijdstempels op.

Foutcode: 2304

• Bericht: MSI authentication is not supported on storages for HDI activities.

• Oorzaak: De gekoppelde opslagservices die worden gebruikt in de gekoppelde HDInsight-service of HDI-activiteit, worden geconfigureerd met een MSI-verificatie die niet wordt ondersteund.

• Aanbeveling: geef volledige verbindingsreeks s op voor opslagaccounts die worden gebruikt in de gekoppelde HDI-service of HDI-activiteit.

Foutcode: 2305

• Bericht: Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'

• Oorzaak: De verbindingsgegevens voor het HDI-cluster zijn onjuist, de opgegeven gebruiker heeft geen machtigingen om de vereiste actie uit te voeren of de HDInsight-service heeft problemen met het reageren op aanvragen van de service.

• Aanbeveling: Controleer of de gebruikersgegevens juist zijn en of de Ambari-gebruikersinterface voor het HDI-cluster kan worden geopend in een browser vanaf de VM waarop de IR is geïnstalleerd (voor een zelf-hostende IR) of kan worden geopend vanaf elke computer (voor Azure IR).

Foutcode: 2306

• Bericht: An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'

• Oorzaak: de JSON die is opgegeven voor de scriptactie is ongeldig.

• Aanbeveling: Het foutbericht moet helpen bij het identificeren van het probleem. Corriveer de json-configuratie en probeer het opnieuw.

  Raadpleeg de gekoppelde Azure HDInsight-service op aanvraag voor meer informatie.

Foutcode: 2310

• Bericht: Failed to submit Spark job. Error: '%message;'

• Oorzaak: De service heeft geprobeerd een batch in een Spark-cluster te maken met behulp van livy-API (livy/batch), maar heeft een fout ontvangen.

• Aanbeveling: volg het foutbericht om het probleem op te lossen. Als er onvoldoende informatie is om het probleem op te lossen, neemt u contact op met het HDI-team en geeft u deze de batch-id en taak-id op, die u kunt vinden in de uitvoer van de activiteit op de pagina ServiceBewaking. Als u problemen verder wilt oplossen, verzamelt u het volledige logboek van de batchtaak.

  Zie Het volledige logboek van een batchtaak ophalen voor meer informatie over het verzamelen van het volledige logboek.

Foutcode: 2312

• Bericht: Spark job failed, batch id:%batchId;. Please follow the links in the activity run Output from the service Monitoring page to troubleshoot the run on HDInsight Spark cluster. Please contact HDInsight support team for further assistance.

• Oorzaak: De taak is mislukt op het HDInsight Spark-cluster.

• Aanbeveling: volg de koppelingen in de uitvoer van de activiteitsuitvoering op de pagina Servicebewaking om problemen met de uitvoering op het HDInsight Spark-cluster op te lossen. Neem contact op met het ondersteuningsteam van HDInsight voor verdere hulp.

  Zie Het volledige logboek van een batchtaak ophalen voor meer informatie over het verzamelen van het volledige logboek.

Foutcode: 2313

• Bericht: The batch with ID '%batchId;' was not found on Spark cluster. Open the Spark History UI and try to find it there. Contact HDInsight support for further assistance.

• Oorzaak: De batch is verwijderd in het HDInsight Spark-cluster.

• Aanbeveling: Problemen met batches in het HDInsight Spark-cluster oplossen. Neem contact op met de ondersteuning van HDInsight voor meer hulp.

  Zie Het volledige logboek van een batchtaak ophalen en het volledige logboek delen met HDInsight-ondersteuning voor verdere hulp voor meer informatie over het verzamelen van het volledige logboek.

Foutcode: 2328

• Bericht: Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

• Oorzaak: In het foutbericht ziet u de details van wat er is misgegaan.

• Aanbeveling: Het foutbericht moet helpen bij het oplossen van het probleem.

Foutcode: 2329

• Bericht: Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

• Oorzaak: In het foutbericht ziet u de details van wat er is misgegaan.

• Aanbeveling: Het foutbericht moet helpen bij het oplossen van het probleem.

Foutcode: 2331

• Bericht: The file path should not be null or empty.

• Oorzaak: Het opgegeven bestandspad is leeg.

• Aanbeveling: Geef een pad op voor een bestand dat bestaat.

Foutcode: 2340

• Bericht: HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.

• Oorzaak: De gekoppelde HDInsightOnDemand-service biedt geen ondersteuning voor uitvoering via SelfHosted IR.

• Aanbeveling: Selecteer een Azure IR en probeer het opnieuw.

Foutcode: 2341

• Bericht: HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.

• Oorzaak: De opgegeven URL heeft de juiste indeling.

• Aanbeveling: Herstel de cluster-URL en probeer het opnieuw.

Foutcode: 2342

• Bericht: Failed to connect to HDInsight cluster: '%errorMessage;'.

• Oorzaak: de opgegeven referenties zijn onjuist voor het cluster, of er is een netwerkconfiguratie of verbindingsprobleem opgetreden, of de IR ondervindt problemen bij het maken van verbinding met het cluster.

• Aanbeveling:

  1. Controleer of de referenties juist zijn door de Ambari-gebruikersinterface van het HDInsight-cluster in een browser te openen.

  2. Als het cluster zich in virtual network (VNet) bevindt en een zelf-hostende IR wordt gebruikt, moet de HDI-URL de privé-URL in VNets zijn en moet deze na de clusternaam worden -int vermeld.

     Wijzig bijvoorbeeld https://mycluster.azurehdinsight.net/ in https://mycluster-int.azurehdinsight.net/. Let op de -int na mycluster, maar voor .azurehdinsight.net

  3. Als het cluster zich in het VNet bevindt, wordt de zelf-hostende IR gebruikt en is de privé-URL gebruikt en is de verbinding nog steeds mislukt. De VM waarop de IR is geïnstalleerd, had problemen bij het maken van verbinding met de HDI.

     Verbinding maken naar de VIRTUELE machine waarop de IR is geïnstalleerd en open de Ambari-gebruikersinterface in een browser. Gebruik de privé-URL voor het cluster. Deze verbinding moet werken vanuit de browser. Als dit niet het probleem is, neemt u contact op met het ondersteuningsteam van HDInsight voor verdere hulp.

  4. Als zelf-hostende IR niet wordt gebruikt, moet het HDI-cluster openbaar toegankelijk zijn. Open de Ambari-gebruikersinterface in een browser en controleer of deze wordt geopend. Als er problemen zijn met het cluster of de services op het cluster, neemt u contact op met het ondersteuningsteam van HDInsight voor hulp.

     De URL van het HDI-cluster die in de gekoppelde service wordt gebruikt, moet toegankelijk zijn voor de IR (zelf-hostend of Azure) om ervoor te zorgen dat de testverbinding wordt doorgegeven en dat de uitvoering werkt. Deze status kan worden geverifieerd door de URL te openen vanuit een browser, hetzij vanuit een virtuele machine of vanaf een openbare computer.

Foutcode: 2343

• Bericht: User name and password cannot be null or empty to connect to the HDInsight cluster.

• Oorzaak: de gebruikersnaam of het wachtwoord is leeg.

• Aanbeveling: geef de juiste referenties op om verbinding te maken met HDI en probeer het opnieuw.

Foutcode: 2345

• Bericht: Failed to read the content of the hive script. Error: '%message;'

• Oorzaak: het scriptbestand bestaat niet of de service kan geen verbinding maken met de locatie van het script.

• Aanbeveling: Controleer of het script bestaat en of de gekoppelde gekoppelde service de juiste referenties voor een verbinding heeft.

Foutcode: 2346

• Bericht: Failed to create ODBC connection to the HDI cluster with error message '%message;'.

• Oorzaak: De service heeft geprobeerd een ODBC-verbinding (Open Database Verbinding maken ivity) tot stand te brengen met het HDI-cluster en er is een fout opgetreden.

• Aanbeveling:

  1. Controleer of u de VERBINDING met ODBC/Java Database Verbinding maken ivity (JDBC) correct hebt ingesteld.
     1. Als u hetzelfde virtuele netwerk gebruikt voor JDBC, kunt u deze verbinding ophalen uit:
        Hive -> Summary -> HIVESERVER2 JDBC URL
     2. Zie Apache Hive opvragen via het JDBC-stuurprogramma in HDInsight om ervoor te zorgen dat u de juiste JDBC-configuratie hebt ingesteld.
     3. Zie voor ODB (Open Database) zelfstudie: Query uitvoeren op Apache Hive met ODBC en PowerShell om ervoor te zorgen dat u over de juiste installatie beschikt.
  2. Controleer of Hiveserver2, Hive Metastore en Hiveserver2 Interactive actief zijn en werken.
  3. Controleer de Ambari-gebruikersinterface (UI):
     1. Zorg ervoor dat alle services nog actief zijn.
     2. Controleer in de Ambari-gebruikersinterface de sectie met waarschuwingen in uw dashboard.
        1. Zie Een cluster beheren en bewaken voor meer informatie over waarschuwingen en oplossingen voor waarschuwingen.
  4. Als deze stappen niet voldoende zijn om het probleem op te lossen, neemt u contact op met het Azure HDInsight-team.

Foutcode: 2347

• Bericht: Hive execution through ODBC failed with error message '%message;'.

• Oorzaak: De service heeft het Hive-script verzonden voor uitvoering naar het HDI-cluster via de ODBC-verbinding en het script is mislukt op HDI.

• Aanbeveling:

  1. Controleer of u de VERBINDING met ODBC/Java Database Verbinding maken ivity (JDBC) correct hebt ingesteld.
     1. Als u hetzelfde virtuele netwerk gebruikt voor JDBC, kunt u deze verbinding ophalen uit:
        Hive -> Summary -> HIVESERVER2 JDBC URL
     2. Zie Apache Hive opvragen via het JDBC-stuurprogramma in HDInsight om ervoor te zorgen dat u de juiste JDBC-configuratie hebt ingesteld.
     3. Zie voor ODB (Open Database) zelfstudie: Query uitvoeren op Apache Hive met ODBC en PowerShell om ervoor te zorgen dat u over de juiste installatie beschikt.
  2. Controleer of Hiveserver2, Hive Metastore en Hiveserver2 Interactive actief zijn en werken.
  3. Controleer de Ambari-gebruikersinterface (UI):
     1. Zorg ervoor dat alle services nog actief zijn.
     2. Controleer in de Ambari-gebruikersinterface de sectie met waarschuwingen in uw dashboard.
        1. Zie Een cluster beheren en bewaken voor meer informatie over waarschuwingen en oplossingen voor waarschuwingen.
  4. Als deze stappen niet voldoende zijn om het probleem op te lossen, neemt u contact op met het Azure HDInsight-team.

Foutcode: 2348

• Bericht: The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.

• Oorzaak: De eigenschappen van de gekoppelde opslagservice zijn niet juist ingesteld.

• Aanbeveling: Alleen volledige verbindingsreeks s worden ondersteund in de gekoppelde opslagservice voor HDI-activiteiten. Controleer of u geen MSI-autorisaties of toepassingen gebruikt.

Foutcode: 2350

• Bericht: Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'

• Oorzaak: De opgegeven referenties om verbinding te maken met de opslag waar de bestanden zich moeten bevinden, zijn onjuist of de bestanden bestaan daar niet.

• Aanbeveling: Deze fout treedt op wanneer de service zich voorbereidt op HDI-activiteiten en probeert bestanden naar de hoofdopslag te kopiëren voordat de taak naar HDI wordt verzonden. Controleer of bestanden aanwezig zijn op de opgegeven locatie en of de opslagverbinding juist is. Aangezien HDI-activiteiten geen ONDERSTEUNING bieden voor MSI-verificatie voor opslagaccounts met betrekking tot HDI-activiteiten, controleert u of deze gekoppelde services volledige sleutels hebben of Azure Key Vault gebruiken.

Foutcode: 2351

• Bericht: Could not open the file '%filePath;' in container/fileSystem '%container;'.

• Oorzaak: het bestand bestaat niet op het opgegeven pad.

• Aanbeveling: Controleer of het bestand daadwerkelijk bestaat en of de gekoppelde service met verbindingsgegevens die naar dit bestand verwijzen, de juiste referenties heeft.

Foutcode: 2352

• Bericht: The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.

• Oorzaak: De eigenschappen van de gekoppelde service voor bestandsopslag zijn niet juist ingesteld.

• Aanbeveling: controleer of de eigenschappen van de gekoppelde bestandsopslagservice juist zijn geconfigureerd.

Foutcode: 2353

• Bericht: The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.

• Oorzaak: De eigenschappen van de gekoppelde service voor scriptopslag zijn niet juist ingesteld.

• Aanbeveling: Controleer of de eigenschappen van de gekoppelde scriptopslagservice juist zijn geconfigureerd.

Foutcode: 2354

• Bericht: The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.

• Oorzaak: Het gekoppelde servicetype voor opslag wordt niet ondersteund door de activiteit.

• Aanbeveling: Controleer of de geselecteerde gekoppelde service een van de ondersteunde typen voor de activiteit heeft. HDI-activiteiten ondersteunen gekoppelde Services voor AzureBlobStorage en AzureBlobFSStorage.

  Lees Opslagopties vergelijken voor gebruik met Azure HDInsight-clusters voor meer informatie

Foutcode: 2355

• Bericht: The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.

• Oorzaak: de opgegeven waarde is commandEnvironment onjuist.

• Aanbeveling: Controleer of de opgegeven waarde vergelijkbaar is met:

  \"variableName=variableValue\"
  ]
  

  Controleer ook of elke variabele slechts eenmaal in de lijst wordt weergegeven.

Foutcode: 2356

• Bericht: The commandEnvironment already contains a variable named '%variableName;'.

• Oorzaak: de opgegeven waarde is commandEnvironment onjuist.

• Aanbeveling: Controleer of de opgegeven waarde vergelijkbaar is met:

  \"variableName=variableValue\"
  ]
  

  Controleer ook of elke variabele slechts eenmaal in de lijst wordt weergegeven.

Foutcode: 2357

• Bericht: The certificate or password is wrong for ADLS Gen 1 storage.

• Oorzaak: de opgegeven referenties zijn onjuist.

• Aanbeveling: controleer of de verbindingsgegevens in ADLS Gen 1 zijn gekoppeld aan de service en controleer of de testverbinding is geslaagd.

Foutcode: 2358

• Bericht: The value '%value;' for the required property 'TimeToLive' in the on demand HDInsight linked service '%linkedServiceName;' has invalid format. It should be a timespan between '00:05:00' and '24:00:00'.

• Oorzaak: De opgegeven waarde voor de vereiste eigenschap TimeToLive heeft een ongeldige indeling.

• Aanbeveling: Werk de waarde bij naar het voorgestelde bereik en probeer het opnieuw.

Foutcode: 2359

• Bericht: The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.

• Oorzaak: De opgegeven waarde voor de eigenschap roles is ongeldig.

• Aanbeveling: Werk de waarde bij als een van de suggesties en probeer het opnieuw.

Foutcode: 2360

• Bericht: The connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

• Oorzaak: de opgegeven verbindingsreeks is HCatalogLinkedService ongeldig.

• Aanbeveling: Werk de waarde bij naar een juiste Azure SQL-verbindingsreeks en probeer het opnieuw.

Foutcode: 2361

• Bericht: Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.

• Oorzaak: het maken van het cluster is mislukt en de service heeft geen foutmelding ontvangen van de HDInsight-service.

• Aanbeveling: Open Azure Portal en zoek de HDI-resource met de opgegeven naam en controleer vervolgens de inrichtingsstatus. Neem contact op met het ondersteuningsteam van HDInsight voor verdere hulp.

Foutcode: 2362

• Bericht: Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.

• Oorzaak: De opgegeven extra opslag was geen Azure Blob Storage.

• Aanbeveling: Geef een Azure Blob Storage-account op als extra opslag voor gekoppelde HDInsight-service op aanvraag.

SSL-fout bij gekoppelde service met HDInsight ESP-cluster

• Bericht: Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'

• Oorzaak: Het probleem is waarschijnlijk gerelateerd aan System Trust Store.

• Oplossing: U kunt naar het pad Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib navigeren en DriverConfiguration64.exe openen om de instelling te wijzigen.

  

HDI-activiteit is vastgelopen bij het voorbereiden van het cluster

Als de HDI-activiteit vastloopt bij het voorbereiden van het cluster, volgt u de onderstaande richtlijnen:

1. Zorg ervoor dat de time-out groter is dan hieronder wordt beschreven en wacht totdat de uitvoering is voltooid of totdat er een time-out optreedt en wacht totdat time To Live (TTL) wordt ingediend voordat u nieuwe taken indient.

   De maximale standaardtijd die nodig is voor het instellen van een cluster is 2 uur en als u een init-script hebt, wordt het maximaal 2 uur opgetellen.

2. Zorg ervoor dat de opslag en HDI in dezelfde regio zijn ingericht.

3. Zorg ervoor dat de service-principal die wordt gebruikt voor toegang tot het HDI-cluster geldig is.

4. Als het probleem zich blijft voordoen, verwijdert u de gekoppelde HDI-service en maakt u het opnieuw met een nieuwe naam.

Webactiviteit

Foutcode: 2001

• Bericht: The length of execution output is over limit (around 4MB currently).

• Oorzaak: De uitvoer van de uitvoer van de uitvoer is groter dan 4 MB, maar de maximale grootte van de nettolading van het uitvoerantwoord is 4 MB.

• Aanbeveling: zorg ervoor dat de uitvoergrootte van de uitvoering niet groter is dan 4 MB. Zie De grootte van gegevens die worden verplaatst met behulp van Azure Data Factory uitschalen voor meer informatie.

Foutcode: 2002

• Bericht: The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

• Oorzaak: De nettolading die u probeert te verzenden, is te groot.

• Aanbeveling: Raadpleeg Payload is te groot.

Foutcode: 2003

• Bericht: There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.

• Oorzaak: Er worden te veel activiteiten gelijktijdig uitgevoerd. Dit kan gebeuren wanneer er te veel pijplijnen tegelijk worden geactiveerd.

• Aanbeveling: Gelijktijdigheid van pijplijnen verminderen. Mogelijk moet u de triggertijd van uw pijplijnen distribueren.

Foutcode: 2010

• Bericht: The Self-hosted Integration Runtime ‘<SHIR name>’ is offline

• Oorzaak: De zelf-hostende Integration Runtime is offline of de Azure Integration Runtime is verlopen of niet geregistreerd.

• Aanbeveling: zorg ervoor dat uw zelf-hostende Integration Runtime actief is. Raadpleeg problemen met zelf-hostende Integration Runtime oplossen voor meer informatie.

Foutcode: 2105

• Bericht: The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'

• Oorzaak: gegevens die zijn gegenereerd in de expressie voor dynamische inhoud komen niet overeen met de sleutel en veroorzaken een JSON-parseringsfout.

• Aanbeveling: Bekijk het sleutelveld en corrik de definitie van dynamische inhoud.

Foutcode: 2108

• Bericht: Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url: <URL>. Please verify Url or integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime'

• Oorzaak: kan de opgegeven URL niet bereiken. Dit kan gebeuren omdat er een probleem met de netwerkverbinding is opgetreden, de URL onoplosbaar was of omdat er een localhost-URL werd gebruikt in een Azure Integration Runtime.

• Aanbeveling: Controleer of de opgegeven URL toegankelijk is.

• Bericht: Error calling the endpoint '%url;'. Response status code: '%code;'

• Oorzaak: de aanvraag is mislukt vanwege een onderliggend probleem, zoals netwerkconnectiviteit, een DNS-fout, validatie van een servercertificaat of een time-out.

• Aanbeveling: Gebruik Fiddler/Postman/Netmon/Wireshark om de aanvraag te valideren.

  Fiddler gebruiken

  Fiddler gebruiken om een HTTP-sessie van de bewaakte webtoepassing te maken:

  1. Download, installeer en open Fiddler.

  2. Als uw webtoepassing HTTPS gebruikt, gaat u naar Extra Fiddler>Options>HTTPS.

     1. Selecteer op het tabblad HTTPS zowel HTTPS CONNECT's vastleggen als HTTPS-verkeer ontsleutelen.

        

  3. Als uw toepassing TLS/SSL-certificaten gebruikt, voegt u het Fiddler-certificaat toe aan uw apparaat.

     Ga naar: Hulpprogramma's fiddler>opties>HTTPS-acties>>exporteren basiscertificaat naar desktop.

  4. Schakel vastleggen uit door naar File>Capture Traffic te gaan. Of druk op F12.

  5. Wis de cache van uw browser zodat alle items in de cache worden verwijderd en opnieuw moeten worden gedownload.

  6. Een aanvraag maken:

  7. Selecteer het tabblad Componist .

     1. Stel de HTTP-methode en URL in.

     2. Voeg indien nodig headers en een aanvraagbody toe.

     3. Selecteer Uitvoeren.

  8. Schakel het vastleggen van verkeer opnieuw in en voltooi de problematische transactie op uw pagina.

  9. Ga naar: Alle>sessies opslaan.>

  Zie Aan de slag met Fiddler voor meer informatie.

Foutcode: 2113

• Bericht: ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination

• Oorzaak: Kan geen certificaat genereren op basis van de combinatie van Base64-tekenreeks/wachtwoord.

• Aanbeveling: Controleer of het met Base64 gecodeerde PFX-certificaat en wachtwoordcombinatie correct zijn ingevoerd.

Foutcode: 2403

• Bericht: Get access token from MSI failed for Datafactory <DF mname>, region <region code>. Please verify resource url is valid and retry.

• Oorzaak: kan geen toegangstoken verkrijgen van de opgegeven resource-URL.

• Aanbeveling: Controleer of u de juiste resource-URL voor uw beheerde identiteit hebt opgegeven.

Algemeen

NULL-fout REST-voortzettingstoken

Foutbericht: {"token":null,"range":{"min":.}<

Oorzaak: Bij het uitvoeren van query's op meerdere partities/pagina's retourneert de back-endservice het vervolgtoken in JObject-indeling met drie eigenschappen: token, min en max sleutelbereiken, bijvoorbeeld {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}). Afhankelijk van de brongegevens kan het uitvoeren van query's resulteren in 0, wat aangeeft dat het ontbrekende token ontbreekt, hoewel er meer gegevens moeten worden opgehaald.

Aanbeveling: Wanneer het vervolgtoken niet null is, is de tekenreeks {"token":null,"bereik":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}} vereist om queryActivityRuns-API opnieuw aan te roepen met het vervolgtoken uit het vorige antwoord. U moet de volledige tekenreeks voor de query-API opnieuw doorgeven. De activiteiten worden geretourneerd op de volgende pagina's voor het queryresultaat. U moet negeren dat er een lege matrix op deze pagina staat, zolang de volledige vervolgtokenwaarde != null is, moet u doorgaan met het uitvoeren van query's. Raadpleeg de REST API voor pijplijnuitvoeringsquery voor meer informatie.

Probleem met vastgelopen activiteit

Wanneer u merkt dat de activiteit veel langer wordt uitgevoerd dan uw normale uitvoeringen met nauwelijks geen voortgang, kan het gebeuren dat deze vastloopt. U kunt proberen het te annuleren en opnieuw te proberen om te zien of het helpt. Als het een kopieeractiviteit is, kunt u meer te weten komen over de prestatiebewaking en het oplossen van problemen met de prestaties van kopieeractiviteiten. Als dit een gegevensstroom is, leert u de prestatie- en afstemmingshandleiding voor toewijzingsgegevensstromen.

Nettolading te groot

FoutberichtThe payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.:

Oorzaak: De nettolading voor elke activiteitsuitvoering bevat de configuratie van de activiteit, de bijbehorende gegevensset(s) en gekoppelde service(s) configuraties, indien van toepassing, en een klein deel van de systeemeigenschappen die per activiteitstype zijn gegenereerd. De limiet van deze nettoladinggrootte is 896 kB, zoals vermeld in de Documentatie voor Limieten voor Azure voor Data Factory en Azure Synapse Analytics.

Aanbeveling: U bereikt deze limiet waarschijnlijk omdat u een of meer grote parameterwaarden doorgeeft vanuit de uitvoer van upstream-activiteit of extern, met name als u werkelijke gegevens doorgeeft voor activiteiten in de controlestroom. Controleer of u de grootte van grote parameterwaarden kunt verkleinen of uw pijplijnlogica kunt afstemmen om dergelijke waarden niet door te geven aan activiteiten en deze in plaats daarvan binnen de activiteit af te handelen.

Niet-ondersteunde compressie leidt tot beschadiging van bestanden

Symptomen: U probeert een bestand uit te pakken dat is opgeslagen in een blobcontainer. Eén kopieeractiviteit in een pijplijn heeft een bron met het compressietype ingesteld op 'deflate64' (of een niet-ondersteund type). Deze activiteit wordt uitgevoerd en produceert het tekstbestand in het zip-bestand. Er is echter een probleem met de tekst in het bestand en dit bestand is beschadigd. Wanneer dit bestand lokaal wordt uitgepakt, is het prima.

Oorzaak: Uw zip-bestand wordt gecomprimeerd door het algoritme 'deflate64', terwijl de interne zip-bibliotheek van Azure Data Factory alleen 'deflate' ondersteunt. Als het zip-bestand wordt gecomprimeerd door het Windows-systeem en de totale bestandsgrootte een bepaald aantal overschrijdt, gebruikt Windows standaard 'deflate64', wat niet wordt ondersteund in Azure Data Factory. Als de bestandsgrootte echter kleiner is of als u een aantal zip-hulpprogramma's van derden gebruikt die ondersteuning bieden voor het opgeven van het algoritme voor comprimeren, gebruikt Windows standaard 'deflate'.

Tip

In feite geven zowel binaire indeling in Azure Data Factory als Synapse Analytics en de tekstindeling met scheidingstekens in Azure Data Factory en Azure Synapse Analytics duidelijk aan dat de indeling 'deflate64' niet wordt ondersteund in Azure Data Factory.

Execute Pipeline geeft matrixparameter als tekenreeks door aan de onderliggende pijplijn

FoutberichtOperation on target ForEach1 failed: The execution of template action 'MainForEach1' failed: the result of the evaluation of 'foreach' expression '@pipeline().parameters.<parameterName>' is of type 'String'. The result must be a valid array.:

Oorzaak: Zelfs als u in de execute-pijplijn de parameter van het type matrix maakt, zoals wordt weergegeven in de onderstaande afbeelding, mislukt de pijplijn.

Dit komt door het feit dat de nettolading wordt doorgegeven van de bovenliggende pijplijn naar het onderliggende als tekenreeks. We kunnen deze zien wanneer we de invoer controleren die is doorgegeven aan de onderliggende pijplijn.

Aanbeveling: Om het probleem op te lossen, kunnen we gebruikmaken van de functie Matrix maken, zoals wordt weergegeven in de onderstaande afbeelding.

Dan slaagt onze pijplijn. En we kunnen zien in het invoervak dat de doorgegeven parameter een matrix is.

Gerelateerde inhoud

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

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