Przykłady planów wdrożenia (zapowiedź)

W tym artykule przedstawiono typowe zastosowania planów wdrożenia. Każda z nich opisuje grupy wdrożeń i powiązane z nimi akcje, dzięki czemu można zbudować odpowiednik na płótnie.

Aby dowiedzieć się, jak stworzyć plan, zobacz : Utwórz plan wdrożenia.

Wdroż element zależny od danych, które inny element generuje

To najczęstszy powód, aby skorzystać z planu.

Obszar roboczy

Zespół sprzedaży przechowuje swoje rozwiązanie analityczne w jednej przestrzeni roboczej połączonej z gitami, która mieści cztery elementy:

Dlaczego sama kolejność rozmieszczenia nie wystarcza

Fabric wykorzystuje linię przedmiotów, aby wykryć, że widok magazynu odnosi się do stołu nad domem nad jeziorem, więc rozkłada dom nad jeziorem przed magazynem.

Lineage nie pokazuje, że tabela musi zostać wypełniona , zanim widok będzie ważny. Tabela nie jest dostarczana z definicją elementu. Te dwa notatniki generują go w czasie wykonywania:

Wdrożenie tego workspace bez planu powoduje niepowodzenie. Każdy element jest poprawnie kopiowany, ale widok magazynu jest tworzony na tabeli, której nikt jeszcze nie stworzył, a wdrożenie informuje, że nazwa obiektu jest nieprawidłowa. Cel pozostaje częściowo rozmieszczony.

Z tymi przedmiotami nic nie jest nie tak. Brakuje jednak instrukcji uruchamiania notatników między rozstawieniem domku nad jeziorem a rozstawieniem magazynu. Ta instrukcja jest planem.

Plan

Plan przewiduje dwie grupy rozmieszczenia – jedną przy domku nad jeziorem, a drugą dla magazynu. Grupa Lakehouse uruchamia oba notatniki jako działania po wdrożeniu:

Po wdrożeniu lakehouse składnik Hydrate_TopCustomers zapisuje wiersze źródłowe. Następnie Publish_TopCustomers tworzy dbo.top_customers i czeka, aż endpoint analityki SQL udostępni tabelę. Grupa Lakehouse kończy dopiero po zakończeniu obu akcji. Fabric może wtedy wdrożyć magazyn i utworzyć jego widok.

Notatniki to działania w grupie Lakehouse, a nie oddzielne grupy wdrożenia. Publish_TopCustomers To zależy od Hydrate_TopCustomers, a grupa magazynowa zależy od ukończonej grupy Lakehouse.

Oto ten sam plan na płótnie:

Zrozum strukturę plan.yml

Budujesz plan na płótnie. Gdy przestrzeń robocza jest połączona z Gitem, plan jest przechowywany jako plan.yml plik w folderze elementu planu wdrożenia, więc jest przeglądany i wersjonowany jak każdy inny element:

$schema: https://developer.microsoft.com/json-schemas/fabric/item/deploymentPlan/definition/plan/1.0.0/schema.json
version: 1.0.0
groups:
  - name: Sales_Lakehouse
    logicalId: 11111111-1111-1111-1111-111111111111
    postActions:
      - name: Run Hydrate_TopCustomers
        job:
          type: Execute
          logicalId: 22222222-2222-2222-2222-222222222222
      - name: Run Publish_TopCustomers
        dependsOn:
          - actionName: Run Hydrate_TopCustomers
        job:
          type: Execute
          logicalId: 33333333-3333-3333-3333-333333333333
  - name: Sales_Warehouse
    logicalId: 44444444-4444-4444-4444-444444444444
    dependsOn:
      - groupName: Sales_Lakehouse

Plik ma następującą strukturę:

Kilka rzeczy, które warto zauważyć w tej definicji:

• Grupa wymienia jeden przedmiot. logicalId jest logicznym identyfikatorem elementu, tym samym identyfikatorem, którego używa integracja z Gitem, więc plan pozostaje ważny, gdy element przemieszcza się między przestrzeniami roboczymi.
• Kolejność grup wyraża się przez dependsOn, a nie przez pozycję w pliku. Zmiana porządku grup w pliku nic nie zmienia.
• Kolejność akcji wyraża się również jako .dependsOn Run Publish_TopCustomers rozpoczyna się dopiero po zakończeniu Run Hydrate_TopCustomers.
• postActions uruchom po wdrożeniu elementu grupy. Używaj preActions w pracy, która musi się najpierw wykonać, na przykład w przypadku weryfikacji.

Odśwież treść po wdrożeniu

Wdrożenie aktualizuje definicje elementów. Nie uruchamia niczego, więc model semantyczny lub raport odzwierciedla nową definicję, ale nie nowe dane.

Dołącz ten plan do wdrożenia pipeline'u wdrożeniowego, aby promowanie na etap pozostawiło cel gotowy do użycia, zamiast wymagać ręcznego odświeżania.

Waliduj przed wdrożeniem czegokolwiek

Akcja przed wdrożeniem jest uruchamiana przed wdrożeniem elementu w swojej grupie, więc można jej użyć jako bramki.

Akcja może uruchomić tylko element, który został już wdrożony, więc samo sprawdzenie jest wdrażane przez wcześniejszą grupę:

Jeśli sprawdzenie się nie powiedzie, wdrożenie zatrzymuje się i nic, co zależy od tej grupy, nie zostanie wdrożone. Użyj tego, aby potwierdzić, że połączenia są prawidłowo rozpoznawane, że wymagana przepustowość jest dostępna lub że system źródłowy jest dostępny przed rozpoczęciem wdrożenia.

Rozkazuj dzieła, których linia rodowa nie może zobaczyć

Dwa przedmioty mogą być całkowicie niezależne pod względem pochodzenia i nadal wymagać kolejności. Plan to sposób, w jaki to wyrażasz.

Ponieważ zależność działa przez połączenie, a nie przez referencję do elementu, Fabric nie może jej wywnioskować. Plan określa kolejność.

Treści powiązane

• Czym jest plan rozmieszczenia?
• Stwórz plan wdrożenia
• Działania planu rozmieszczenia
• Rozwiązywanie problemów z planami wdrożenia