Działania planu wdrożenia (podgląd)

Akcja to uruchomienie elementu obszaru roboczego, które wdrożenie wykonuje przed wdrożeniem innego elementu lub po nim. Działania to sposób, w jaki plan wdrożenia działa, czego samo wdrożenie metadanych przedmiotów nie jest w stanie zrobić, na przykład wypełnienie tabeli Lakehouse przed wdrożeniem widoku magazynowego, który je odczytuje.

Akcja należy do grupy wdrożenia, a grupa rozmieszcza dokładnie jeden element. Działania grupy koncentrują się wokół wdrożenia tego elementu.

Działania przed i po wdrożeniu

Każda grupa wdrożenia realizuje dwa zestawy działań:

• Działania przed wdrożeniem są wykonywane przed wdrożeniem elementu grupy.
• Akcje po wdrożeniu są uruchamiane po wdrożeniu elementu grupy.

Akcja przed wdrożeniem nie może wykonać tego samego elementu, który wdraża jej własna grupa, ponieważ ten element nie został jeszcze wdrożony w chwili wykonywania tej akcji.

Typy przedmiotów, które możesz uruchomić jako akcję

Następujące typy elementów mogą być wykonywane jako akcje planu wdrożenia:

Aby poznać strukturę definicyjną i właściwości zadań, zobacz Definicja planu wdrożenia.

Każda akcja uruchamia przedmiot. Element definiuje, co działanie robi i jakie parametry akceptuje, a nie plan.

Żaden inny typ elementu nie może działać jako akcja. W przypadku typów przedmiotów, które są rozpatrywane, ale nie są wspierane, zobacz Rozważania i ograniczenia.

Uporządkuj akcje w grupie wdrożenia

Połącz akcje, aby kontrolować kolejność ich wykonywania. Gdy łączysz jedną akcję z drugą, wdrożenie uruchamia je w tej kolejności, więc możesz zlecić akcję, która ładuje dane przed akcją, która je waliduje.

Na poprzednim obrazku łańcuch w grupie domów nad jeziorem biegnie Refresh_Sales przed Validate_Sales. Następująca grupa magazynowa działa Notify przed wdrożeniem magazynu.

Obowiązują następujące reguły:

• Możesz łączyć akcję z innymi akcjami w tej samej grupie wdrożeń. W pliku planu łańcuch jest zależnością od nazwy innej akcji.
• Nazwy akcji muszą być unikalne w ramach ich grupy wdrożeniowej, ponieważ łańcuch odwołuje się do akcji za pomocą jej nazwy.
• Łańcuch nie może się z powrotem zwinąć na siebie. System odrzuca cykl zależności, gdy zapisujesz plan.
• Działania wykonują się pojedynczo. Akcje, których nie łączysz ze sobą, nadal nie działają równolegle.

Operacja wdrożenia zatrzymuje się przy pierwszej awarii, a system nie cofa żadnych zmian. Więcej informacji znajdziesz w artykule Czy operacja się nie powiódła.

Przekazanie parametrów akcji

Akcja może mieć parametry, które plan przekazuje elementowi, w którym akcja jest wykonywana. Każdy parametr ma nazwę i wartość, a nazwy parametrów muszą być unikalne w obrębie akcji.

Wartość parametru to albo wartość literalna, albo odniesienie do zmiennej w bibliotece zmiennych. Referencja zmiennej pozwala pojedynczemu planowi dostarczać różne wartości w każdym środowisku, zamiast kodować na stałe wartość poprawną tylko w jednym obszarze pracy.

Odwołanie do zmiennej, którego nie można przypisać do rozpoznanego typu zmiennej, jest odrzucane podczas zapisywania planu.

Ponieważ plan przekazuje wartości do przedmiotu, dostarcz parametry, których przedmiot oczekuje. Aby zobaczyć, jakie parametry akceptuje dany element, zobacz dokumentację tego typu elementu.

Uwagi i ograniczenia

Ogólne ograniczenia planu wdrożenia

• Nie możesz użyć jednego planu do wdrożenia w więcej niż jednym obszarze roboczym podczas jednego uruchomienia.
• Do operacji wdrożenia można dołączyć tylko jeden plan wdrożenia.

Ograniczenia dotyczące dołączania planu

• Dodatek do planu dotyczy tylko bieżącej operacji. Nie możesz skonfigurować planu jako domyślnego dla przyszłych wdrożeń ani zaplanować samego planu. Jeśli narzędzie wdrożenia zaplanuje operację, operacja musi dołączyć plan za każdym razem, gdy jest uruchamiana.
• Nie możesz dołączyć planu do operacji importu jednego elementu.
• Biblioteka fabric-cicd nie obsługuje planów wdrożenia.

Ograniczenia podczas rozmieszczenia

• Nie można wdrażać niezależnych grup wdrożeń równolegle.
• Nieudane wdrożenie nie jest cofnięte. Elementy, które zostały już wdrożone, pozostają w docelowym obszarze roboczym, a kolejne elementy nie są wdrażane.

Ograniczenia dla działań planu

• Tylko obsługiwane kombinacje elementów i typów zadań mogą być wykonywane jako akcje przed lub po wdrożeniu. Zobacz Typy przedmiotów, które możesz uruchomić jako akcję.
• Nie możesz używać tego samego elementu Dataflow Gen2 w więcej niż jednej akcji w planie. Jego zadanie odświeżania nie może działać więcej niż raz naraz, więc płótno ostrzega cię, gdy dodasz drugie zdarzenie, a drugie jest blokowane podczas wdrożenia.
• Nie możesz zwrócić więcej niż 512 KB w ramach akcji funkcji danych użytkownika. Większa produkcja jest skracana. Akcja i tak się udaje.
• Nie możesz sprawić, by działanie czekało, aż usługi, które ono zasila, nadrobią zaległości. Wykonanie akcji kończy się z chwilą zakończenia samej akcji, więc następna akcja może rozpocząć się, zanim będzie można odpytać dane, które zostały przez nią utworzone.
• Nie możesz użyć planu wdrożenia, aby zmienić aktywny zestaw wartości biblioteki zmiennych podczas wdrożenia. Odwołania do zmiennych są rozpoznawane na podstawie zbioru wartości, który jest już aktywny w docelowej przestrzeni roboczej. W nowo utworzonym obszarze roboczym docelowym Default jest aktywne, dopóki nie wybierzesz i nie zapiszesz innego zestawu wartości. Aby uzyskać więcej informacji, zobacz Biblioteka zmiennych CI/CD.

Ograniczenia w tworzeniu planów

• Nie możesz dodać więcej niż jednego elementu do grupy wdrożenia.
• Płótno obsługuje wyłącznie automatyczny układ.

Limity rozmiaru planu wdrożenia

Plan, który przekracza którykolwiek z tych limitów, zostanie odrzucony podczas zapisywania. Ograniczenia są egzekwowane za każdym razem, gdy plan jest zapisany, więc dotyczą kantyny, API REST, pobierania z Gita oraz zewnętrznych narzędzi.

Treści powiązane

• Czym jest plan rozmieszczenia?
• Stwórz plan wdrożenia
• Przykłady planów wdrożenia
• Rozwiązywanie problemów z planami wdrożenia
• Zrozum skojarzenia zależności podczas wdrażania między obszarami roboczymi
• Awarie zmiennych odniesień rozdzielczych