Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
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-cicdnie 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 |