Czym jest plan wdrożenia w Microsoft Fabric? (wersja zapoznawcza)

Plan wdrożenia Microsoft Fabric to element w przestrzeni roboczej, który dodaje wyraźną kolejność elementów oraz zautomatyzowane działania do operacji wdrożenia. Użyj planu wdrażania przedmiotów w określonej kolejności. Możesz także użyć go do uruchomienia notatnika, pipeline'u danych lub innego obsługiwanego elementu przed lub po wdrożeniu elementu.

Plan wdrożenia działa z wykorzystaniem następujących narzędzi wdrożenia:

  • Integracja z usługą Git
  • Ścieżki wdrażania
  • Obsługiwane API REST

W tym artykule narzędzie wdrożeniowe odnosi się do dowolnego z tych wspieranych narzędzi. Nie uruchamia się planu samodzielnie. Dołączasz go, gdy rozpoczynasz operację za pomocą narzędzia wdrożeniowego.

Important

Ta funkcja jest dostępna w wersji zapoznawczej.

Kiedy stosować plan wdrożenia

Stosuj plan wdrożenia, gdy:

Scenario Jak plan pomaga
Przedmioty muszą być rozmieszczone w kolejności, której linia Fabric nie reprezentuje. Plan definiuje wyraźne zależności między grupami wdrożeń.
Praca musi być wykonana przed lub po wdrożeniu przedmiotu. Plan wdrożenia uruchamia obsługiwane elementy w ramach działań wykonywanych przed wdrożeniem lub po wdrożeniu.
Operacja wymaga zarówno jawnych zależności kolejności, jak i zależności elementów Fabric. Fabric łączy plan z linią rodową, gdy ustala kolejność przedmiotów.

Nie potrzebujesz planu wdrożenia, gdy standardowa kolejność narzędzia jest wystarczająca i nie są wymagane żadne działania.

Komponenty planu wdrożenia

Plan wdrożenia zawiera następujące elementy:

Składnik Purpose
Grupa wdrożeń Jeden element do wdrożenia oraz jego działania przed lub po wdrożeniu.
Krok Wdraża element w grupie wdrożeniowej.
Action Uruchomienie obsługiwanego elementu przed wdrożeniem elementu grupy lub po nim.

Aby uzyskać wsparcie dotyczące typów działań i zachowań działania, zobacz działania planu wdrożenia.

Jak działa plan rozmieszczenia

Każda operacja wdrożenia łączy trzy wejścia:

  • Wybrane przedmioty: Przedmioty wybrane do operacji.
  • Plan wdrożenia: Wyraźny porządek i działania związane z tymi elementami.
  • Fabric Lineage: Zależności wykrywane przez Fabric między elementami.

Diagram przedstawiający wybrane elementy, plan wdrożenia oraz linię Fabric łączącą się, aby określić kolejność i działania dla docelowej przestrzeni roboczej.

Określenie zakresu wdrożenia

Narzędzie do wdrożenia określa źródło, cel i elementy w operacji. Dołączenie planu nie zastępuje tego wyboru. Wybrane elementy, które nie znajdują się w grupie wdrożenia, nadal są wdrażane według standardowego zachowania narzędzia.

Dołączenie planu nie powoduje automatycznego wybrania elementów, do których plan się odwołuje. Na powierzchni selektywnego wdrożenia wybierz elementy, które chcesz wdrożyć, i upewnij się, że elementy wymagane przez działania planu są dostępne w docelowej przestrzeni roboczej podczas ich działania.

Plan wdrożenia kontroluje wdrożenie i działania przedmiotów. Nie wdraża konfiguracji na poziomie przestrzeni roboczej, takiej jak tożsamości przestrzeni roboczej, połączenia, powiązania bram czy ustawienia Sparka. Konfiguracja docelowej przestrzeni roboczej przed wykonaniem akcji zależy od tych ustawień.

Rozstrzygnij kolejność rozmieszczenia

Fabric łączy jawne zależności między grupami wdrażania z zależnościami wykrytymi na podstawie rodowodu danych. Plan może dodać kolejność, której lineage nie reprezentuje, ale nie usuwa zależności, które wykrywa Fabric.

Aby zapoznać się ze szczegółowym scenariuszem pokazującym, jak wybrane elementy, zależności planu, pochodzenie i akcje w czasie wykonywania współdziałają, zobacz Przykłady planów wdrożenia.

Uruchom grupy wdrożeń i akcje

Dla każdej grupy wdrożeniowej Fabric wykonuje swoje działania przed wdrożeniem, wdraża element grupy, a następnie wykonuje działania po wdrożeniu. Zależności między grupami i działaniami decydują o ich kolejności. Pozycja przedmiotu w pliku planu nie definiuje jego kolejności.

Dołączenie planu jest opcjonalne. Bez planu wybrane narzędzie wdrożenia korzysta ze standardowego zachowania.

Załącz plan rozmieszczenia

Możesz dołączyć plan, gdy korzystasz z obsługiwanej operacji integracji z Gitem, wdrażasz zawartość przez pipeline wdrożeniowy lub wywołujesz wspierane API REST. Dodatek dotyczy tylko tej operacji. Informacje na temat obsługiwanych powierzchni i sposobu wyboru planu można znaleźć w artykule Dołącz plan wdrażania.

Stwórz i zwersuj plan wdrożenia

Stwórz plan na płótnie planu wdrożenia, gdzie dodajesz grupy wdrożeń, definiujesz ich kolejność i konfigurujesz działania. Instrukcje można znaleźć w artykule Utwórz plan wdrożenia.

Plan wdrożenia to element przestrzeni roboczej. Gdy obszar roboczy jest połączony z repozytorium Git, zatwierdź plan wraz z elementami, do których plan się odwołuje, aby mógł on przejść przez proces CI/CD.

Jeśli operacja się nie powiedzie

Operacja zatrzymuje się, gdy element lub akcja zakończy się niepowodzeniem, i nie wycofuje już wykonanych działań. Informacje o sposobie działania w przypadku niepowodzenia oraz krokach rozwiązywania problemów można znaleźć w artykule Rozwiązywanie problemów z planami wdrażania.

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.

Element Limit
Rozmiar planu 1 MB
Długość nazwy grupy lub kroku 60 znaków
Grupy w planie 1,000
Zależności od grupy 1,000
Czynności przed wdrożeniem w grupie 20
Działania po wdrożeniu w grupie 20
Zależności od działania 20
Parametry działania 20