Udostępnij przez

Co to jest biblioteka zmiennych?

Biblioteka zmiennych usługi Microsoft Fabric to zasobnik zmiennych, które inne elementy w obszarze roboczym mogą być używane w ramach zarządzania cyklem życia aplikacji (ALM). Działa jako element w obszarze roboczym, który zawiera listę zmiennych wraz z odpowiednimi wartościami dla każdego etapu ciągu wydawniczego. Przedstawia ujednolicone podejście do efektywnego zarządzania konfiguracjami elementów w obszarze roboczym, aby zapewnić skalowalność i spójność na różnych etapach cyklu życia.

Na przykład biblioteka zmiennych może zawierać zmienne, które przechowują wartości dla:

  • Liczba całkowita do użycia w działaniu oczekiwania w potoku.
  • Odwołanie typu lakehouse do źródła w działaniu kopiowania danych . Każda wartość jest używana w innym potoku na podstawie etapu wydania potoku.
  • Odwołanie do usługi Lakehouse do skonfigurowania jako domyślnego magazynu lakehouse notesu. Każda wartość jest używana w innym potoku na podstawie etapu wydania notesu.

Rozpoznawanie wartości w przedmiocie konsumenckim niekoniecznie jest związane z jego użyciem. Każdy artykuł konsumencki określa wartość na podstawie własnego kontekstu.

Środowisko biblioteki zmiennych różni się w zależności od typu zmiennej, ale wszystkie biblioteki zmiennych umożliwiają definiowanie zmiennych, których mogą używać inne elementy i zarządzanie nimi.

Biblioteka zmiennych sieci szkieletowej:

  • Jest zgodny z procesami ciągłej integracji i ciągłego dostarczania (CI/CD). Ta zgodność umożliwia integrację z usługą Git i wdrażaniem za pośrednictwem potoków wdrażania.
  • Obsługuje automatyzację za pośrednictwem publicznych interfejsów API sieci Szkieletowej.

Korzyści

Biblioteki zmiennych umożliwiają klientom dostosowywanie i udostępnianie konfiguracji.

Dostosowywanie konfiguracji

Wartość zmiennej można skonfigurować na podstawie etapu potoku wydania. Bibliotekę zmiennych można skonfigurować przy użyciu zestawów wartości: jednej wartości dla każdego etapu potoku wydania. Następnie po jednorazowych ustawieniach aktywnej wartości ustawionej dla każdego etapu poprawna wartość jest automatycznie używana na etapie potoku. Oto kilka przykładów:

  • Zmiana połączenia elementu na podstawie etapu.
  • Przełączanie do innego źródła danych w chmurze na podstawie etapu.
  • Dostosowywanie ilości danych w zapytaniu na podstawie etapu.

Konfiguracje udostępniania

Biblioteki zmiennych zapewniają scentralizowany sposób zarządzania konfiguracjami między elementami obszaru roboczego. Jeśli na przykład masz kilka magazynów typu lakehouse w obszarze roboczym, a każdy z nich ma skrót używający tego samego źródła danych, możesz utworzyć bibliotekę zmiennych z tym źródłem danych jako jedną ze zmiennych. W ten sposób, jeśli chcesz zmienić źródło danych, musisz zmienić je tylko raz w bibliotece zmiennych. Nie trzeba go zmieniać oddzielnie w każdym jeziorze.

Struktura biblioteki zmiennych

Biblioteki zmiennych zawierają co najmniej jedną zmienną. Każda zmienna ma nazwę, typ i wartość domyślną. Możesz również dodać notatkę do każdej zmiennej, aby opisać jej przeznaczenie lub jak go używać.

Zrzut ekranu przedstawiający bibliotekę zmiennych z kilkoma zmiennymi i ich podstawowymi składnikami.

Wartość domyślna

Wartość domyślna to używana wartość, chyba że zdefiniowano inną wartość.

Wszystkie zmienne muszą mieć wartość domyślną. Jeśli typ zmiennej to ciąg, wartość domyślna może mieć nullwartość .

Zestawy wartości alternatywnych

Zestawy wartości definiują wartości każdej zmiennej w bibliotece zmiennych. Biblioteka zmiennych zwykle zawiera wiele zestawów wartości. Aktywny (lub skuteczny) zestaw wartości zawiera wartość otrzymaną przez element odbiorcy dla tego obszaru roboczego.

W każdym obszarze roboczym należy wybrać wartość, która ma być aktywna. Aktywny zestaw wartości obszaru roboczego nie zmienia się podczas wdrażania ani aktualizacji z usługi Git.

Zrzut ekranu przedstawiający bibliotekę zmiennych z kilkoma zestawami wartości alternatywnych.

Podczas tworzenia zestawu wartości alternatywnych zostanie utworzony nowy zestaw wartości z wskaźnikami do wartości domyślnej dla każdej zmiennej. Następnie można zmienić wartość dla każdej zmiennej w nowym zestawie wartości.

Obsługiwane elementy

Następujące elementy obsługują bibliotekę zmiennych:

Zagadnienia i ograniczenia

Ograniczenia rozmiaru plików

  • Może istnieć maksymalnie 1000 zmiennych i maksymalnie 1000 zestawów wartości, o ile spełnisz oba te wymagania:

    • Całkowita liczba komórek w zestawach wartości alternatywnych jest mniejsza niż 10 000.
    • Rozmiar elementu nie przekracza 1 MB.

    Te wymagania są weryfikowane podczas zapisywania zmian.

  • Pole notatki może mieć maksymalnie 2048 znaków.

  • Pole opisu zestawu wartości może zawierać maksymalnie 2048 znaków.

Ograniczenia dotyczące zestawów wartości alternatywnych

  • Zestawy wartości alternatywnych w bibliotece zmiennych są wyświetlane w kolejności, w której zostały dodane. Obecnie nie można zmienić ich kolejności w interfejsie użytkownika. Aby zmienić kolejność, przeprowadź bezpośrednią edycję pliku JSON.
  • Nazwa każdego zestawu wartości musi być unikatowa w bibliotece zmiennych.
  • Nazwy zmiennych muszą być unikatowe w bibliotece zmiennych. Jeśli znajdują się w różnych elementach, możesz mieć dwie zmienne o tej samej nazwie w obszarze roboczym.
  • Zawsze istnieje jedna (i tylko jedna) aktywna wartość ustawiona w bibliotece zmiennych jednocześnie. Nie można usunąć zestawu wartości, gdy jest ona aktywna. Aby go usunąć, najpierw skonfiguruj kolejną wartość, która ma być aktywna. Dla każdego etapu potoku wdrażania można mieć inny aktywny zestaw wartości.

Powiązana zawartość

  • Last updated on