Del via


Foretag fejlfinding af pipelines til Data Factory i Microsoft Fabric

I denne artikel udforskes almindelige fejlfindingsmetoder til eksterne kontrolaktiviteter for Data Factory i Microsoft Fabric.

Connector og kopiér aktivitet

Hvis der er problemer med connectoren, f.eks. en fejl under brug af kopiaktiviteten, skal du se artiklen Fejlfinding af connectors .

Azure Databricks

Fejlkode: 3200

  • Meddelelse: Fejl 403.

  • Årsag: The Databricks access token has expired.

  • Anbefaling: Azure Databricks-adgangstokenet er som standard gyldigt i 90 dage. Opret et nyt token, og opdater forbindelsen.

Fejlkode: 3201

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

  • Årsag: Bad authoring: Notebook path not specified correctly.

  • Anbefaling: Angiv notesbogstien i databricks-aktiviteten.


  • Meddelelse: Cluster... does not exist.

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

  • Anbefaling: Kontrollér, at Databricks-klyngen findes.


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

  • Årsag: Bad authoring.

  • Anbefaling: Angiv enten absolutte stier til arbejdsområdeadresseringsordninger eller dbfs:/folder/subfolder/foo.py til filer, der er gemt i DFS (Databricks File System).


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

  • Årsag: Bad authoring.

  • Anbefaling: Kontrollér forbindelsesdefinitionen.


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

  • Årsag: Bad authoring.

  • Anbefaling: Kontrollér [forbindelsesdefinition]/azure/data-factory/compute-linked-services#azure-databricks-linked-service).


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

  • Årsag: Bad authoring.

  • Anbefaling: Se fejlmeddelelsen.


Fejlkode: 3202

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

  • Årsag: Too many Databricks runs in an hour.

  • Anbefaling: Kontrollér alle pipelines, der bruger dette Databricks-arbejdsområde, for deres jobskabelsesrate. Hvis pipelines, der startes for mange Databricks, kører samlet, skal du overføre nogle pipelines til et nyt arbejdsområde.


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

  • Årsag: Authoring error: No value provided for the parameter.

  • Anbefaling: Undersøg pipelinens JSON, og sørg for, at alle parametre i notesbogen baseParameters angiver en ikke-mptyværdi.


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

  • Årsag: Den bruger, der oprettede adgangstokenet, har ikke adgang til den Databricks-klynge, der er angivet i forbindelsen.

  • Anbefaling: Sørg for, at brugeren har de nødvendige tilladelser i arbejdsområdet.


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

  • Årsag: Jobbet er ikke initialiseret.

  • Anbefaling: Vent, og prøv igen senere.

Fejlkode: 3203

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

  • Årsag: Klyngen blev afbrudt. Dette problem kan være en racebetingelse for interaktive klynger.

  • Anbefaling: Brug jobklynger for at undgå denne fejl.

Fejlkode: 3204

  • Meddelelse: Job execution failed.

  • Årsag: Fejlmeddelelser angiver forskellige problemer, f.eks. en uventet klyngetilstand eller en bestemt aktivitet. Der vises ofte ingen fejlmeddelelse.

  • Anbefaling: I/T

Fejlkode: 3208

  • Meddelelse: An error occurred while sending the request.

  • Årsag: Netværksforbindelsen til Databricks-tjenesten blev afbrudt.

  • Anbefaling: Hvis du bruger en selv hosted Data Factory-kørsel, skal du sørge for, at netværksforbindelsen er pålidelig fra kørselsnoderne for Data Factory. Hvis du bruger Azure Data Factory-kørsel, fungerer forsøg normalt.

Det booleske kørselsoutput begynder at komme som streng i stedet for forventet int

  • Symptomer: Dit booleske kørselsoutput begynder at komme som streng (f.eks "0" . eller "1") i stedet for forventet int (f.eks. 0 eller 1).

    Skærmbillede af Databricks-pipelinen.

    Du har bemærket denne ændring den 28. september 2021 omkring kl. 09:00 IST, da din pipeline, der er afhængig af dette output, begyndte at mislykkes. Der blev ikke foretaget nogen ændring i pipelinen, og de booleske outputdata ankom som forventet før fejlen.

    Skærmbillede af forskellen i outputtet.

  • Årsag: Dette problem skyldes en nylig ændring, som er tilsigtet. Hvis resultatet efter ændringen er et tal, der starter med nul, konverterer Data Factory tallet til den oktale værdi, hvilket er en fejl. Dette tal er altid 0 eller 1, hvilket aldrig har forårsaget problemer før ændringen. Så hvis du vil rette oktalkonverteringen, overføres strengoutputtet fra notesbogkørslen, som den er.

  • Anbefaling: Skift if-betingelsen til noget i stil med if(value=="0").

Funktioner

Fejlkode: 3602

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

  • Årsag: Den Httpmethod, der er angivet i aktivitetsnyttedataene, understøttes ikke af Azure Function Activity.

  • Anbefaling: De understøttede Httpmethods er: PUT, POST, GET, DELETE, OPTIONS, HEAD og TRACE.

Fejlkode: 3603

  • Meddelelse: Response Content is not a valid JObject.

  • Årsag: Den Azure-funktion, der blev kaldt, returnerede ikke en JSON-nyttedata i svaret. Azure-funktionsaktivitet i Data Factory- og Synapse-pipelinen understøtter kun JSON-svarindhold.

  • Anbefaling: Opdater Azure-funktionen for at returnere en gyldig JSON-nyttedata, f.eks. en C#-funktion, der kan returnere (ActionResult)new OkObjectResult("{\"Id\":\"123\"}");

Fejlkode: 3606

  • Meddelelse: Funktionsaktivitet i Azure mangler funktionsnøgle.

  • Årsag: Definitionen af Azure-funktionsaktiviteten er ikke fuldført.

  • Anbefaling: Kontrollér, at JSON-definitionen for azure-funktionsaktiviteten har en egenskab med navnet functionKey.

Fejlkode: 3607

  • Meddelelse: Azure function activity missing function name.

  • Årsag: Definitionen af Azure-funktionsaktiviteten er ikke fuldført.

  • Anbefaling: Kontrollér, at JSON-definitionen for azure-funktionsaktiviteten har en egenskab med navnet functionName.

Fejlkode: 3608

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

  • Årsag: Oplysningerne om Azure-funktionen i aktivitetsdefinitionen kan være forkerte.

  • Anbefaling: Ret oplysningerne om Azure-funktionen, og prøv igen.

Fejlkode: 3609

  • Meddelelse: Azure function activity missing functionAppUrl.

  • Årsag: Definitionen af Azure-funktionsaktiviteten er ikke fuldført.

  • Anbefaling: Kontrollér, at JSON-definitionen for Azure Function-inputaktiviteten har en egenskab med navnet functionAppUrl.

Fejlkode: 3610

  • Meddelelse: There was an error while calling endpoint.

  • Årsag: Funktionens URL-adresse kan være forkert.

  • Anbefaling: Kontrollér, at værdien for functionAppUrl i aktiviteten JSON er korrekt, og prøv igen.

Fejlkode: 3611

  • Meddelelse: Azure function activity missing Method in JSON.

  • Årsag: Definitionen af Azure-funktionsaktiviteten er ikke fuldført.

  • Anbefaling: Kontrollér, at JSON-definitionen for azure-funktionsaktiviteten har en egenskab med navnet method.

Fejlkode: 3612

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

  • Årsag: Definitionen af Azure-funktionsaktiviteten er ikke fuldført.

  • Anbefaling: Kontrollér, at JSON-definitionen for azure-funktionsaktiviteten indeholder forbindelsesoplysninger.

Azure Machine Learning

Fejlkode: 4101

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

  • Årsag: Ugyldigt format eller manglende definition af egenskaben %propertyName;.

  • Anbefaling: Kontrollér, om egenskaben for %propertyName; aktiviteten %activityName; er defineret med korrekte data.

Fejlkode: 4110

  • Meddelelse: AzureMLExecutePipeline activity missing LinkedService definition in JSON.

  • Årsag: Definitionen af AzureMLExecutePipeline-aktivitet er ikke fuldført.

  • Anbefaling: Kontrollér, at JSON-definitionen for inputtet AzureMLExecutePipeline-aktivitet har de korrekte forbindelsesoplysninger.

Fejlkode: 4111

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

  • Årsag: Forkert aktivitetsdefinition.

  • Anbefaling: Kontrollér, at JSON-definitionen for inputtet AzureMLExecutePipeline-aktivitet har de korrekte forbindelsesoplysninger.

Fejlkode: 4112

  • Meddelelse: AzureMLService connection has invalid value for property '%propertyName;'.

  • Årsag: Ugyldigt format eller manglende definition af egenskaben '%propertyName;'.

  • Anbefaling: Kontrollér, om egenskaben %propertyName; er defineret med korrekte data for forbindelsen.

Fejlkode: 4121

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

  • Årsag: De legitimationsoplysninger, der bruges til at få adgang til Azure Machine Learning, er udløbet.

  • Anbefaling: Kontrollér, at legitimationsoplysningerne er gyldige, og prøv igen.

Fejlkode: 4122

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

  • Årsag: De legitimationsoplysninger, der er angivet i Azure Machine Learning-forbindelsen, er ugyldige eller har ikke tilladelse til handlingen.

  • Anbefaling: Kontrollér, at legitimationsoplysningerne i forbindelsen er gyldige, og at de har tilladelse til at få adgang til Azure Machine Learning.

Fejlkode: 4123

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

  • Årsag: Egenskaberne for aktiviteten, f.eks. pipelineParameters er ugyldige for Azure Machine Learning-pipelinen (ML).

  • Anbefaling: Kontrollér, at værdien af aktivitetsegenskaber svarer til den forventede nyttedata for den publicerede Azure Machine Learning-pipeline, der er angivet i forbindelsen.

Fejlkode: 4124

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

  • Årsag: Det publicerede Azure Machine Learning-pipelineslutpunkt findes ikke.

  • Anbefaling: Kontrollér, at det publicerede Azure Machine Learning-pipelineslutpunkt, der er angivet i forbindelsen, findes i Azure Machine Learning.

Fejlkode: 4125

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

  • Årsag: Der er en serverfejl i Azure Machine Learning.

  • Anbefaling: Prøv igen senere. Kontakt Azure Machine Learning-teamet for at få hjælp, hvis problemet fortsætter.

Fejlkode: 4126

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

  • Årsag: Azure Machine Learning-pipelinen blev ikke kørt.

  • Anbefaling: Kontrollér Azure Machine Learning for at få flere fejllogge, og ret derefter ML-pipelinen.

Fælles

Fejlkode: 2103

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

  • Årsag: Den påkrævede værdi for egenskaben er ikke angivet.

  • Anbefaling: Angiv værdien fra meddelelsen, og prøv igen.

Fejlkode: 2104

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

  • Årsag: Den angivne egenskabstype er ikke korrekt.

  • Anbefaling: Ret egenskabens type, og prøv igen.

Fejlkode: 2105

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

  • Årsag: Værdien for egenskaben er ugyldig eller har ikke det forventede format.

  • Anbefaling: Se dokumentationen til egenskaben, og kontrollér, at den angivne værdi indeholder det korrekte format og den korrekte type.

Fejlkode: 2106

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

  • Årsag: Lagerets forbindelsesstreng er ugyldigt eller har et forkert format.

  • Anbefaling: Gå til Azure-portal, find dit lager, kopiér og indsæt derefter forbindelsesstreng i forbindelsen, og prøv igen.

Fejlkode: 2110

  • Meddelelse: The connection type '%linkedServiceType;' is not supported for '%executorType;' activities.

  • Årsag: Den forbindelse, der er angivet i aktiviteten, er forkert.

  • Anbefaling: Kontrollér, at forbindelsestypen er en af de understøttede typer for aktiviteten.

Fejlkode: 2111

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

  • Årsag: Typen af den angivne egenskab er ikke korrekt.

  • Anbefaling: Ret egenskabstypen, og prøv igen.

Fejlkode: 2112

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

  • Årsag: Cloudtypen understøttes ikke eller kunne ikke bestemmes for lagerplads fra EndpointSuffikset.

  • Anbefaling: Brug lagerplads i en anden cloud, og prøv igen.

Azure Batch

Følgende tabel gælder for Azure Batch.

Fejlkode: 2500

  • Meddelelse: Hit unexpected exception and execution failed.

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

  • Anbefaling: Kontrollér, at den eksekverbare fil findes. Hvis programmet startede, skal du kontrollere, at stdout.txt og stderr.txt blev overført til lagerkontoen. Det er en god idé at inkludere logge i din kode til fejlfinding.

Fejlkode: 2501

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

  • Årsag: Forkert navn på batchadgangsnøgle eller gruppe.

  • Anbefaling: Kontrollér gruppenavnet og batchadgangsnøglen i forbindelsen.

Fejlkode: 2502

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

  • Årsag: Navnet på lagerkontoen eller adgangsnøglen er forkert.

  • Anbefaling: Kontrollér navnet på lagerkontoen og adgangsnøglen i forbindelsen.

Fejlkode: 2504

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

  • Årsag: Der er for mange filer i Azure-aktiviteten folderPath . Den samlede størrelse på resourceFiles må ikke være mere end 32.768 tegn.

  • Anbefaling: Fjern unødvendige filer, eller zip dem, og tilføj en udpakningskommando for at udtrække dem.

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

Fejlkode: 2505

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

  • Årsag: Azure Batch-aktiviteter understøtter kun lagerkonti, der bruger en adgangsnøgle.

  • Anbefaling: Se fejlbeskrivelsen.

Fejlkode: 2507

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

  • Årsag: Der er ingen filer i lagerkontoen på den angivne sti.

  • Anbefaling: Mappestien skal indeholde de eksekverbare filer, du vil køre.

Fejlkode: 2508

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

  • Årsag: Flere filer med samme navn findes i forskellige undermapper i folderPath.

  • Anbefaling: Azure Batch-aktiviteter fladgør mappestrukturen under folderPath. Hvis du har brug for at bevare mappestrukturen, skal du zip-filerne og udtrække dem i Azure Batch ved hjælp af en udpakningskommando.

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

Fejlkode: 2509

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

  • Årsag: Batch-URL-adresser skal ligne https://mybatchaccount.eastus.batch.azure.com

  • Anbefaling: Se fejlbeskrivelsen.

Fejlkode: 2510

  • Meddelelse: An error occurred while sending the request.

  • Årsag: Batch-URL-adressen er ugyldig.

  • Anbefaling: Kontrollér BATCH-URL-adressen.

Webaktivitet

Fejlkode: 2001

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

  • Årsag: Udførelsesoutputtet er større end 4 MB, men den maksimale understøttede nyttedatastørrelse for outputsvar er 4 MB.

  • Anbefaling: Sørg for, at outputstørrelsen for udførelse ikke overstiger 4 MB. Du kan få flere oplysninger under Sådan skalerer du størrelsen af data, der flyttes ved hjælp af Data Factory.

Fejlkode: 2002

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

  • Årsag: Den nyttedata, du forsøger at sende, er for stor.

  • Anbefaling: Se Nyttedata er for stor.

Fejlkode: 2003

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

  • Årsag: Der kører for mange aktiviteter samtidigt. Dette kan ske, når der udløses for mange pipelines på én gang.

  • Anbefaling: Reducer pipelinesammenfald. Du skal muligvis distribuere udløsertidspunktet for dine pipelines.

Fejlkode: 2105

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

  • Årsag: Data, der genereres i det dynamiske indholdsudtryk, stemmer ikke overens med nøglen og forårsager fejl under fortolkning af JSON.

  • Anbefaling: Se på nøglefeltet, og ret definitionen af dynamisk indhold.

Fejlkode: 2108

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

  • Årsag: Der kunne ikke oprettes forbindelse til den angivne URL-adresse. Dette kan ske, fordi der opstod et problem med netværksforbindelsen, URL-adressen ikke kunne løses, eller der blev brugt en localhost-URL-adresse på en Azure Data Factory-kørsel.

  • Anbefaling: Kontrollér, at den angivne URL-adresse er tilgængelig.


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

  • Årsag: Anmodningen mislykkedes på grund af et underliggende problem, f.eks. netværksforbindelse, en DNS-fejl, validering af servercertifikater eller timeout.

  • Anbefaling: Brug Fiddler/Netmon/Wireshark til at validere anmodningen.

    Brug af Fiddler

    Sådan bruger du Fiddler til at oprette en HTTP-session for det overvågede webprogram:

    1. Download, installér og åbn Fiddler.

    2. Hvis dit webprogram bruger HTTPS, skal du gå til Tools>Fiddler Options>HTTPS.

      1. Under fanen HTTPS skal du vælge både Capture HTTPS CONNECTs og Decrypt HTTPS traffic.

        Skærmbillede af Indstillinger for Fiddler

    3. Hvis dit program bruger TLS/SSL-certifikater, skal du føje Fiddler-certifikatet til din enhed.

      Gå til: Funktioner>Fiddler-indstillinger>HTTPS-handlinger>>Eksportér rodcertifikat til Desktop.

    4. Slå hentning fra ved at gå til Filhentningstrafik>. Eller tryk på F12.

    5. Ryd browserens cache, så alle cachelagrede elementer fjernes og skal hentes igen.

    6. Opret en anmodning:

    7. Vælg fanen Komponist.

      1. Angiv HTTP-metoden og URL-adressen.

      2. Hvis det er nødvendigt, skal du tilføje overskrifter og en brødtekst i en anmodning.

      3. Vælg Udfør.

    8. Slå registrering af trafik til igen, og fuldfør den problematiske transaktion på din side.

    9. Gå til: Gem>alle sessioner i filen.>

    Du kan få flere oplysninger under Introduktion til Fiddler.

Fejlkode: 2113

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

  • Årsag: Certifikatet kunne ikke oprettes ud fra Base64-streng-/adgangskodekombinationen.

  • Anbefaling: Kontrollér, at Den Base64-kodede PFX-certifikat- og adgangskodekombination, du bruger, er angivet korrekt.

Fejlkode: 2403

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

  • Årsag: Det var ikke muligt at hente et adgangstoken fra ressourcens URL-adresse.

  • Anbefaling: Kontrollér, at du har angivet den korrekte URL-adresse til ressourcen for din administrerede identitet.

Generelt

NULL-fejl for REST-fortsættelsestoken

Fejlmeddelelse: {"token":null,"range":{"min":.}

Årsag: Når der forespørges på tværs af flere partitioner/sider, returnerer backendtjenesten fortsættelsestokenet i JObject-format med tre egenskaber: token, min. og maks. nøgleområder, f.eks. {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD67398"}). Afhængigt af kildedata kan forespørgsler resultere i 0, der angiver manglende token, selvom der er flere data at hente.

Anbefaling: Når fortsættelsestokenet ikke er null, som strengen {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}, er det nødvendigt at kalde API'en queryActivityRuns igen med fortsættelsestokenet fra det forrige svar. Du skal overføre hele strengen for forespørgsels-API'en igen. Aktiviteterne returneres på de efterfølgende sider for forespørgselsresultatet. Du bør ignorere, at der er en tom matrix på denne side, så længe den fulde fortsættelsestokenværdi != null, skal du fortsætte med at forespørge. Du kan finde flere oplysninger i REST API for forespørgsel om pipelinekørsel.

Problemer med aktivitet, der er fastlåst

Når du bemærker, at aktiviteten kører længere end dine normale kørsler med næsten ingen fremskridt, kan det ske, at den sidder fast. Du kan prøve at annullere den og prøve igen for at se, om det hjælper. Hvis det er en kopiaktivitet, kan du få mere at vide om overvågning af ydeevnen og fejlfinding fra Foretag fejlfinding af ydeevnen for kopieringsaktivitet. Hvis det er et dataflow, kan du få mere at vide i Tilknytning af dataflows ydeevne og justeringsvejledning.

Nyttedata er for stor

Fejlmeddelelse: The payload including configurations on activity/data/connection is too large. Please check if you have settings with very large value and try to reduce its size.

Årsag: Nyttedataene for hver aktivitetskørsel omfatter aktivitetskonfigurationen, de tilknyttede data og eventuelle forbindelsers konfigurationer og en lille del af de systemegenskaber, der genereres pr. aktivitetstype. Grænsen for en sådan nyttedatastørrelse er 896 KB som nævnt i dokumentationen til Azure-grænser for Data Factory og Azure Synapse Analytics.

Anbefaling: Du når sandsynligvis denne grænse, fordi du overfører en eller flere store parameterværdier fra enten upstream-aktivitetsoutput eller ekstern, især hvis du overfører faktiske data på tværs af aktiviteter i kontrolflowet. Kontrollér, om du kan reducere størrelsen på store parameterværdier, eller finjuster pipelinelogikken for at undgå at overføre sådanne værdier på tværs af aktiviteter og håndtere dem i aktiviteten i stedet.

Ikke-understøttet komprimering medfører, at filer beskadiges

Symptomer: Du forsøger at udpakke en fil, der er gemt i en blobobjektbeholder. En enkelt kopiaktivitet i en pipeline har en kilde, hvor komprimeringstypen er angivet til "deflate64" (eller en hvilken som helst type, der ikke understøttes). Denne aktivitet kører korrekt og opretter den tekstfil, der er indeholdt i zip-filen. Der er dog problemer med teksten i filen, og filen er beskadiget. Når denne fil er pakket ud lokalt, er det fint.

Årsag: Zip-filen komprimeres af algoritmen "deflate64", mens det interne zip-bibliotek i Data Factory kun understøtter "deflate". Hvis zip-filen komprimeres af Windows-systemet, og den samlede filstørrelse overstiger et bestemt tal, bruger Windows som standard "deflate64", som ikke understøttes i Data Factory. På den anden side, hvis filstørrelsen er mindre, eller du bruger nogle zipværktøjer fra tredjepart, der understøtter angivelse af komprimeringsalgoritmen, bruger Windows som standard "deflate".

Tip

Faktisk angiver både binært format i Data Factory og Synapse Analytics og Afgrænset tekstformat i Data Factory og Azure Synapse Analytics tydeligt, at formatet "deflate64" ikke understøttes i Data Factory.

Execute Pipeline overfører matrixparameteren som streng til den underordnede pipeline

Fejlmeddelelse: Operation 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.

Årsag: Selvom du i Execute Pipeline opretter parameteren af typen matrix, som vist på nedenstående billede, mislykkes pipelinen.

Skærmbillede, der viser parametrene for aktiviteten Udfør pipeline.

Dette skyldes, at nyttedataene overføres fra den overordnede pipeline til den underordnede som streng. Vi kan se det, når vi kontrollerer det input, der er overført til den underordnede pipeline.

Skærmbillede, der viser inputtypestrengen.

Anbefaling: For at løse problemet kan vi anvende funktionen create array som vist på nedenstående billede.

Skærmbillede, der viser, hvordan du bruger funktionen create array.

Så lykkes vores pipeline. Og i inputfeltet kan vi se, at den overførte parameter er en matrix.

Skærmbillede, der viser inputtypematrixen.

Prøv disse ressourcer for at få mere fejlfindingshjælp: