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.

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.
  • 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.

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

Biblioteka Zmiennych w Fabric to system ustrukturyzowany przeznaczony do zarządzania parametrami konfiguracji między obszarami roboczymi i etapami wdrażania. Podstawowe są zmienne zdefiniowane przez użytkownika, które mogą być typami podstawowymi (takimi jak ciąg, liczba całkowita, wartość logiczna) lub typy złożone, takie jak odwołania do elementów. Te zmienne są grupowane w elemencie Biblioteki zmiennych i mogą być przywoływane przez elementy użytkownika w tym samym obszarze roboczym.

Aby obsługiwać konfigurację dynamiczną, każda zmienna może mieć wiele zestawów wartości lub alternatywnych zestawów wartości dostosowanych do różnych środowisk (np. deweloperskich, testowych, prod). Jeden zestaw wartości jest wyznaczony jako "aktywny" dla obszaru roboczego, określając, które wartości są używane w czasie wykonywania.

Użytkownicy mogą tworzyć, edytować zmienne i zestawy wartości oraz zarządzać nimi za pośrednictwem interfejsu użytkownika lub interfejsów API sieci szkieletowej z wbudowanymi sprawdzaniem poprawności i uprawnień. System obsługuje przepływy pracy CI/CD, umożliwiając zarządzanie zmiennymi jako kodem, integrację z narzędziem Git i wdrażanie za pośrednictwem potoków. Ta struktura zapewnia skalowalne, zautomatyzowane i zarządzane zarządzanie konfiguracją w złożonych systemach danych.

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

Obsługiwane elementy

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

Konwencje nazewnictwa

Nazwa samego elementu biblioteki zmiennych musi być zgodna z następującymi konwencjami:

  • Nie jest pusty
  • Nie ma spacji wiodących ani końcowych
  • Zaczyna się literą
  • Może zawierać litery, cyfry, podkreślenia, łączniki i spacje
  • Długość nie przekracza 256 znaków

Nazwa biblioteki zmiennych nie uwzględnia wielkości liter.

Zagadnienia i ograniczenia

Ograniczenia dotyczące zmiennych

  • 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