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.
Die meisten Pipeline-Aktivitäten in Data Factory unterstützen automatisierte Wiederholungen. Wenn eine Aktivität aufgrund eines vorübergehenden Fehlers fehlschlägt (eine API mit Drosselung, ein kurzer Dienstausfall oder eine instabile Abhängigkeit), können Sie sie so konfigurieren, dass sie automatisch eine festgelegte Anzahl von Malen wiederholt wird, bevor die Aktivität als fehlgeschlagen markiert wird.
Du kannst außerdem steuern , wie lange die Aktivität zwischen den Versuchen wartet, und die Anzahl der Wiederholungen und das Warten einzeln für jede Aktivität einstellen, um das Wiederholungsverhalten präzise im gesamten Workflow abzustimmen.
Wiederholungseinstellungen in einer Aktivität konfigurieren
So richten Sie das Wiederholungsverhalten für eine Aktivität ein:
Wählen Sie die Aktivität auf der Pipeline-Arbeitsfläche aus.
Aktivieren Sie auf der Registerkarte " Allgemein " des Eigenschaftenbereichs das Kontrollkästchen " Wiederholungsversuche aktivieren ", um die Wiederholungsfunktion zu aktivieren.
Legen Sie das Feld " Wiederholen " auf die Anzahl der Wiederholungsversuche fest. Geben Sie einen Wert zwischen 1 und 1000 ein. Der Standardwert ist 1.
Wählen Sie unter WiederholungsintervalltypFest oder Ansteigende Verzögerung aus, um zu steuern, wie die Wartezeit zwischen den Versuchen berechnet wird. Dann setze die Intervallfelder für deinen gewählten Typ. Siehe Wiederholungsintervalle für Details.
Konfigurieren Sie optional Die Wiederholungsbedingungen (Vorschau), um zu steuern, wann Wiederholungen basierend auf bestimmten Fehlerkriterien auftreten.
Wiederholungsintervalle
Das Intervall der Wiederholung steuert, wie lange eine Aktivität zwischen den Versuchen wartet. Verwenden Sie Fixed für kurze, vorhersehbare Ausfälle. Verwenden Sie „Increasing Delay“ bei längeren Ausfällen. Es implementiert exponentiellen Back-off, bei dem die Wartezeit mit jedem Versuch verlängert wird und Upstream-Dienste zunehmend mehr Zeit zur Erholung haben.
Die Einstellung Retry interval type steuert, welcher Ansatz verwendet wird.
| Typ | Behavior |
|---|---|
| Behoben (Standard) | Es wartet gleich viele Sekunden zwischen jedem Versuch. |
| Zunehmende Verzögerung | Verwendet exponentielles Backoff: Jeder Wiederholungsversuch erfolgt nach einem zufällig gewählten Intervall innerhalb eines Bereichs, der exponentiell wächst, bis zu einem konfigurierbaren Maximum. |
Korrigiert
Wenn du 'Behoben' auswählst, wartet die Aktivität zwischen jedem erneuten Versuch die gleiche Sekundenanzahl. Verwenden Sie diesen Typ, wenn Misserfolge kurz und vorhersehbar sind.
Legen Sie das Wiederholungsintervall (Sek.) auf die Anzahl der Sekunden fest, die gewartet werden soll. Der Standardwert ist 30 Sekunden.
Zunehmende Verzögerung
Wenn Sie die Verzögerung erhöhen, wächst die Wartezeit zwischen den Versuchen exponentiell – ein Muster, das als exponentielles Back-off bekannt ist. Dieses Muster gibt den Upstream-Diensten zunehmend mehr Zeit zur Erholung, reduziert die wiederholte Last auf angeschlagenen Systemen und ermöglicht es Pipelines, sich von längeren Ausfällen ohne manuelles Eingreifen selbst zu erholen.
Die Wiederholungs-Engine wählt vor jedem Versuch ein zufälliges Intervall aus einem exponentiell wachsenden Bereich:
| Erneut versuchen | Minimale Reichweite | Maximale Reichweite |
|---|---|---|
| 1 | max(0, Min-Intervall) | min(Intervall, Max-Intervall) |
| 2 | max(Intervall, Min-Intervall) | min(2 × Intervall, Maximalintervall) |
| 3 | max(2 × Intervall, Min-Intervall) | min(4 × Intervall, maximales Intervall) |
| 4 | max(4 × Intervall, Min-Intervall) | min(8 × Intervall, maximales Intervall) |
| … | … | … |
Der Bereich verdoppelt sich mit jedem Versuch, bis die obere Schranke das maximale Wiederholungsintervall erreicht, danach warten alle verbleibenden Versuche auf diesem Maximum. Die zufällige Auswahl innerhalb jedes Bereichs verringert die Wahrscheinlichkeit, dass gleichzeitige Pipeline-Neuversuche im selben Upstream-System zum gleichen Zeitpunkt kollidieren.
Zwei Felder sind verfügbar, wenn Increasing Delay ausgewählt ist:
| Feld | Description | Vorgabe |
|---|---|---|
| Wiederholungsintervall (sec) | Das Startintervall. Definiert die Basis des Back-off-Bereichs. | 30 Sekunden |
| Maximales Wiederholungsintervall (sec) | Die obere Schranke für das Warteintervall. Die Wartezeit bei Wiederholungsversuchen überschreitet nie diesen Wert. | 3600 Sekunden |
Note
Retry-Intervallfelder unterstützen keine dynamischen Ausdrücke. Die Werte müssen statische ganze Zahlen sein.
Konfigurieren von Wiederholungsbedingungen (Vorschau)
Standardmäßig wird eine Aktivität bei einem Fehler erneut ausgeführt. Verwenden Sie die Wiederholungsbedingungen, um anzugeben, welche Fehler eine Wiederholung auslösen. Dieser Ansatz hilft Ihnen, keine unnötigen Wiederholungsversuche für Fehler zu verschwenden, die sich nicht beheben lassen, z. B. Authentifizierungsfehler.
Um eine Wiederholungsbedingung hinzuzufügen:
- Wählen Sie im Abschnitt Wiederholungsbedingungen (Vorschau) die Schaltfläche + aus, um eine neue Bedingungszeile hinzuzufügen.
- Wählen Sie ein Feld aus, das ausgewertet werden soll:
- Fehlermeldung: Der Textinhalt der Fehlermeldung.
- Fehlerart: Die Kategorie des Fehlers, wie Benutzerfehler oder Systemfehler.
- Fehlercode: Der spezifische Fehlercode wurde zurückgegeben, wie zum Beispiel 429 für die Geschwindigkeitsbegrenzung.
- Wählen Sie einen Operator, um den Übereinstimmungstyp zu definieren, zum Beispiel Enthält.
- Geben Sie einen Wert ein, mit dem abgeglichen werden soll.
- Verwenden Sie die Spalte "Und/Oder ", um mehrere Bedingungen zu kombinieren. Wählen Sie And, um festzulegen, dass alle Bedingungen erfüllt sein müssen, oder Or, um es erneut zu versuchen, wenn eine beliebige Bedingung erfüllt ist.
Wenn Sie beispielsweise nur bei Ratenbegrenzungsfehlern einen erneuten Versuch ausführen möchten, fügen Sie eine Bedingung hinzu, bei der Feld auf Error code gesetzt ist, Operator auf Contains gesetzt ist und Wert auf 429 gesetzt ist.
Important
Das Retry-Intervall läuft bevor die Bedingung ausgewertet wird. Wenn Sie z. B. ein 1-Stunden-Wiederholungsintervall festlegen und die Wiederholungsbedingung nicht erfüllt ist, wartet die Pipeline immer noch die volle Stunde, bevor Sie mit der nächsten Aktivität fortfahren oder die Pipelineausführung beenden.
Tipp
Wenn Sie keine Bedingungen für Wiederholungsversuche angeben, wiederholt die Aktivität den Vorgang bei jedem Fehler. Fügen Sie Bedingungen hinzu, um selektiver zu sein, welche Fehler Wiederholungen auslösen.
Bekannte Wiederholungseinschränkungen
- Aktivitätsunterstützung: Bedingte Wiederholungen werden für bestimmte Aktivitätstypen unterstützt, einschließlich Kopieren von Daten, Notizbuch, Datenfluss und gespeicherten Prozeduraktivitäten.
- Fehlereigenschaften: Wiederholungsbedingungen können bei Fehlercode, Fehlermeldung und Fehlertyp übereinstimmen. Nicht alle connectorspezifischen Fehlerfelder sind für den Abgleich verfügbar.