Udostępnij za pomocą

Samouczek: dostosowywanie i udostępnianie konfiguracji elementów za pomocą bibliotek zmiennych

W tym samouczku pokazano, jak używać zawartości dynamicznej w potokach usługi Microsoft Fabric. Podczas tworzenia elementu biblioteki zmiennych i dodawania do niego zmiennych można zautomatyzować wartości dla różnych etapów potoku wdrażania. W tym samouczku skopiujesz dane z jednego magazynu lakehouse do innego. Następnie użyjesz biblioteki zmiennych, aby ustawić wartości źródłowe i docelowe dla działania kopiowania.

W tym samouczku nauczysz się następujących rzeczy:

  • Utwórz bibliotekę zmiennych.
  • Dodaj zmienne do biblioteki.
  • Zdefiniuj dodatkowe zestawy wartości dla zmiennych.
  • Zużyj zmienne w innym elemencie w obszarze roboczym (potok).
  • Edytuj zmienne w repozytorium Git.
  • Utwórz potok wdrażania i wdróż bibliotekę zmiennych.
  • Zmień aktywny zestaw wartości na etapie docelowym potoku wdrażania.
  • Pokaż, że wartość zmiennej jest zgodna z aktywnym zestawem wartości w każdym etapie.

Na poniższym diagramie przedstawiono układ obszaru roboczego dla tego samouczka.

Diagram układu obszaru roboczego.

Wymagania wstępne

Tworzenie obszaru roboczego Etap LHs, SourceLH_Stage lakehouse z przykładowymi danymi i potokiem Pipeline_Stage

Najpierw utwórz obszar roboczy i lakehouse, który będzie używany jako początkowe dane przejściowe:

  1. Przejdź do usługi Power BI.

  2. Na pasku bocznym wybierz pozycję Obszar roboczy.

  3. Utwórz obszar roboczy. Nazywaj go etapem LHs.

    Zrzut ekranu przedstawiający przycisk tworzenia nowego obszaru roboczego.

  4. Utwórz jezioro:

    1. W górnej części obszaru roboczego wybierz pozycję Nowy element.

    2. W obszarze Przechowywanie danych wybierz pozycję Lakehouse.

      Zrzut ekranu przedstawiający kafelek służącą do wybierania usługi Lakehouse jako nowego elementu.

    3. Wprowadź nazwę SourceLH_Stage, a następnie wybierz pozycję Utwórz.

  5. Tworzenie potoku:

    1. W lakehouse wybierz pozycję Nowy potok.

      Zrzut ekranu przedstawiający kafelek umożliwiający utworzenie nowego potoku.

    2. Wprowadź nazwę Pipeline_Stage, a następnie wybierz pozycję Utwórz.

    3. W kreatorze Kopiowanie danych do usługi Lakehouse na stronie Wybieranie źródła danych wybierz pozycję Przykładowe dane.

      Zrzut ekranu przedstawiający stronę wybierania źródła danych do kopiowania danych do magazynu typu lakehouse.

    4. Wybierz pozycję Dni wolne od pracy.

      Zrzut ekranu przedstawiający wybieranie przykładowych danych dni wolnych od pracy.

    5. Po zakończeniu ładowania przykładowych danych wybierz pozycję Dalej.

    6. Na stronie Łączenie z miejscem docelowym danych wybierz pozycję Dalej.

      Zrzut ekranu przedstawiający szczegóły miejsca docelowego potoku.

    7. Na stronie Przeglądanie i zapisywanie wybierz pozycję Zapisz i uruchom.

      Zrzut ekranu przedstawiający stronę do zapisywania i uruchamiania potoku.

Tworzenie źródłowej biblioteki LHs z obszarem roboczym Zmienne

Teraz utwórz obszar roboczy, z którego będziesz korzystać i którego będziesz używać z biblioteką zmiennych:

  1. Przejdź do usługi Power BI.

  2. Na pasku bocznym wybierz pozycję Obszar roboczy.

  3. Utwórz obszar roboczy. Wywołaj źródło LHs ze zmiennymi.

Tworzenie SourceLH_Dev, SourceLH_Test i SourceLH_Prod lakehouses

Następnie utwórz trzy magazyny lakehouse do użycia z biblioteką zmiennych:

  1. Utwórz pierwszy lakehouse:

    1. Na pasku bocznym wybierz obszar roboczy Źródło LHs ze zmiennymi .

    2. Wybierz pozycję Nowy element.

    3. W obszarze Przechowywanie danych wybierz pozycję Lakehouse.

    4. Wprowadź nazwę SourceLH_Dev, a następnie wybierz pozycję Utwórz.

  2. Utwórz drugi lakehouse, wykonując powyższe kroki. Nadaj mu nazwę SourceLH_Test.

  3. Utwórz trzeci lakehouse, wykonując powyższe kroki. Nadaj mu nazwę SourceLH_Prod.

  4. Na pasku bocznym wybierz obszar roboczy Źródło LHs ze zmiennymi i upewnij się, że zawiera on wszystkie nowo utworzone magazyny typu lakehouse.

Pobieranie identyfikatorów obszarów roboczych i identyfikatorów obiektów dla usług lakehouse

W tych krokach uzyskasz unikatowe identyfikatory do użycia w bibliotece zmiennych:

  1. Na pasku bocznym usługi Power BI wybierz obszar roboczy Etap LHs .

  2. W obszarze roboczym wybierz SourceLH_Stage lakehouse.

  3. Skopiuj identyfikator obszaru roboczego i identyfikator obiektu lakehouse w adresie URL.

    Zrzut ekranu przedstawiający sposób uzyskiwania identyfikatora obszaru roboczego i identyfikatora obiektu lakehouse.

  4. Powtórz powyższe kroki dla SourceLH_Dev i SourceLH_Test lakehouses w obszarze roboczym Źródło LHs ze zmiennymi .

Tworzenie biblioteki zmiennych ze zmiennymi

Teraz utwórz bibliotekę zmiennych:

  1. W obszarze roboczym Źródło LHs ze zmiennymi wybierz pozycję Nowy element.

  2. W obszarze Opracowywanie danych wybierz pozycję **Biblioteka zmiennych **.

    Zrzut ekranu przedstawiający kafelek umożliwiający utworzenie biblioteki zmiennych.

  3. Nadaj bibliotece nazwę zmiennych WS, a następnie wybierz pozycję Utwórz.

  4. Wybierz pozycję Nowa zmienna.

    Zrzut ekranu przedstawiający przycisk wybierania nowej zmiennej.

  5. Utwórz następujące zmienne:

    Name Typ Domyślny zestaw wartości
    Source_LH Sznurek <Identyfikator GUID SourceLH_Stage lakehouse>
    Source_WSID Sznurek <Identyfikator GUID obszaru roboczego SourceLH_Stage>
    Destination_LH Sznurek <Identyfikator GUID SourceLH_Dev lakehouse>
    Destination_WSID Sznurek <Identyfikator GUID obszaru roboczego SourceLH_Dev>
    SourceTable_Name Sznurek Processed
    DestinationTable_Name Sznurek DevCopiedData

    Zrzut ekranu przedstawiający gotowy zestaw domyślny dla biblioteki zmiennych.

  6. Wybierz Zapisz.

Tworzenie alternatywnych zestawów wartości

W tych krokach dodasz zestawy wartości alternatywnych do biblioteki zmiennych:

  1. Utwórz pierwszy zestaw wartości:

    1. W bibliotece zmiennych WS wybierz pozycję Dodaj zestaw wartości.

    2. Wprowadź frazę Test VS dla nazwy, a następnie wybierz pozycję Utwórz.

    3. Utwórz następujące zmienne:

      Name Typ Domyślny zestaw wartości
      Source_LH Sznurek <Identyfikator GUID SourceLH_Dev lakehouse>
      Source_WSID Sznurek <Identyfikator GUID obszaru roboczego SourceLH_Dev>
      Destination_LH Sznurek <Identyfikator GUID SourceLH_Test lakehouse>
      Destination_WSID Sznurek <Identyfikator GUID obszaru roboczego SourceLH_Test>
      SourceTable_Name Sznurek DevCopiedData
      DestinationTable_Name Sznurek TestCopiedData

    4. Wybierz pozycję Zapisz>zgadzam się.

  2. Utwórz drugi zestaw wartości:

    1. Wybierz pozycję Dodaj zestaw wartości.

    2. Wprowadź ciąg Prod VS jako nazwę, a następnie wybierz pozycję Utwórz.

    3. Utwórz następujące zmienne:

      Name Typ Domyślny zestaw wartości
      Source_LH Sznurek <Identyfikator GUID SourceLH_Test lakehouse>
      Source_WSID Sznurek <Identyfikator GUID obszaru roboczego SourceLH_Test>
      Destination_LH Sznurek <Identyfikator GUID SourceLH_Prod lakehouse>
      Destination_WSID Sznurek <Identyfikator GUID obszaru roboczego SourceLH_Prod>
      SourceTable_Name Sznurek TestCopiedData
      DestinationTable_Name Sznurek ProdCopiedData

      Zrzut ekranu przedstawiający gotowe wartości alternatywne w bibliotece zmiennych.

    4. Wybierz pozycję Zapisz>zgadzam się.

Tworzenie potoku Pipeline_Deploy i deklarowanie zmiennych

W tych krokach utworzysz potok i zadeklarujesz zmienne:

  1. W obszarze roboczym Źródło LHs ze zmiennymi wybierz pozycję Nowy element.

  2. W obszarze Pobieranie danych wybierz pozycję Potok.

    Zrzut ekranu przedstawiający płytkę potoku.

  3. Wprowadź nazwę Pipeline_Deploy, a następnie wybierz pozycję Utwórz.

  4. Wybierz pozycję Kopiuj dane>Dodaj do kanwy.

    Zrzut ekranu przedstawiający opcje menu umożliwiające dodawanie kopii danych do kanwy.

  5. Wybierz kanwę, aby fokus był wyłączony Kopiuj dane.

  6. Wybierz **Zmienne biblioteki**.

    Zrzut ekranu przedstawiający kartę zmiennych biblioteki.

  7. Wybierz pozycję Nowy, a następnie dodaj następujące zmienne:

    Name Biblioteka Nazwa zmiennej Typ
    SourceLH Zmienne programu WS Source_LH Sznurek
    SourceWSID Zmienne programu WS Source_WSID Sznurek
    DestinationLH Zmienne programu WS Destination_LH Sznurek
    DestinationWSID Zmienne programu WS Destination_WSID Sznurek
    SourceTableName Zmienne programu WS SourceTable_Name Sznurek
    DestinationTableName Zmienne programu WS DestinationTable_Name Sznurek

    Zrzut ekranu przedstawiający dodawanie zmiennych do potoku.

  8. Wybierz Zapisz.

Konfigurowanie połączenia źródłowego dla potoku Pipeline_Deploy

W tych krokach skonfigurujesz połączenie źródłowe dla potoku:

  1. W obszarze roboczym Źródło LHs ze zmiennymi przejdź do Pipeline_Deploy.

  2. Na kanwie wybierz pozycję Kopiuj dane , aby skupić się na kopiowaniu danych.

  3. Wybierz pozycję Źródło.

  4. Konfigurowanie źródłaLH:

    1. W obszarzePołączenie> wybierz pozycję Dodaj zawartość dynamiczną.

    2. Wybierz wielokropek (...), a następnie wybierz **Zmienne biblioteki**.

    3. Wybierz pozycję ŹródłoLH. Spowoduje to wypełnienie pola ciągiem @pipeline().libraryVariables.SourceLH. Kliknij przycisk OK.

      Zrzut ekranu przedstawiający okienko dodawania zawartości dynamicznej dla źródła połączenia.

  5. Konfigurowanie identyfikatora SourceWSID:

    1. W obszarze Źródłowy>identyfikator obszaru roboczego wybierz pozycję Dodaj zawartość dynamiczną.

    2. Wybierz wielokropek (...), a następnie wybierz **Zmienne biblioteki**.

    3. Wybierz pozycję SourceWSID. Spowoduje to wypełnienie pola ciągiem @pipeline().libraryVariables.SourceWSID. Kliknij przycisk OK.

      Zrzut ekranu przedstawiający okienko służące do dodawania zawartości dynamicznej dla źródła obszaru roboczego.

  6. Skonfiguruj element SourceTableName:

    1. W obszarze Tabela źródłowa> wybierz pozycję Wprowadź ręcznie, wybierz pozycję Nazwa tabeli, a następnie wybierz pozycję Dodaj zawartość dynamiczną.

    2. Wybierz wielokropek (...), a następnie wybierz **Zmienne biblioteki**.

    3. Wybierz pozycję SourceTableName. Spowoduje to wypełnienie pola ciągiem @pipeline().libraryVariables.SourceTableName. Kliknij przycisk OK.

      Zrzut ekranu przedstawiający okienko służące do dodawania zawartości dynamicznej dla nazwy tabeli.

  7. Teraz, po skonfigurowaniu połączenia źródłowego, możesz go przetestować. Wybierz pozycję Podgląd danych, a następnie wybierz przycisk OK na wysuwaniu. Po wypełnieniu danych możesz zamknąć podgląd danych.

    Zrzut ekranu przedstawiający podgląd danych dla połączenia źródłowego.

Konfigurowanie połączenia docelowego dla potoku Pipeline_Deploy

W tych krokach skonfigurujesz połączenie docelowe dla potoku:

  1. W obszarze roboczym Źródło LHs ze zmiennymi przejdź do Pipeline_Deploy.

  2. Na kanwie wybierz pozycję Kopiuj dane , aby skupić się na kopiowaniu danych.

  3. Wybierz pozycję Miejsce docelowe.

  4. Konfigurowanie źródłaLH:

    1. W obszarzePołączenie> wybierz pozycję Dodaj zawartość dynamiczną.

    2. Wybierz wielokropek (...), a następnie wybierz **Zmienne biblioteki**.

    3. Wybierz pozycję ŹródłoLH. Spowoduje to wypełnienie pola ciągiem @pipeline().libraryVariables.DestinationLH. Kliknij przycisk OK.

      Zrzut ekranu przedstawiający okienko służące do dodawania zawartości dynamicznej dla miejsca docelowego połączenia.

  5. Skonfiguruj identyfikator DestinationWSID:

    1. W obszarze Identyfikator docelowego>obszaru roboczego wybierz pozycję Dodaj zawartość dynamiczną.

    2. Wybierz wielokropek (...), a następnie wybierz **Zmienne biblioteki**.

    3. Wybierz pozycję DestinationWSID. Spowoduje to wypełnienie pola ciągiem @pipeline().libraryVariables.DestinationWSID. Kliknij przycisk OK.

      Zrzut ekranu przedstawiający okienko dodawania zawartości dynamicznej dla miejsca docelowego obszaru roboczego.

  6. Konfigurowanie elementu DestinationTableName:

    1. W obszarze Tabela docelowa> wybierz pozycję Wprowadź ręcznie, wybierz pozycję Nazwa tabeli, a następnie wybierz pozycję Dodaj zawartość dynamiczną.

    2. Wybierz wielokropek (...), a następnie wybierz **Zmienne biblioteki**.

    3. Wybierz pozycję DestinationTableName. Spowoduje to wypełnienie pola ciągiem @pipeline().libraryVariables.DestinationTableName. Kliknij przycisk OK.

      Zrzut ekranu przedstawiający okienko służące do dodawania zawartości dynamicznej dla nazwy tabeli docelowej.

  7. Po skonfigurowaniu połączenia docelowego zapisz potok i wybierz pozycję Uruchom. Upewnij się, że została pomyślnie uruchomiona.

    Zrzut ekranu przedstawiający przebieg potoku.

Tworzenie potoku wdrażania

Teraz utwórz potok wdrażania:

  1. W obszarze roboczym Source LHs with Variables (Źródła LHs z zmiennymi ) wybierz pozycję Create deployment pipeline (Utwórz potok wdrażania).

  2. Nadaj potokowi nazwę Deployment_Pipeline_Var, a następnie wybierz pozycję Dalej.

    Zrzut ekranu przedstawiający okienko nazewnictwa nowego potoku wdrażania.

  3. W potoku wdrażania wybierz pozycję Utwórz i kontynuuj.

    Zrzut ekranu przedstawiający przycisk tworzenia potoku wdrażania.

  4. Na etapie programowania :

    1. Z listy rozwijanej wybierz pozycję Źródłowe pliki LHs ze zmiennymi dla obszaru roboczego. Następnie wybierz znacznik wyboru Przypisz .

      Zrzut ekranu przedstawiający wybieranie obszaru roboczego dla nowego potoku wdrażania.

    2. Wybierz Kontynuuj. Etap powinien być teraz wypełniany elementami z obszaru roboczego.

      Zrzut ekranu przedstawiający część programowania potoku wdrażania.

  5. Dla etapu testowego :

    1. Zaznacz pole wyboru u góry, aby zaznaczyć wszystkie elementy. Następnie wyczyść pole wyboru dla SourceLH_Dev lakehouse.

    2. Wybierz przycisk Wdróż . Wybierz ponownie pozycję Wdróż . Etap testu powinien zostać wypełniony.

      Zrzut ekranu przedstawiający część testową nowego potoku wdrażania.

  6. Dla etapu Produkcja :

    1. Zaznacz pole wyboru u góry, aby zaznaczyć wszystkie elementy. Następnie wyczyść pole wyboru dla SourceLH_Test lakehouse.

    2. Wybierz przycisk Wdróż . Wybierz ponownie pozycję Wdróż . Etap produkcyjny powinien być teraz wypełniony.

      Zrzut ekranu przedstawiający część produkcyjną nowego potoku wdrażania.

Ustawianie aktywnego zestawu biblioteki zmiennych dla każdego etapu

W tych krokach skonfigurujesz aktywny zestaw dla każdego etapu w potoku wdrażania:

  1. Skonfiguruj aktywny zestaw dla etapu testowego :

    1. Na pasku bocznym wybierz potok Deployment_Pipeline_Var .

    2. Wybierz etap testowy .

      Zrzut ekranu przedstawiający etap testu.

    3. Wybierz pozycję Zmienne WS.

    4. Wybierz wielokropek (...), a następnie wybierz pozycję Ustaw jako aktywny. Wybierz przycisk Ustaw jako aktywny .

      Zrzut ekranu przedstawiający bibliotekę zmiennych z opcjami ustawiania etapu testu jako aktywnego.

      Aktywny zestaw jest teraz skonfigurowany.

      Zrzut ekranu przedstawiający skonfigurowany aktywny zestaw w potoku wdrażania.

    5. Wybierz pozycję Zapisz>zgadzam się.

  2. Skonfiguruj aktywny zestaw dla etapu Prod :

    1. Na pasku bocznym wybierz potok Deployment_Pipeline_Var .

    2. Wybierz etap Prod .

    3. Wybierz pozycję Zmienne WS.

    4. Wybierz wielokropek (...), a następnie wybierz pozycję Ustaw jako aktywny. Wybierz przycisk Ustaw jako aktywny .

    5. Wybierz pozycję Zapisz>zgadzam się.

Weryfikowanie i testowanie biblioteki zmiennych

Po skonfigurowaniu biblioteki zmiennych i skonfigurowaniu wszystkich aktywnych zestawów dla każdego etapu potoku wdrażania można je zweryfikować:

  1. Sprawdź SourceLHs_Dev lakehouse:

    1. W obszarze roboczym Source LHs with Variables (Źródła LHs z zmiennymi ) wybierz SourceLHs_Dev lakehouse.

    2. Zmień połączenie z Lakehouse na punkt końcowy analizy SQL.

    3. W eksploratorze rozwiń węzeł Schemas dboTables (Tabele>>).

    4. Upewnij się, że zostanie wyświetlona tabela DevCopiedData .

      Zrzut ekranu przedstawiający obszar tabel w eksploratorze.

  2. Przejdź do SourceLHs_Test lakehouse i powtórz powyższe kroki.

    Tabela TestCopiedData nie powinna być wyświetlana, ponieważ nie uruchomiono jeszcze potoku z aktywnym zestawem testowego programu VS .

  3. Przejdź do SourceLHs_Prod lakehouse i powtórz powyższe kroki.

    Tabela ProdCopiedData nie powinna być wyświetlana, ponieważ potok nie został jeszcze uruchomiony z aktywnym zestawem programu VS Prod .

  4. Sprawdź etap testowania potoku Deployment_Pipeline_Var :

    1. Przejdź do potoku Deployment_Pipeline_Var i wybierz etap Testuj .

    2. Wybierz potok Pipeline_Deploy .

    3. Wybierz pozycję Uruchom. Ten proces powinien zakończyć się pomyślnie.

  5. Ponownie sprawdź SourceLHs_Test lakehouse:

    1. Przejdź do SourceLHs_Test lakehouse.

    2. Zmień połączenie z Lakehouse na punkt końcowy analizy SQL.

    3. W eksploratorze rozwiń węzeł Schemas dboTables (Tabele>>).

    4. Upewnij się, że zostanie wyświetlona tabela TestCopiedData .

      Zrzut ekranu przedstawiający obszar tabel i podgląd danych w eksploratorze.

  6. Sprawdź etap Produkcyjny potoku Deployment_Pipeline_Var :

    1. Przejdź do potoku Deployment_Pipeline_Var i wybierz etap Produkcyjny .

    2. Wybierz potok Pipeline_Deploy .

    3. Wybierz pozycję Uruchom. Ten proces powinien zakończyć się pomyślnie.

  7. Ponownie sprawdź SourceLHs_Prod lakehouse:

    1. Przejdź do SourceLHs_Prod lakehouse.

    2. Zmień połączenie z Lakehouse na punkt końcowy analizy SQL.

    3. W eksploratorze rozwiń węzeł Schemas dboTables (Tabele>>).

    4. Upewnij się, że zostanie wyświetlona tabela ProdCopiedData .

Dostosowywanie wartości zmiennych w usłudze Git (opcjonalnie)

Aby zobaczyć, jak biblioteka zmiennych jest reprezentowana w usłudze Git lub edytować zmienne z repozytorium Git:

  1. W obszarze roboczym wybierz pozycję Kontrola źródła i połącz obszar roboczy z repozytorium Git.

  2. W okienku Kontrola źródła wybierz pozycję Zatwierdź , aby wypchnąć zawartość obszaru roboczego do repozytorium Git.

    Repozytorium Git zawiera folder dla każdego elementu w obszarze roboczym. Folder o nazwie Zmienne WS. ZmiennaLibrary reprezentuje element biblioteki zmiennych. Aby uzyskać więcej informacji na temat zawartości tego folderu, zobacz Ciągła integracja/ciągłe wdrażanie biblioteki zmiennych.

  3. Porównaj pliki ProdVS.json i TestVS.json w folderze valueSets . Upewnij się, że zmienna overrides jest ustawiona na różne wartości. Te wartości można edytować bezpośrednio w interfejsie użytkownika lub edytując ten plik w usłudze Git i aktualizując go do obszaru roboczego.

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

Powiązana zawartość

  • Last updated on