Een afhankelijkheid voor een tumblingvenstertrigger maken

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 .

Dit artikel bevat stappen voor het maken van een afhankelijkheid van een tumblingvenstertrigger. Zie Een tumblingvenstertrigger maken voor algemene informatie over tumblingvenstertriggers.

Als u een afhankelijkheidsketen wilt bouwen en ervoor wilt zorgen dat een trigger pas wordt uitgevoerd nadat een andere trigger binnen de service is uitgevoerd, gebruikt u deze geavanceerde functie om een tumblingvensterafhankelijkheid te maken.

Bekijk de volgende video voor een demonstratie over het maken van afhankelijke pijplijnen met behulp van een tumblingvenstertrigger:

Een afhankelijkheid maken in de gebruikersinterface

Als u afhankelijkheid van een trigger wilt maken, selecteert u Geavanceerd>nieuw activeren.> Kies vervolgens de trigger om afhankelijk te zijn van de juiste offset en grootte. Selecteer Voltooien en publiceer de wijzigingen voor de afhankelijkheden die van kracht moeten worden.

Eigenschappen van tumblingvensterafhankelijkheid

Een tumblingvenstertrigger met een afhankelijkheid heeft de volgende eigenschappen:

{
    "name": "MyTriggerName",
    "properties": {
        "type": "TumblingWindowTrigger",
        "runtimeState": <<Started/Stopped/Disabled - readonly>>,
        "typeProperties": {
            "frequency": <<Minute/Hour>>,
            "interval": <<int>>,
            "startTime": <<datetime>>,
            "endTime": <<datetime - optional>>,
            "delay": <<timespan - optional>>,
            "maxConcurrency": <<int>> (required, max allowed: 50),
            "retryPolicy": {
                "count": <<int - optional, default: 0>>,
                "intervalInSeconds": <<int>>,
            },
            "dependsOn": [
                {
                    "type": "TumblingWindowTriggerDependencyReference",
                    "size": <<timespan - optional>>,
                    "offset": <<timespan - optional>>,
                    "referenceTrigger": {
                        "referenceName": "MyTumblingWindowDependency1",
                        "type": "TriggerReference"
                    }
                },
                {
                    "type": "SelfDependencyTumblingWindowTriggerReference",
                    "size": <<timespan - optional>>,
                    "offset": <<timespan>>
                }
            ]
        }
    }
}

De volgende tabel bevat de lijst met kenmerken die nodig zijn om een tumblingvensterafhankelijkheid te definiëren.

Eigenschapsnaam	Beschrijving	Type	Vereist
type	Alle bestaande tumblingvenstertriggers worden weergegeven in deze vervolgkeuzelijst. Kies de trigger waarop u afhankelijk wilt worden.	TumblingWindowTriggerDependencyReference of SelfDependencyTumblingWindowTriggerReference	Ja
offset	Verschuiving van de afhankelijkheidstrigger. Geef een waarde op in de tijdsperiodenotatie. Zowel negatieve als positieve offsets zijn toegestaan. Deze eigenschap is verplicht als de trigger afhankelijk is van zichzelf. In alle andere gevallen is dit optioneel. Zelfafhankelijkheid moet altijd een negatieve verschuiving zijn. Als er geen waarde is opgegeven, is het venster hetzelfde als de trigger zelf.	Periode (uu:mm:ss)	Zelfafhankelijkheid: Ja Overige: Nee
size	Grootte van het tumblingvenster voor afhankelijkheden. Geef een positieve tijdspannewaarde op. Deze eigenschap is optioneel.	Periode (uu:mm:ss)	Nr.

Notitie

Een tumblingvenstertrigger kan afhankelijk zijn van maximaal vijf andere triggers.

Eigenschappen van tumblingvenster zelfafhankelijkheid

In scenario's waarin de trigger niet naar het volgende venster mag gaan totdat het voorgaande venster is voltooid, maakt u een zelfafhankelijkheid. Een zelfafhankelijkheidstrigger die afhankelijk is van het succes van eerdere uitvoeringen binnen het voorgaande uur, heeft de eigenschappen die in de volgende code worden aangegeven.

Notitie

Als uw geactiveerde pijplijn afhankelijk is van de uitvoer van pijplijnen in eerder geactiveerde vensters, raden we u aan alleen zelfafhankelijkheid van tumblingvenstertriggers te gebruiken. Als u parallelle triggeruitvoeringen wilt beperken, stelt u de maximale gelijktijdigheid van de trigger in.

{
    "name": "DemoSelfDependency",
    "properties": {
        "runtimeState": "Started",
        "pipeline": {
            "pipelineReference": {
                "referenceName": "Demo",
                "type": "PipelineReference"
            }
        },
        "type": "TumblingWindowTrigger",
        "typeProperties": {
            "frequency": "Hour",
            "interval": 1,
            "startTime": "2018-10-04T00:00:00Z",
            "delay": "00:01:00",
            "maxConcurrency": 50,
            "retryPolicy": {
                "intervalInSeconds": 30
            },
            "dependsOn": [
                {
                    "type": "SelfDependencyTumblingWindowTriggerReference",
                    "size": "01:00:00",
                    "offset": "-01:00:00"
                }
            ]
        }
    }
}

Gebruiksscenario's en voorbeelden

In de volgende scenario's ziet u het gebruik van eigenschappen van tumblingvensterafhankelijkheid.

Verschuiving van afhankelijkheden

Afhankelijkheidsgrootte

Zelfafhankelijkheid

Afhankelijkheid van een andere tumblingvenstertrigger

In het volgende voorbeeld ziet u een dagelijkse telemetrieverwerkingstaak die afhankelijk is van een andere dagelijkse taak die de laatste zeven dagen uitvoer samenvoegt en zevendaagse lopende vensterstromen genereert.

Afhankelijk van zichzelf

In het volgende voorbeeld ziet u een dagelijkse taak zonder hiaten in de uitvoerstromen van de taak.

Afhankelijkheden bewaken

U kunt de afhankelijkheidsketen en de bijbehorende vensters bewaken vanaf de bewakingspagina van de triggeruitvoering. Ga naar Uitvoeringen van bewakingstriggers>. Als een tumblingvenstertrigger afhankelijkheden heeft, draagt de triggernaam een hyperlink naar een weergave voor afhankelijkheidsbewaking.

Klik op de naam van de trigger om triggerafhankelijkheden weer te geven. In het deelvenster aan de rechterkant ziet u uitvoeringsinformatie over triggers, zoals de uitvoerings-id, venstertijd en status.

U kunt de status van de afhankelijkheden en vensters voor elke afhankelijke trigger zien. Als een van de afhankelijkhedentriggers mislukt, moet u deze opnieuw uitvoeren om de afhankelijke trigger uit te voeren.

Een tumblingvenstertrigger wacht zeven dagen voordat er een time-out optreedt op afhankelijkheden. Na zeven dagen mislukt de triggeruitvoering.

Notitie

Een tumblingvenstertrigger kan niet worden geannuleerd terwijl deze de status Wachten op afhankelijkheid heeft. De afhankelijke activiteit moet worden voltooid voordat de tumblingvenstertrigger kan worden geannuleerd. Deze beperking is standaard om ervoor te zorgen dat afhankelijke activiteiten kunnen worden voltooid zodra ze zijn gestart. Het helpt ook om de kans op onverwachte resultaten te verminderen.

Selecteer de Gantt-weergave voor een meer visuele manier om het schema voor triggerafhankelijkheid weer te geven.

Transparante vakken tonen de afhankelijkheidsvensters voor elke downstreamafhankelijke trigger. Effen gekleurde vakken die in de voorgaande afbeelding worden weergegeven, geven afzonderlijke vensteruitvoeringen weer. Hier volgen enkele tips voor het interpreteren van de Gantt-diagramweergave:

• Transparante vakken worden blauw weergegeven wanneer afhankelijke vensters de status In behandeling of Actief hebben.
• Nadat alle vensters voor een afhankelijke trigger zijn geslaagd, wordt het transparante vak groen.
• Transparante vakken worden rood weergegeven wanneer een afhankelijk venster mislukt. Zoek naar een effen rood vak om de uitvoering van het foutvenster te identificeren.

Als u een venster opnieuw wilt uitvoeren in de weergave Gantt-diagram, selecteert u het vak Effen kleur voor het venster. Er wordt een actievenster weergegeven met informatie en opties voor opnieuw uitvoeren.

Gerelateerde inhoud

• Een tumblingvenstertrigger maken