Gebruik de Mislukt-activiteit om ervoor te zorgen dat de uitvoering van pijplijnen mislukt, met een aangepast foutbericht en foutcode.

Soms wilt u een fout in een pijplijn opzettelijk veroorzaken. Een opzoekactiviteit retourneert mogelijk geen overeenkomende gegevens of een Scriptactiviteit kan eindigen met een interne fout. Wat de reden ook is, nu kunt u een mislukte activiteit in een pijplijn gebruiken en zowel het foutbericht als de foutcode aanpassen.

Wanneer gebruik te maken van de Fail-activiteit

De fail-activiteit wordt vaak gebruikt in voorwaardelijke scenario's waarin u wilt dat de pijplijn mislukt op basis van specifieke voorwaarden:

• Fouten bij gegevensvalidatie: wanneer gegevens niet voldoen aan kwaliteitsnormen
• Schendingen van bedrijfslogica: wanneer niet aan bedrijfsregels wordt voldaan
• Afhankelijkheidscontroles: wanneer vereiste resources of gegevensbronnen niet beschikbaar zijn
• Aangepaste foutafhandeling: wanneer u specifieke foutinformatie wilt opgeven in plaats van algemene systeemfouten

De fail-activiteit is doorgaans verbonden met andere activiteiten met behulp van voorwaardelijke logica (If Condition-activiteit) of geplaatst na activiteiten die mogelijk foutvoorwaarden opleveren.

Voorwaarden

Om aan de slag te gaan, moet u aan de volgende vereisten voldoen:

• Een tenantaccount met een actief Microsoft Fabric-abonnement. U kunt Fabric uitproberen met een gratis proefversie.
• Een Fabric-werkruimte.

Een mislukte activiteit toevoegen aan een pijplijn met de gebruikersinterface

Voer de volgende stappen uit om een Fail-activiteit in een pijplijn te gebruiken:

1. Maak een nieuwe pijplijn in uw werkruimte.

2. Zoek de Fail-activiteit in het deelvenster Activiteiten van de pipeline en selecteer deze om toe te voegen aan het canvas van de pipeline. Het kan nodig zijn om de lijst met activiteiten uiterst rechts van het deelvenster uit te vouwen of het Outlook-pictogram kan worden gecomprimeerd zonder tekst eronder te labelen, zoals wordt weergegeven in deze afbeelding, afhankelijk van de breedte van het venster van uw browser.

   

3. Selecteer de nieuwe mislukte activiteit op het canvas als deze nog niet is geselecteerd.

   

   Raadpleeg de Algemene-instellingen richtlijnen voor het configureren van het tabblad Algemeen instellingen.

4. Selecteer het tabblad Instellingen en geef een aangepast foutbericht en foutcode op die u wilt dat de pijplijn rapporteert wanneer de activiteit wordt aangeroepen. Deze waarden worden weergegeven in de geschiedenis en logboeken van de pijplijnuitvoering wanneer de mislukte activiteit wordt uitgevoerd, zodat u de specifieke foutvoorwaarde kunt identificeren waardoor de pijplijn is mislukt.

   

De pijplijn opslaan en uitvoeren of inplannen

De fail-activiteit wordt meestal gebruikt met andere activiteiten, dus nadat u andere activiteiten hebt geconfigureerd die vereist zijn voor uw pijplijn, voert u de volgende stappen uit:

Schakel over naar het tabblad Home boven aan de pijplijneditor en selecteer de knop Opslaan om uw pijplijn op te slaan. Selecteer Uitvoeren om deze rechtstreeks uit te voeren of Planning om uitvoeringen op specifieke tijdstippen of intervallen te plannen. Zie voor meer informatie over pijplijnuitvoeringen: pijplijnuitvoeringen plannen.

Nadat u de pijplijn heeft uitgevoerd, kunt u de pijplijnuitvoering bewaken en de uitvoeringsgeschiedenis bekijken op het Uitvoer tabblad onder het canvas.

Voorbeeld: Fout in een voorwaardelijke pijplijn

Hier volgt een veelvoorkomend patroon voor het mislukken van een pijplijn op basis van aangepaste voorwaarden:

1. Een If Condition-activiteit gebruiken om uw aangepaste foutvoorwaarde te evalueren
2. Voeg in de True-tak van de If-voorwaarde de activiteit 'Fail' toe
3. Configureer de mislukte activiteit met uw aangepaste foutbericht waarin de specifieke voorwaarde wordt beschreven waaraan is voldaan
4. In de False vertakking, ga verder met de normale uitvoering van de pipeline

Met dit patroon kan uw pijplijn soepel falen met zinvolle foutberichten wanneer specifieke bedrijfs- of gegevensvoorwaarden worden aangetroffen.

Verwante inhoud

Pijplijnuitvoeringen controleren