Schematriggers maken - Azure Data Factory en Azure Synapse (2023)

GELDT VOOR: Azure-gegevensfabriekAzure Synapse-analyse

Dit artikel bevat informatie over de planningstrigger en de stappen voor het maken, starten en bewaken van een planningstrigger. Zie voor andere soorten triggersPijplijnuitvoering en triggers.

Wanneer u een planningstrigger maakt, geeft u een planning op (startdatum, herhaling, einddatum enz.) voor de trigger en koppelt u deze aan een pijplijn. Pijplijnen en triggers hebben een veel-op-veel-relatie. Meerdere triggers kunnen een enkele pijplijn starten. Een enkele trigger kan meerdere pijplijnen starten.

In de volgende secties vindt u stappen om op verschillende manieren een planningstrigger te maken.

Azure Data Factory en Synapse-portalervaring

U kunt eenschema triggerom te plannen dat een pijplijn periodiek wordt uitgevoerd (elk uur, dagelijks, enz.).

1. Schakel over naar deBewerkingtabblad in Data Factory of het tabblad Integreren in Azure Synapse.

   • Azure-gegevensfabriek
   • Azure Synaps

   

2. SelecteerTrekkerin het menu en selecteer vervolgensNieuw/Bewerken.

   

3. Op deTriggers toevoegenpagina, selecteerKies trekker...en selecteer vervolgens+Nieuw.

   

4. Op deNieuwe trekkerpagina, voert u de volgende stappen uit:

   1. Bevestig datSchemavoor wordt geselecteerdType.

   2. Geef de begindatum/tijd van de trigger op voorBegin datum. Het is standaard ingesteld op de huidige datetime in Coordinated Universal Time (UTC).

   3. Geef de tijdzone op waarin de trigger wordt gemaakt. De tijdzone-instelling is van toepassingBegin datum,Einddatum, EnPlan uitvoeringstijdenin Geavanceerde herhalingsopties. Als u de instelling voor de tijdzone wijzigt, wordt uw startdatum niet automatisch gewijzigd. Zorg ervoor dat de startdatum correct is in de opgegeven tijdzone. Houd er rekening mee dat de geplande uitvoeringstijd van de trigger wordt beschouwd als na de startdatum (zorg ervoor dat de startdatum ten minste 1 minuut korter is dan de uitvoeringstijd, anders wordt de pijplijn geactiveerd bij de volgende herhaling).

      Opmerking

      Voor tijdzones die zomertijd in acht nemen, wordt de activeringstijd automatisch aangepast voor de verandering van twee keer per jaar, als de herhaling is ingesteld opDagenof daarboven. Als u zich wilt afmelden voor de wijziging van de zomertijd, selecteert u een tijdzone die geen zomertijd in acht neemt, bijvoorbeeld UTC

      Belangrijk

      Zomertijdaanpassing gebeurt alleen voor trigger met herhaling ingesteld opDagenof daarboven. Als de trigger is ingesteld opUurofMinutenfrequentie, zal het met regelmatige tussenpozen blijven vuren.

   4. SpecificeerHerhalingvoor de trekker. Selecteer een van de waarden in de vervolgkeuzelijst (Elke minuut, Per uur, Dagelijks, Wekelijks en Maandelijks). Voer de vermenigvuldiger in het tekstvak in. Als u bijvoorbeeld wilt dat de trigger eenmaal per 15 minuten wordt uitgevoerd, selecteert uElke minuuten voer in15in het tekstvak.

   5. In deHerhaling, als u "Dag(en), Week(en) of Maand(en)" kiest in de vervolgkeuzelijst, kunt u "Geavanceerde herhalingsopties" vinden.

      See Also

      Scheepsvolging op naam van Japanse rederijen

   6. Om een ​​einddatum tijd op te geven, selecteert uGeef een einddatum op, en specificeerEindigt open selecteer vervolgensOK. Aan elke uitvoering van de pijplijn zijn kosten verbonden. Als u aan het testen bent, wilt u er misschien voor zorgen dat de pijplijn slechts een paar keer wordt geactiveerd. Zorg er echter voor dat er voldoende tijd is om de pijplijn uit te voeren tussen de publicatietijd en de eindtijd. De trigger wordt pas van kracht nadat u de oplossing hebt gepubliceerd, niet wanneer u de trigger opslaat in de gebruikersinterface.

      

      

5. In deNieuwe trekkervenster, selecteerJain deGeactiveerdoptie en selecteer vervolgensOK. U kunt dit selectievakje gebruiken om de trigger later te deactiveren.

   

6. In deNieuwe trekkervenster, bekijk het waarschuwingsbericht en selecteer vervolgensOK.

   

7. SelecteerPubliceer allesom de wijzigingen te publiceren. Totdat u de wijzigingen publiceert, begint de trigger niet met het activeren van de pijplijnuitvoeringen.

   

8. Schakel over naar dePijpleiding loopttabblad aan de linkerkant en selecteer vervolgensVernieuwenom de lijst te vernieuwen. U ziet de pijplijnuitvoeringen die worden geactiveerd door de geplande trigger. Let op de waarden in deVeroorzaakt doorkolom. Als je deActiveer nuoptie, ziet u de handmatige triggerrun in de lijst.

   • Azure-gegevensfabriek
   • Azure Synaps

   

9. Schakel over naar deTrigger loopt\Schemaweergave.

   • Azure-gegevensfabriek
   • Azure Synaps

   

Azure PowerShell

In deze sectie ziet u hoe u Azure PowerShell gebruikt om een ​​planningstrigger te maken, starten en bewaken. Om dit voorbeeld werkend te zien, gaat u eerst door deQuickstart: maak een data factory met behulp van Azure PowerShell. Voeg vervolgens de volgende code toe aan de methode main, die een planningstrigger maakt en start die elke 15 minuten wordt uitgevoerd. De trigger is gekoppeld aan een pijplijn met de naamAdfv2QuickStartPipelinedie u maakt als onderdeel van de Quickstart.

Vereisten

• Azure-abonnement. Als u geen Azure-abonnement hebt,Maak een gratis accountvoordat je begint.

• Azure PowerShell. Volg de instructies inInstalleer Azure PowerShell op Windows met PowerShellGet.

Voorbeeldcode

1. Maak een JSON-bestand met de naamMyTrigger.jsonin de map C:\ADFv2QuickStartPSH\ met de volgende inhoud:

   Belangrijk

   Voordat u het JSON-bestand opslaat, stelt u de waarde in van destarttijdelement naar de huidige UTC-tijd. Stel de waarde van deeindtijdelement tot een uur na de huidige UTC-tijd.

   { "properties": { "name": "MyTrigger", "type": "ScheduleTrigger", "typeProperties": { "recurrence": { "frequency": "Minute", "interval": 15, "startTime": "2017-12-08T00:00:00Z", "endTime": "2017-12-08T01:00:00Z", "timeZone": "UTC" } }, "pipelines": [{ "pipelineReference": { " type": "PipelineReference", "referenceName": "Adfv2QuickStartPipeline" }, "parameters": { "inputPath": "adftutorial/input", "outputPath": "adftutorial/output" } } ] }}

   In het JSON-fragment:

   • Detypeelement van de trigger is ingesteld op "ScheduleTrigger".

   • Defrequentieelement is ingesteld op "Minuut" en deintervalelement is ingesteld op 15. Als zodanig voert de trigger de pijplijn elke 15 minuten uit tussen de begin- en eindtijd.

   • Detijdzoneelement specificeert de tijdzone waarin de trigger wordt gemaakt. Deze instelling is van invloed op beidestarttijdEneindtijd.

   • Deeindtijdelement is een uur na de waarde van destarttijdelement. Als zodanig voert de trigger de pijplijn 15 minuten, 30 minuten en 45 minuten na de starttijd uit. Vergeet niet de starttijd bij te werken naar de huidige UTC-tijd en de eindtijd naar een uur na de starttijd.

     Belangrijk

     Voor de UTC-tijdzone moeten de startTime en endTime de notatie 'jjjj-MM-ddTHH:mm:ss' volgenZ', terwijl voor andere tijdzones startTime en endTime volgen op 'jjjj-MM-ddTHH:mm:ss'.

     Volgens de ISO 8601-norm, deZachtervoegsel voor tijdstempel markeer de datum/tijd in de UTC-tijdzone en maak het veld tijdZone onbruikbaar. Terwijl vermistZachtervoegsel voor UTC-tijdzone resulteert in een fout bij activeringactivering.

   • De trigger is gekoppeld aan deAdfv2QuickStartPipelinepijpleiding. Als u meerdere pijplijnen aan een trigger wilt koppelen, voegt u er meer toepijplijnReferentiesecties.

   • De pijplijn in de Snelstartgids duurt tweeparameterswaarden:invoerPathEnoutputPath. En u geeft waarden voor deze parameters door vanuit de trigger.

2. Creëer een trigger met behulp van deSet-AzDataFactoryV2Triggercmdlet:

   Set-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger" -DefinitionFile "C:\ADFv2QuickStartPSH\MyTrigger.json"

3. Bevestig dat de status van de trigger isGestoptdoor gebruik te maken van deGet-AzDataFactoryV2Triggercmdlet:

   Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger"

4. Start de trigger met behulp van deStart-AzDataFactoryV2Triggercmdlet:

   Start-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger"

5. Bevestig dat de status van de trigger isBegonnendoor gebruik te maken van deGet-AzDataFactoryV2Triggercmdlet:

   Get-AzDataFactoryV2Trigger -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -Name "MyTrigger"

6. Download de trigger-uitvoeringen in Azure PowerShell met behulp van deGet-AzDataFactoryV2TriggerRuncmdlet. Voer regelmatig de volgende opdracht uit om de informatie over de triggerruns te krijgen. Update deTriggerRunStartedAfterEnTriggerRunStartedBeforewaarden die overeenkomen met de waarden in uw triggerdefinitie:

   Get-AzDataFactoryV2TriggerRun -ResourceGroupName $ResourceGroupName -DataFactoryName $DataFactoryName -TriggerName "MyTrigger" -TriggerRunStartedAfter "2017-12-08T00:00:00" -TriggerRunStartedBefore "2017-12-08T01:00:00"

   Opmerking

   Triggertijd van Schedule-triggers wordt gespecificeerd in UTC-tijdstempel.TriggerRunStartedAfterEnTriggerRunStartedBeforeverwacht ook UTC-tijdstempel

   Zie voor het bewaken van de triggeruitvoeringen en pijplijnuitvoeringen in de Azure-portalBewaak pijplijnuitvoeringen.

Azure CLI

In deze sectie ziet u hoe u Azure CLI gebruikt om een ​​planningstrigger te maken, starten en bewaken. Om dit voorbeeld werkend te zien, gaat u eerst door deQuickstart: maak een Azure Data Factory met behulp van Azure CLI. Volg daarna de onderstaande stappen om een ​​schematrigger te maken en te starten die elke 15 minuten wordt uitgevoerd. De trigger is gekoppeld aan een pijplijn met de naamAdfv2QuickStartPipelinedie u maakt als onderdeel van de Quickstart.

Vereisten

• Gebruik de Bash-omgeving inAzure Cloud Shell. Voor meer informatie, zieSnelstartgids voor Bash in Azure Cloud Shell.

  

• Als u CLI-referentieopdrachten liever lokaal uitvoert,installerende Azure CLI. Als u op Windows of macOS werkt, kunt u overwegen Azure CLI in een Docker-container uit te voeren. Voor meer informatie, zieDe Azure CLI uitvoeren in een Docker-container.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij de Azure CLI met behulp van deaz inloggencommando. Volg de stappen die in uw terminal worden weergegeven om het authenticatieproces te voltooien. Zie voor andere aanmeldingsoptiesMeld u aan met de Azure CLI.

  • Wanneer u hierom wordt gevraagd, installeert u de Azure CLI-extensie bij het eerste gebruik. Zie voor meer informatie over extensiesGebruik extensies met de Azure CLI.

  • Loopaz-versieom de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Om naar de nieuwste versie te upgraden, voert u hetaz-upgrade.

Voorbeeldcode

1. Maak in uw werkmap een JSON-bestand met de naamMyTrigger.jsonmet de eigenschappen van de trigger. Gebruik voor dit voorbeeld de volgende inhoud:

   Belangrijk

   Voordat u het JSON-bestand opslaat, stelt u de waarde in van destarttijdelement naar de huidige UTC-tijd. Stel de waarde van deeindtijdelement tot een uur na de huidige UTC-tijd.

   { "name": "MyTrigger", "type": "ScheduleTrigger", "typeProperties": { "recurrence": { "frequency": "Minute", "interval": 15, "startTime": "2017-12- 08T00:00:00Z", "endTime": "2017-12-08T01:00:00Z", "timeZone": "UTC" } }, "pipelines": [{ "pipelineReference": { "type": "PipelineReference ", "referenceName": "Adfv2QuickStartPipeline" }, "parameters": { "inputPath": "adftutorial/input", "outputPath": "adftutorial/output" } } ]}

   In het JSON-fragment:

   • Detypeelement van de trigger is ingesteld op "ScheduleTrigger".

   • Defrequentieelement is ingesteld op "Minuut" en deintervalelement is ingesteld op 15. Als zodanig voert de trigger de pijplijn elke 15 minuten uit tussen de begin- en eindtijd.

   • Detijdzoneelement specificeert de tijdzone waarin de trigger wordt gemaakt. Deze instelling is van invloed op beidestarttijdEneindtijd.

   • Deeindtijdelement is een uur na de waarde van destarttijdelement. Als zodanig voert de trigger de pijplijn 15 minuten, 30 minuten en 45 minuten na de starttijd uit. Vergeet niet de starttijd bij te werken naar de huidige UTC-tijd en de eindtijd naar een uur na de starttijd.

     Belangrijk

     Voor de UTC-tijdzone moeten de startTime en endTime de notatie 'jjjj-MM-ddTHH:mm:ss' volgenZ', terwijl voor andere tijdzones startTime en endTime volgen op 'jjjj-MM-ddTHH:mm:ss'.

     Volgens de ISO 8601-norm, deZachtervoegsel voor tijdstempel markeer de datum/tijd in de UTC-tijdzone en maak het veld tijdZone onbruikbaar. Terwijl vermistZachtervoegsel voor UTC-tijdzone resulteert in een fout bij activeringactivering.

   • De trigger is gekoppeld aan deAdfv2QuickStartPipelinepijpleiding. Als u meerdere pijplijnen aan een trigger wilt koppelen, voegt u er meer toepijplijnReferentiesecties.

   • De pijplijn in de Snelstartgids duurt tweeparameterswaarden:invoerPathEnoutputPath. En u geeft waarden voor deze parameters door vanuit de trigger.

2. Creëer een trigger met behulp van deaz datafactory-trigger makencommando:

   az datafactory trigger create --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger" --properties @MyTrigger.json

3. Bevestig dat de status van de trigger isGestoptdoor gebruik te maken van deaz datafactory-triggershowcommando:

   az datafactory trigger show --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger"

4. Start de trigger met behulp van deaz datafactory-trigger startencommando:

   az datafactory trigger start --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger"

5. Bevestig dat de status van de trigger isBegonnendoor gebruik te maken van deaz datafactory-triggershowcommando:

   az datafactory trigger show --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --name "MyTrigger"

6. Download de trigger-uitvoeringen in Azure CLI met behulp van deaz datafactory trigger-run query-by-factorycommando. Voer regelmatig de volgende opdracht uit om informatie over de triggerruns te krijgen. Update delaatst-bijgewerkt-naEnlaatst-bijgewerkt-voorwaarden die overeenkomen met de waarden in uw triggerdefinitie:

   az datafactory trigger-run query-by-factory --resource-group "ADFQuickStartRG" --factory-name "ADFTutorialFactory" --filters operand="TriggerName" operator="Equals" values="MyTrigger" --last-updated- na "2017-12-08T00:00:00" --laatst-bijgewerkt-voor "2017-12-08T01:00:00"

   Opmerking

   Triggertijd van Schedule-triggers wordt gespecificeerd in UTC-tijdstempel.laatst-bijgewerkt-naEnlaatst-bijgewerkt-voorverwacht ook UTC-tijdstempel

   Zie voor het bewaken van de triggeruitvoeringen en pijplijnuitvoeringen in de Azure-portalBewaak pijplijnuitvoeringen.

.NET-SDK

In deze sectie ziet u hoe u de .NET SDK gebruikt om een ​​trigger te maken, starten en bewaken. Om dit voorbeeld werkend te zien, gaat u eerst door deQuickstart: maak een data factory met behulp van de .NET SDK. Voeg vervolgens de volgende code toe aan de methode main, die een planningstrigger maakt en start die elke 15 minuten wordt uitgevoerd. De trigger is gekoppeld aan een pijplijn met de naamAdfv2QuickStartPipelinedie u maakt als onderdeel van de Quickstart.

Om een ​​planningstrigger te maken en te starten die elke 15 minuten wordt uitgevoerd, voegt u de volgende code toe aan de main-methode:

// Creëer de trigger Console.WriteLine("De trigger maken"); // Stel de starttijd in op de huidige UTC-tijd DateTime startTime = DateTime.UtcNow; // Specificeer waarden voor de parameters inputPath en outputPath Dictionary pipelineParameters = new Dictionary(); pipelineParameters.Add("inputPath", "adftutorial/input"); pipelineParameters.Add("outputPath", "adftutorial/output"); // Maak een schema-triggerstring triggerName = "MyTrigger"; ScheduleTrigger myTrigger = new ScheduleTrigger() { Pipelines = new List() { // Koppel de Adfv2QuickStartPipeline-pijplijn aan de trigger new TriggerPipelineReference() { PipelineReference = new PipelineReference(pipelineName), Parameters = pipelineParameters, } }, Recurrence = new ScheduleTriggerRecurrence() { // Stel de starttijd in op de huidige UTC-tijd en de eindtijd op één uur na de starttijd StartTime = startTime, TimeZone = "UTC", EndTime = startTime.AddHours(1), Frequency = RecurrenceFrequency.Minute , interval = 15, } }; // Maak nu de trigger door de CreateOrUpdate-methode TriggerResource triggerResource = new TriggerResource() { Properties = myTrigger }; client.Triggers.CreateOrUpdate(resourceGroup, dataFactoryName, triggerName, triggerResource); // Start de trigger Console.WriteLine("De trigger starten"); client.Triggers.Start(resourceGroup, dataFactoryName, triggerName);

Om triggers in een andere tijdzone dan UTC te maken, zijn de volgende instellingen vereist:

<>.SerializationSettings.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.IsoDateFormat;<>.SerializationSettings.DateTimeZoneHandling = Newtonsoft.Json.DateTimeZoneHandling.Unspecified;<>.SerializationSettings.DateParseHandling = DateParseHand leng.Geen; <>.DeserializationSettings.DateParseHandling = DateParseHandling.None;<>.DeserializationSettings.DateFormatHandling = Newtonsoft.Json.DateFormatHandling.IsoDateFormat;<>.DeserializationSettings.DateTimeZoneHandling = Newtonsoft.Json.DateTimeZ oneHandling.Ongespecificeerd;

Om een ​​triggerrun te bewaken, voegt u de volgende code toe vóór de laatsteConsole.WriteLineverklaring in het voorbeeld:

// Controleer of de trigger elke 15 minuten wordt uitgevoerd. Console.WriteLine("Trigger wordt uitgevoerd. U ziet de uitvoer elke 15 minuten"); voor (int i = 0; i < 3; i++) { Systeem.Threading.Thread.Sleep(TimeSpan.FromMinutes(15)); Lijst triggerRuns = client.Triggers.ListRuns(resourceGroup, dataFactoryName, triggerName, DateTime.UtcNow.AddMinutes(-15 * (i + 1)), DateTime.UtcNow.AddMinutes(2)).ToList(); Console.WriteLine("{0} trigger-runs gevonden", triggerRuns.Count); foreach (TriggerRun uitgevoerd in triggerRuns) { foreach (KeyValuePair triggerPipeline in run.TriggeredPipelines) { PipelineRun triggerPipelineRun = client.PipelineRuns.Get(resourceGroup, dataFactoryName, triggerPipeline.Value); Console.WriteLine("Pipeline-run-ID: {0}, Status: {1}", getriggerdPipelineRun.RunId, getriggerdPipelineRun.Status); Lijst wordt uitgevoerd = client.ActivityRuns.ListByPipelineRun(resourceGroup, dataFactoryName, triggerPipelineRun.RunId, run.TriggerRunTimestamp.Value, run.TriggerRunTimestamp.Value.AddMinutes(20)).ToList(); } } }

Zie voor het bewaken van de triggeruitvoeringen en pijplijnuitvoeringen in de Azure-portalBewaak pijplijnuitvoeringen.

Python-SDK

In deze sectie ziet u hoe u de Python SDK gebruikt om een ​​trigger te maken, starten en bewaken. Om dit voorbeeld werkend te zien, gaat u eerst door deQuickstart: maak een data factory met behulp van de Python SDK. Voeg vervolgens het volgende codeblok toe na het codeblok "monitor the pipeline run" in het Python-script. Deze code maakt een planningstrigger die elke 15 minuten wordt uitgevoerd tussen de opgegeven begin- en eindtijd. Update destarttijdvariabele naar de huidige UTC-tijd, en deeindtijdvariabel tot een uur na de huidige UTC-tijd.

# Maak een trigger tr_name = 'mytrigger' scheduler_recurrence = ScheduleTriggerRecurrence(frequency='Minute', interval='15',start_time='2017-12-12T04:00:00Z', end_time='2017-12-12T05:00: 00Z', time_zone='UTC') pipeline_parameters = {'inputPath':'adftutorial/input', 'outputPath':'adftutorial/output'} pipelines_to_run = [] pipeline_reference = PipelineReference('copyPipeline') pipelines_to_run.append(TriggerPipelineReference( pipeline_reference, pipeline_parameters)) tr_properties = TriggerResource(properties=ScheduleTrigger(description='My scheduler trigger', pipelines = pipelines_to_run, recurrence=scheduler_recurrence)) adf_client.triggers.create_or_update(rg_name, df_name, tr_name, tr_properties) # Start de trigger adf_client. triggers.start(rg_name, df_name, tr_name)

Zie voor het bewaken van de triggeruitvoeringen en pijplijnuitvoeringen in de Azure-portalBewaak pijplijnuitvoeringen.

Azure Resource Manager-sjabloon

U kunt een Azure Resource Manager-sjabloon gebruiken om een ​​trigger te maken. Voor stapsgewijze instructies, zieMaak een Azure-datafactory met behulp van een Resource Manager-sjabloon.

Geef de starttijd van de trigger door aan een pijplijn

Azure Data Factory versie 1 ondersteunt het lezen of schrijven van gepartitioneerde gegevens met behulp van de systeemvariabelen:Slice Start,SliceEnd,VensterStart, EnVenstereinde. In de huidige versie van Azure Data Factory en Synapse-pijplijnen kunt u dit gedrag bereiken door een pijplijnparameter te gebruiken. De starttijd en geplande tijd voor de trigger worden ingesteld als de waarde voor de pijplijnparameter. In het volgende voorbeeld wordt de geplande tijd voor de trigger doorgegeven als een waarde aan de pijplijngeplandeRunTimeparameter:

"parameters": { "scheduledRunTime": "@trigger().scheduledTime"}

JSON-schema

De volgende JSON-definitie laat zien hoe u een planningstrigger maakt met planning en herhaling:

{ "properties": { "type": "ScheduleTrigger", "typeProperties": { "recurrence": { "frequency": <>, "interval": < >, // Optioneel, geeft aan hoe vaak moet worden geactiveerd (standaard op 1) "startTime": <>, "endTime": <>, "timeZone": "UTC" "schedule": { // Optioneel (geavanceerde planningsspecificaties) "hours": [<<0-23>>], "weekDays": [<>], "minutes": [<<0-59>>], "monthDays": [<<1-31>>], "monthlyOccurrences": [ { "day": <>, "occurrence": <<1-5>> } ] } } }, " pipelines": [ { "pipelineReference": { "type": "PipelineReference", "referenceName": "" }, "parameters": { "": { "type": "Expressie", "waarde": "" }, "" : "" } } ] }}

Schema overzicht

De volgende tabel geeft een algemeen overzicht van de belangrijkste schema-elementen die verband houden met herhaling en planning van een trigger:

Schemastandaarden, limieten en voorbeelden

Tijdzone optie

Hier volgen enkele tijdzones die worden ondersteund voor Schedule-triggers:

Deze lijst is onvolledig. Verken de portal voor een volledige lijst met tijdzone-optiesPagina voor het maken van triggers

startTime-eigenschap

In de volgende tabel ziet u hoe destarttijdeigenschap bestuurt een triggerrun:

Laten we een voorbeeld bekijken van wat er gebeurt als de begintijd in het verleden ligt, met een herhaling, maar zonder schema. Neem aan dat de huidige tijd is08-04-2017 13:00, de starttijd is07-04-2017 14:00, en de herhaling is elke twee dagen. (Deherhalingwaarde wordt bepaald door het instellen van defrequentieeigendom naar "dag" en deintervaleigendom tot 2.) Merk op dat destarttijdwaarde ligt in het verleden en vindt plaats vóór de huidige tijd.

Onder deze voorwaarden is de eerste uitvoering op2017-04-09bij14:00 uur. De Scheduler-engine berekent uitvoeringsgebeurtenissen vanaf de starttijd. Alle instanties in het verleden worden weggegooid. De engine gebruikt de volgende instantie die zich in de toekomst voordoet. In dit scenario is de begintijd2017-04-07bij2:00, dus de volgende instantie is twee dagen vanaf dat moment, dat is2017-04-09bij2:00.

De eerste uitvoeringstijd is hetzelfde, zelfs als destarttijdwaarde is05-04-2017 14:00of01-04-2017 14:00. Na de eerste uitvoering worden volgende uitvoeringen berekend met behulp van het schema. Daarom zijn de daaropvolgende executies op2017-04-11bij2:00, Dan2017-04-13bij2:00, Dan2017-04-15bij2:00, enzovoort.

Ten slotte, wanneer de uren of minuten niet zijn ingesteld in het schema voor een trigger, worden de uren of minuten van de eerste uitvoering gebruikt als de standaardwaarden.

eigenschap plannen

Enerzijds kan het gebruik van een schema het aantal triggeruitvoeringen beperken. Als een trigger met een maandelijkse frequentie bijvoorbeeld is gepland om alleen op dag 31 te worden uitgevoerd, wordt de trigger alleen uitgevoerd in de maanden met een 31e dag.

Terwijl een schema ook het aantal triggeruitvoeringen kan uitbreiden. Een trigger met een maandelijkse frequentie die is gepland om te worden uitgevoerd op maanddag 1 en 2, wordt bijvoorbeeld uitgevoerd op de 1e en 2e dag van de maand, in plaats van eenmaal per maand.

Indien meerdereschemaelementen zijn gespecificeerd, is de volgorde van evaluatie van de grootste naar de kleinste schema-instelling. De evaluatie begint met het weeknummer en vervolgens de dag van de maand, de dag van de week, het uur en ten slotte de minuut.

De volgende tabel beschrijft deschemaelementen in detail:

Voorbeelden van trigger-herhalingsschema's

In dit gedeelte worden voorbeelden gegeven van herhalingsschema's en wordt ingegaan op deschemaobject en zijn elementen.

De voorbeelden gaan ervan uit dat deintervalwaarde 1 is, en dat defrequentiewaarde correct is volgens de planningsdefinitie. U kunt bijvoorbeeld geen afrequentiewaarde van "dag" en hebben ook een wijziging "maandDagen" in deschemavoorwerp. Beperkingen zoals deze worden vermeld in de tabel in de vorige sectie.

Volgende stappen

• Zie voor gedetailleerde informatie over triggersPijplijnuitvoering en triggers.
• Meer informatie over het verwijzen naar triggermetagegevens in de pijplijn, zieVerwijzen naar triggermetadata in pijplijnuitvoeringen