Ponowienia działań w Microsoft Fabric Data Factory

Większość działań pipeline w Data Factory obsługuje automatyczne próby. Gdy aktywność zakończy się niepowodzeniem z powodu przejściowego błędu (ograniczenia przepustowości interfejsu API, krótkotrwałej niedostępności usługi lub niestabilnej zależności), można skonfigurować ją tak, aby była automatycznie ponawiana określoną liczbę razy, zanim zostanie oznaczona jako zakończona niepowodzeniem.

Możesz także kontrolować, jak długo aktywność czeka między próbami, ustawić liczbę powtórek i czekać indywidualnie na każdą aktywność, aby precyzyjnie dostosować zachowanie powtórek do swojego workflow.

Konfiguruj ustawienia powtórek w aktywności

Aby skonfigurować sposób ponawiania prób dla aktywności:

  1. Wybierz działanie na kanwie potoku.

  2. Na karcie Ogólne w panelu właściwości zaznacz pole wyboru Włącz ponawianie prób, aby włączyć funkcję ponawiania.

    Zrzut ekranu przedstawiający ustawienia ponawiania na karcie Ogólne w panelu właściwości działania, z wyróżnioną opcją Włącz ponawianie, liczbą ponowień, warunkami ponawiania oraz interwałem ponawiania.

  3. Ustaw pole Ponów próbę na liczbę ponownych prób. Wprowadź wartość z zakresu od 1 do 1000. Wartość domyślna to 1.

  4. W sekcji Typ interwału powtórek wybierz Stałe lub Rosnące opóźnienie , aby kontrolować sposób obliczania czasu oczekiwania między próbami. Następnie ustaw pola interwałowe dla wybranego typu. Szczegółowe informacje znajdziesz w sekcji Interwały ponawiania.

    Zrzut ekranu pokazujący ustawienie interwału powtórek ustawione na stały typ interwału w zakładce Ogólne w panelu właściwości aktywności.

    Zrzut ekranu pokazujący ustawienie interwału powtórek ustawione na rosnący typ opóźnienia w zakładce Ogólne w panelu właściwości aktywności.

  5. Opcjonalnie skonfiguruj warunki ponawiania (wersja zapoznawcza), aby kontrolować, kiedy ponawiane próby występują na podstawie określonych kryteriów błędów.

    Zrzut ekranu pokazujący ustawienia warunków powtórki w zakładce Ogólne w panelu właściwości aktywności.

Interwały powtórek prób

Interwał powtórek kontroluje, jak długo dana aktywność czeka między próbami. Używaj Fixed do krótkotrwałych, przewidywalnych awarii. Użyj zwiększającego się opóźnienia w przypadku dłuższych przerw. Implementuje wykładniczy mechanizm ponawiania z opóźnieniem, w którym czas oczekiwania rośnie z każdą próbą, dając usługom nadrzędnym coraz więcej czasu na odzyskanie sprawności.

Ustawienie typu interwału prób decyduje, które podejście użyć.

Typ Behavior
Stałe (domyślne ) Czeka tyle samo sekund między każdym próbami.
Rosnące opóźnienie Wykorzystuje wykładniczo wydłużany odstęp między ponowieniami: przed każdym ponowieniem następuje losowe oczekiwanie z przedziału, który rośnie wykładniczo, aż do skonfigurowanej wartości maksymalnej.

Fixed

Gdy wybierzesz Naprawione, aktywność czeka tyle samo sekund między każdą próbą ponownego próbowania. Stosuj ten typ, gdy awarie są krótkie i przewidywalne.

Ustaw interwał powtórek (sek) na liczbę sekund oczekiwania. Wartość domyślna to 30 sekund.

Zrzut ekranu pokazujący ustawienie interwału powtórek ustawione na stały typ interwału w zakładce Ogólne w panelu właściwości aktywności.

Rosnące opóźnienie

Gdy wybierzesz Increasing Delay, czas oczekiwania rośnie wykładniczo między próbami, co jest wzorcem znanym jako wykładnicze cofanie. Ten wzorzec daje usługom nadrzędnym coraz więcej czasu na przywrócenie działania, zmniejsza ponawiane obciążenie systemów mających problemy i pozwala potokom przetwarzania samoczynnie wracać do działania po dłuższych awariach bez ręcznej ingerencji.

Mechanizm ponawiania wybiera losowy interwał z zakresu rosnącego wykładniczo przed każdą próbą:

Retry Minimalny zasięg Maksymalny zasięg
1 maks(0, minimalny interwał) min(interwał, maksymalny interwał)
2 max(interwał, minimalny interwał) min(2 × interwał, maksymalny interwał)
3 max(2 × interwał, minimalny interwał) min(4 × interwał, maksymalny interwał)
4 maksymalnie (4 × interwał, minimalny interwał) min(8 × interwał, maksymalny interwał)
… … …

Zakres podwaja się przy każdej próbie, aż górna granica osiągnie maksymalny interwał powtórek, po czym wszystkie pozostałe próby czekają na ten maksimum. Losowy wybór w obrębie każdego zakresu zmniejsza prawdopodobieństwo, że równoczesne ponowienia potoku nałożą się w tym samym momencie w tym samym systemie nadrzędnym.

Po wybraniu opcji Zwiększanie opóźnienia dostępne są dwa pola:

Pole Opis Default
Interwał powtórek prób (sek) Interwał startowy. Określa podstawę zakresu cofania się. 30 sekund
Maksymalny odstęp powtórek (sek) Górna granica czasu oczekiwania. Powtórki nigdy nie czekają dłużej niż ta wartość. 3600 sekund

Zrzut ekranu pokazujący ustawienie interwału powtórek ustawione na rosnący typ opóźnienia w zakładce Ogólne w panelu właściwości aktywności.

Note

Pola interwału ponawiania nie obsługują wyrażeń dynamicznych. Wartości muszą być statycznymi liczbami całkowitymi.

Konfigurowanie warunków ponawiania prób (wersja zapoznawcza)

Domyślnie aktywność jest ponawiana w razie jakiegokolwiek błędu. Użyj warunków powtórki , aby określić, które błędy wywołują próbę. Takie podejście pomaga uniknąć marnowania powtórek na błędy, które nie ustępują, takie jak awarie uwierzytelniania.

Aby dodać warunek ponawiania próby:

  1. W sekcji Warunki ponawiania (wersja zapoznawcza) wybierz + przycisk, aby dodać nowy wiersz warunku.
  2. Wybierz pole do oceny:
    • Komunikat o błędzie: zawartość tekstowa komunikatu o błędzie.
    • Typ awarii: Kategoria awarii, taka jak błąd użytkownika lub błąd systemu.
    • Kod błędu: Zwracany konkretny kod błędu, na przykład 429 dla ograniczenia prędkości.
  3. Wybierz operator , aby zdefiniować typ dopasowania, na przykład Contains.
  4. Wprowadź Wartość do porównania.
  5. Użyj kolumny And/Or , aby połączyć wiele warunków. Wybierz And, aby wszystkie warunki zostały spełnione, lub wybierz Or, aby ponowić próbę, gdy zostanie spełniony dowolny warunek.

Na przykład, aby ponawiać próbę tylko w przypadku błędów ograniczenia szybkości, dodaj warunek z Field ustawionym na Error code, Operator ustawionym na Contains oraz Value ustawionym na 429.

Ważna

Interwał ponawiania prób obowiązuje przed oceną warunku. Jeśli na przykład ustawisz 1-godzinny interwał ponawiania prób, a warunek ponawiania próby nie zostanie spełniony, potok nadal czeka pełną godzinę przed przejściem do następnego działania lub zakończenia uruchomienia potoku.

Tip

Jeśli nie określisz warunków ponawiania, aktywność jest ponawiana w przypadku każdego błędu. Dodaj warunki, aby bardziej selektywnie określać, które błędy wyzwalają ponawianie prób.

Znane ograniczenia ponawiania prób

  • Obsługa działań: warunkowe ponawianie prób jest obsługiwane dla określonych typów działań, w tym dla działań kopiowania danych, notesu, przepływu danych i procedury składowanej.
  • Właściwości błędu: Warunki ponawiania prób mogą być zgodne z kodem błędu, komunikatem o błędzie i typem błędu. Nie wszystkie pola błędów specyficzne dla łącznika są dostępne do dopasowania.