AMC-Workflows automatisieren: gespeicherte Abfragen, Parameter und Zeitpläne
Kurz gesagt: Ein AMC-Workflow ist eine gespeicherte SQL-Abfrage mit eindeutiger `workflowId`. Sie führen ihn bei Bedarf aus oder legen einen Schedule an, der ihn täglich oder wöchentlich startet und das Ergebnis in den S3-Bucket der Instanz legt. Parameter erlauben, Werte erst bei der Ausführung zu setzen.
Workflow anlegen
- Ein Workflow ist eine SQL-Abfrage mit einer
workflowId, die nur Buchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten darf, etwaStreaming_T.V_Performance-Report2023. sqlQuerymuss eine einzeilige Abfrage ohne Tabs und Zeilenumbrüche sein; ein Semikolon am Ende ist nicht nötig.- Beim Definieren gelten die Aggregationsanforderungen, damit die Privatsphäre der Kunden gewahrt bleibt. Ein gespeicherter Workflow liefert erst Ergebnisse, wenn Sie ihn ausführen oder planen.
Parameter statt Festwerte
Im Workflow definieren Sie benutzerdefinierte Parameter, optional mit defaultValue, und setzen die Werte bei der Ausführung. Unterstützt sind die einfachen Typen BINARY, BOOLEAN, BYTE, DATE, DOUBLE, FLOAT, INTEGER, LONG, SHORT, STRING, TIMESTAMP sowie ARRAY dieser Typen. Tragen Sie niemals Angaben zu einzelnen Personen wie E-Mail oder Telefonnummer in Beschreibung oder Parameterwert ein.
Ausführen: Zeitfenster und Datenaktualität
| `timeWindowType` | Zeitfenster |
|---|---|
EXPLICIT | Start und Ende stehen ausdrücklich in der Anfrage. |
MOST_RECENT_DAY | Standard: der letzte Tag, für den die Instanz voraussichtlich Daten hat. |
MOST_RECENT_WEEK | Die letzte Woche mit voraussichtlichen Daten, an Tagesgrenzen ausgerichtet. |
CURRENT_MONTH | Vom Monatsanfang bis zum letzten Zeitpunkt mit Daten. |
PREVIOUS_MONTH | Der gesamte Vormonat. |
AMC nimmt Daten nicht in Echtzeit auf. Amazon empfiehlt einen Zeitraum, der 48 Stunden vor dem aktuellen Datum endet, weil die Daten bis zu 48 Stunden brauchen können. Zu den Grenzen paralleler Ausführungen siehe die Fehlerseite zum Limit.
Schedules und Ergebnisse
- Ein Schedule legt Rhythmus, Wochentag und Uhrzeit fest. Der Parameter
aggregationHourUtcist der Versatz in Stunden ab Mitternacht UTC: 10 Uhr MST entsprechen 16 Uhr UTC, also 16. ScheduleEnabled=trueaktiviert den Zeitplan; beifalsewird der Workflow nicht eingeplant.- Ohne Angabe gilt bei wöchentlicher Aggregation der Tag der Erstellung als
aggregationStartDay; bei täglicher wird er nicht verwendet. - Das Ergebnis landet im S3-Bucket der Instanz, laut Amazon ungefähr 6 bis 7 Stunden nach der geplanten Zeit; die Datei trägt das Suffix
-ver1.csvund lässt ungültigen Traffic aus.
Häufige Fragen
Erzeugt ein gespeicherter Workflow von selbst Ergebnisse?
Nein. Erst eine Ausführung oder ein Schedule erzeugt Ausgabedaten.