Activiteitsherhalingen in Microsoft Fabric Data Factory

De meeste pijpleidingactiviteiten in Data Factory ondersteunen geautomatiseerde herhalingen. Wanneer een activiteit faalt door een tijdelijke fout (een gesmoorde API, een korte servicestoring of een flapping-afhankelijkheid), kun je het zo instellen dat het automatisch een bepaald aantal keren opnieuw probeert voordat de activiteit als mislukt wordt gemarkeerd.

Je kunt ook bepalen hoe lang de activiteit tussen pogingen wacht, en het aantal herpogingen instellen en individueel wachten voor elke activiteit, om het herkansingsgedrag precies in je workflow af te stemmen.

Configureer herkansingsinstellingen in een activiteit

Het gedrag voor opnieuw uitvoeren van een activiteit instellen:

  1. Selecteer de activiteit op het pijplijncanvas.

  2. Schakel op het tabblad Algemeen van het deelvenster Eigenschappen het selectievakje Nieuwe pogingen inschakelen in om de functionaliteit voor opnieuw proberen in te schakelen.

    Schermopname waarop de instellingen voor opnieuw proberen worden weergegeven op het tabblad Algemeen van het eigenschappenvenster van een activiteit, waarbij Opnieuw proberen is gemarkeerd, evenals Aantal nieuwe pogingen, Voorwaarden voor opnieuw proberen en Interval tussen nieuwe pogingen.

  3. Stel het veld Opnieuw proberen in op het aantal nieuwe pogingen. Voer een waarde in tussen 1 en 1000. De standaardwaarde is 1.

  4. Selecteer onder Type nieuwe intervalVast of Oplopende vertraging om te bepalen hoe de wachttijd tussen pogingen wordt berekend. Stel vervolgens de intervalvelden in voor het gekozen type. Zie herpogingsintervallen voor details.

    Screenshot met de instelling voor het herhaalinterval ingesteld op het vaste intervaltype in het tabblad Algemeen van het eigenschappenpaneel van een activiteit.

    Screenshot die de instelling voor het herhaalinterval toont die is ingesteld op het type 'toenemende vertragingsinterval' in het tabblad Algemeen van het eigenschappenpaneel van een activiteit.

  5. Configureer eventueel voorwaarden voor opnieuw proberen (preview) om te bepalen wanneer nieuwe pogingen worden uitgevoerd op basis van specifieke foutcriteria.

    Screenshot met de instellingen voor herkansingsvoorwaarden in het tabblad Algemeen van het eigenschappenpaneel van een activiteit.

Intervallen voor nieuwe pogingen

Het interval van herkansen bepaalt hoe lang een activiteit tussen pogingen wacht. Gebruik Fixed voor korte, voorspelbare storingen. Gebruik Increasing Delay voor langere stroomstoringen. Het implementeert exponentiële back-off, waarbij de wachttijd bij elke poging toeneemt, waardoor upstream-diensten steeds meer tijd krijgen om te herstellen.

De instelling Type herhaalinterval bepaalt welke methode wordt gebruikt.

Typologie Gedrag
Vast (standaard) Wacht evenveel seconden tussen elke poging.
Toenemende vertraging Gebruikt exponentiële back-off: elke herpoging wacht een willekeurig interval vanuit een bereik dat exponentieel groeit, tot een configureerbaar maximum.

Gerepareerd / Opgelost

Wanneer je Opgelost selecteert, wacht de activiteit hetzelfde aantal seconden tussen elke poging om het opnieuw te proberen. Gebruik dit type wanneer mislukkingen kort en voorspelbaar zijn.

Stel het Retry-interval (sec) in op het aantal seconden wachten. De standaardwaarde is 30 seconden.

Screenshot met de instelling voor het herhaalinterval ingesteld op het vaste intervaltype in het tabblad Algemeen van het eigenschappenpaneel van een activiteit.

Toenemende vertraging

Wanneer je Increasing Delay selecteert, groeit de wachttijd exponentieel tussen pogingen, een patroon dat bekend staat als exponentiële back-off. Dit patroon geeft upstream-diensten geleidelijk meer tijd om te herstellen, vermindert herhaalde belasting op worstelende systemen en stelt leidingen in staat om zelf te herstellen na langere storingen zonder handmatige tussenkomst.

De herkansingsengine selecteert een willekeurig interval uit een exponentieel groeiend bereik vóór elke poging:

Opnieuw proberen Minimale bereik Maximale reikwijdte
1 max(0, minimuminterval) min(interval, max interval)
2 max(interval, min interval) min(2 × interval, maximale interval)
3 max(2 × interval, min interval) min(4 × interval, max interval)
4 max(4 × interval, min interval) min(8 × interval, max interval)

Het bereik verdubbelt bij elke poging totdat de bovengrens het maximale herkansinterval bereikt, waarna alle resterende pogingen op dat maximum wachten. De willekeurige selectie binnen elk bereik verkleint de kans dat gelijktijdige nieuwe pogingen van de pijplijn op hetzelfde upstreamsysteem op hetzelfde moment met elkaar botsen.

Twee velden zijn beschikbaar wanneer Increasing Delay is geselecteerd:

Veld Beschrijving Verstek
Herprobeerinterval (sec) Het startinterval. Definieert de basis van het back-off bereik. 30 seconden
Maximaal herprobeerinterval (sec) De bovengrens voor het wachtinterval. Nieuwe pogingen wachten nooit langer dan deze waarde. 3600 seconden

Screenshot die de instelling voor het herhaalinterval toont die is ingesteld op het type 'toenemende vertragingsinterval' in het tabblad Algemeen van het eigenschappenpaneel van een activiteit.

Note

Herhaalintervalvelden ondersteunen geen dynamische expressies. Waarden moeten statische gehele getallen zijn.

Voorwaarden voor opnieuw proberen configureren (preview)

Standaard wordt er een nieuwe poging gedaan voor een activiteit bij een fout. Gebruik herkansingsvoorwaarden om aan te geven welke fouten een herpoging triggeren. Deze aanpak helpt je te voorkomen dat je opnieuw pogingen verspilt aan fouten die niet worden opgelost, zoals authenticatiefouten.

Ga als volgt te werk om een voorwaarde voor opnieuw proberen toe te voegen:

  1. Selecteer in de sectie Voorwaarden voor opnieuw proberen (preview) de + knop om een nieuwe voorwaarderij toe te voegen.
  2. Kies een veld dat u wilt evalueren:
    • Foutbericht: de tekstinhoud van het foutbericht.
    • Fouttype: De categorie van fout, zoals gebruikersfout of systeemfout.
    • Foutcode: De specifieke foutcode werd teruggegeven, zoals 429 voor snelheidsbeperking.
  3. Selecteer een Operator om het matchtype te definiëren, zoals Bevat.
  4. Voer een waarde in om mee te vergelijken.
  5. Gebruik de kolom And/Or om meerdere voorwaarden te combineren. Selecteer En als u wilt vereisen dat alle voorwaarden overeenkomen, of als u het opnieuw wilt proberen wanneer een voorwaarde overeenkomt.

Als u bijvoorbeeld alleen opnieuw wilt proberen op fouten met snelheidsbeperking, voegt u een voorwaarde toe met Veld ingesteld op Error code, Operator ingesteld op Containsen Waarde ingesteld op 429.

Important

Het interval tussen nieuwe pogingen verstrijkt voordat de voorwaarde wordt geëvalueerd. Als u bijvoorbeeld een interval van 1 uur voor opnieuw proberen instelt en niet aan de voorwaarde voor opnieuw proberen wordt voldaan, wacht de pijplijn nog steeds het volledige uur voordat u doorgaat met de volgende activiteit of het beëindigen van de pijplijnuitvoering.

Tip

Wanneer je de herkansingsvoorwaarden niet specificeert, probeert de activiteit opnieuw bij alle mislukkingen. Voorwaarden toevoegen om selectiever te zijn over welke fouten nieuwe pogingen activeren.

Bekende beperkingen voor opnieuw proberen

  • Ondersteunde activiteiten: Voorwaardelijk opnieuw uitvoeren wordt ondersteund voor specifieke activiteitstypen, waaronder Gegevens kopiëren, Notebook, Gegevensstroom en Opgeslagen procedure.
  • Fouteigenschappen: voorwaarden voor opnieuw proberen kunnen overeenkomen met foutcode, foutbericht en fouttype. Niet alle connectorspecifieke foutvelden zijn beschikbaar voor overeenkomsten.