Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Eine Aktion ist ein Ausführen eines Arbeitsbereichselements, das eine Bereitstellung um die Bereitstellung eines anderen Elements herum ausführt. Aktionen sind die Mittel, mit denen ein Bereitstellungsplan Aufgaben ausführt, die durch das Deployen von Elementmetadaten allein nicht möglich sind, z. B. das Befüllen einer Lakehouse-Tabelle, bevor eine Warehouse-Ansicht bereitgestellt wird, die diese Tabelle liest.
Eine Aktion gehört zu einer Deployment-Gruppe, und eine Gruppe deployiert genau ein Item. Die Aktionen der Gruppe drehen sich um die Verteilung dieses Gegenstands.
Important
Dieses Feature befindet sich in der Vorschauphase.
Vor- und Nacheinsatzmaßnahmen
Jede Einsatzgruppe führt zwei Aktionssätze durch:
- Pre-Deploy-Aktionen werden ausgeführt, bevor der Gruppengegenstand eingesetzt wird.
- Aktionen nach der Bereitstellung werden ausgeführt, nachdem das Element der Gruppe bereitgestellt wurde.
Eine Aktion vor der Bereitstellung kann nicht dasselbe Element bereitstellen, das von ihrer eigenen Gruppe bereitgestellt wird, da dieses Element zum Zeitpunkt der Ausführung der Aktion noch nicht bereitgestellt wurde.
Gegenstandstypen, die du als Aktion ausführen kannst
Die folgenden Item-Typen können als Deployment-Plan-Aktionen ausgeführt werden:
| Elementtyp | Auftragstyp |
|---|---|
| Notebook | Execute |
| Datenpipeline | Execute |
| Dataflow Gen2 | Execute |
| Kopierauftrag | Execute |
| Benutzerdatenfunktion | Execute |
Für die Definitionsstruktur und die Jobeigenschaften siehe Definition des Einsatzplans.
Jede Aktion führt das Element aus. Der Gegenstand definiert, was die Aktion bewirkt und welche Parameter sie akzeptiert, nicht der Plan.
Kein anderer Gegenstandstyp kann als Aktion ausgeführt werden. Für Artikeltypen, die in Betracht gezogen, aber nicht unterstützt werden, siehe Überlegungen und Einschränkungen.
Ordne Aktionen innerhalb einer Einsatzgruppe
Aktionen verketten, um die Reihenfolge zu steuern, in der sie ausgeführt werden. Wenn du eine Aktion an eine andere kettest, führt die Deployment sie in dieser Reihenfolge aus, sodass du eine Aktion anordnen kannst, die Daten vor der Aktion lädt, die sie validiert.
Im vorherigen Bild verläuft Refresh_Sales die Kette in der Seehausgruppe vor Validate_Sales. Die folgende Warehousegruppe führt Notify aus, bevor sie das Warehouse bereitstellt.
Es gelten die folgenden Regeln:
- Du kannst eine Aktion mit anderen Aktionen in derselben Einsatzgruppe verknüpfen. In der Plandatei ist eine Kette eine Abhängigkeit vom Namen einer anderen Aktion.
- Aktionsnamen müssen innerhalb ihrer Einsatzgruppe eindeutig sein, da eine Kette eine Aktion mit Namen bezeichnet.
- Eine Kette kann sich nicht selbst zurückschleifen. Das System lehnt einen Abhängigkeitszyklus ab, wenn du den Plan speicherst.
- Die Aktionen werden einzeln ausgeführt. Aktionen, die man nicht miteinander verknüpft, laufen immer noch nicht parallel ab.
Eine Bereitstellungsoperation stoppt beim ersten Fehler, und das System rollt keine Änderungen zurück. Weitere Informationen finden Sie unter Wenn eine Operation fehlschlägt.
Übergebe Parameter an eine Aktion
Eine Aktion kann Parameter tragen, die der Plan an das Objekt weitergibt, das die Aktion ausführt. Jeder Parameter hat einen Namen und einen Wert, und Parameternamen müssen innerhalb einer Aktion eindeutig sein.
Ein Parameterwert ist entweder ein literaler Wert oder eine Referenz auf eine Variable in einer Variablenbibliothek. Eine Variablenreferenz ermöglicht es einem einzelnen Plan, verschiedene Werte pro Umgebung bereitzustellen, anstatt einen Wert fest zu kodieren, der nur in einem Arbeitsbereich korrekt ist.
Eine Variablenreferenz, die nicht auf einen bekannten Variablentyp aufgelöst wird, wird abgelehnt, wenn der Plan gespeichert wird.
Da der Plan die Werte an den Artikel weitergibt, liefert er die Parameter, die der Artikel erwartet. Welche Parameter ein Element akzeptiert, finden Sie in der Dokumentation dieses Elementtyps.
Überlegungen und Einschränkungen
Allgemeine Einschränkungen des Einsatzplans
- Du kannst nicht mit einem Plan in mehr als einem Arbeitsbereich in einem einzigen Durchlauf deployen.
- Du kannst nur einen Deployment-Plan an eine Deployment-Operation anhängen.
Einschränkungen für das Anhängen eines Plans
- Ein Plananhang gilt nur für den aktuellen Betrieb. Du kannst keinen Plan als Standard für zukünftige Einsätze konfigurieren oder den Plan selbst planen. Wenn ein Deployment-Tool einen Vorgang plant, muss der Vorgang den Plan bei jeder Ausführung einbinden.
- Man kann keinen Plan an eine Importoperation mit nur einem einzelnen Artikel anhängen.
- Die Bibliothek
fabric-cicdunterstützt keine Bereitstellungspläne.
Einschränkungen während eines Einsatzes
- Man kann keine unabhängigen Deployment-Gruppen parallel bereitstellen.
- Ein fehlgeschlagener Einsatz wird nicht rückgängig gemacht. Bereits eingesetzte Items bleiben im Ziel-Arbeitsbereich, und spätere Items werden nicht mehr eingesetzt.
Einschränkungen für Planmaßnahmen
- Nur unterstützte Element- und Jobtyp-Kombinationen können als Vor- oder Nachbereitstellungsaktionen ausgeführt werden. Siehe Gegenstandstypen, die du als Aktion ausführen kannst.
- Du kannst denselben Dataflow Gen2-Punkt nicht in mehr als einer Aktion eines Plans verwenden. Der Aktualisierungsauftrag kann nicht mehr als einmal zur gleichen Zeit ausgeführt werden. Daher warnt dich der Canvas, wenn du eine zweite Instanz hinzufügst, und die zweite Instanz wird bei der Bereitstellung blockiert.
- Sie können nicht mehr als 512 KB aus einer Benutzerdatenfunktion zurückgeben. Größere Ausgaben werden abgeschnitten. Die Aktion gelingt trotzdem.
- Man kann nicht erzwingen, dass eine Aktion wartet, bis die Dienste, die sie versorgt, aufgeholt haben. Eine Aktion wird abgeschlossen, wenn die Aktion selbst endet, sodass die nächste Aktion starten kann, bevor die erzeugten Daten abfragbar sind.
- Du kannst keinen Deployment-Plan verwenden, um während der Bereitstellung den aktiven Wertesatz einer Variablenbibliothek zu ändern. Variablenreferenzen werden anhand des Wertesatzes aufgelöst, der im Zielarbeitsbereich bereits aktiv ist. In einem neu erstellten Ziel-Arbeitsbereich ist Standard aktiv, bis du einen weiteren Werte-Satz auswählst und speicherst. Weitere Informationen finden Sie unter Variable Library CI/CD.
Einschränkungen beim Erstellen von Plänen
- Du kannst nicht mehr als einen Gegenstand zu einer Einsatzgruppe hinzufügen.
- Die Leinwand unterstützt nur automatisches Layout.
Größenbeschränkungen für den Einsatzplan
Ein Plan, der eine dieser Grenzen überschreitet, wird abgelehnt, wenn er gespeichert wird. Die Beschränkungen werden immer dann durchgesetzt, wenn ein Plan gespeichert wird, daher gelten sie sowohl für die Canvas, die REST-API, einen Pull aus Git als auch für externe Tools.
| Element | Limit |
|---|---|
| Größe des Plans | 1 MB |
| Länge eines Gruppen- oder Stufennamens | 60 Zeichen |
| Gruppen in einem Plan | 1,000 |
| Abhängigkeiten von einer Gruppe | 1,000 |
| Aktionen vor dem Einsatz in einer Gruppe | 20 |
| Aktionen nach dem Einsatz in einer Gruppe | 20 |
| Abhängigkeiten von einer Aktion | 20 |
| Parameter einer Aktion | 20 |