Typy zmiennych w bibliotekach zmiennych

Biblioteka zmiennych w usłudze Microsoft Fabric to wyspecjalizowany element, który centralizuje definicję zmiennych i zarządzanie nimi, umożliwiając skalowalną i zautomatyzowaną konfigurację między obszarami roboczymi i elementami.

Zmienne w bibliotece zmiennych mogą być typami podstawowymi lub zaawansowanymi, a każda zmienna jest unikatowo identyfikowana przez jej nazwę w elemencie biblioteki.

• Podstawowe typy zmiennych w bibliotece zmiennych obejmują proste, typy danych, takie jak wartość logiczna, data/godzina (w formacie ISO 8601 UTC), identyfikator GUID, liczba całkowita, liczba i ciąg. Są to proste wartości, które można przypisać bezpośrednio i używać w różnych etapach i środowiskach.
• Zaawansowane typy zmiennych są przeznaczone dla bardziej zaawansowanych przypadków użycia, takich jak odwoływanie się do wewnętrznych elementów sieci szkieletowej lub połączeń zewnętrznych. Należą do nich typy "referencje elementów", które przechowują identyfikatory obszarów roboczych i elementów w celu wskazywania określonych elementów Fabric.

Obsługiwane typy w bibliotekach zmiennych

Zmienne w bibliotece zmiennych mają następujące obsługiwane typy zmiennych

TypeType	Kategoria	Description
logiczny	Basic	Reprezentuje wartości true/false.
Integer	Basic	Liczby całkowite bez liczb dziesiętnych.
Number	Basic	Wartości liczbowe, w tym liczby dziesiętne.
Sznurek	Basic	Wartości tekstowe lub sekwencje znaków.
DateTime	Basic	Data i godzina reprezentowana jako standard ISO 8601 rrrr-MM-ddTHH:mm:ss.xxxZ, gdzie: yy-MM-dd to czterocyfrowy rok, po którym następuje dwucyfrowy miesiąc i dwucyfrowy dzień. T oddziela datę i godzinę. HH:mm:ss.xxx to dwucyfrowa godzina w formacie 24-godzinnym, a następnie dwucyfrowa minuta, dwucyfrowa sekunda i trzycyfrowa milisekunda. Z wskazuje, że czas jest w uniwersalnym czasie koordynowanym (UTC).
Przewodnik	Basic	Unikatowy identyfikator globalny używany do identyfikacji odrębnych obiektów.
Referencja elementu	Zaawansowany	Używana w bibliotece zmiennych Fabric do przechowywania odwołania do istniejącego elementu Fabric, takiego jak lakehouse, notes lub potok danych, przez przechowywanie identyfikatora obszaru roboczego i identyfikatora elementu.

Właściwości zmiennych

Każda zmienna w bibliotece zmiennych ma następujące właściwości:

Majątek	Description
Name	Unikatowy identyfikator zmiennej. Służy do odwołowania się do zmiennej w skryptach lub przepływach pracy.
Uwaga (opcjonalnie)	Opisowy komentarz lub adnotacja dotycząca zmiennej. Może zawierać kontekst, uwagi dotyczące użycia lub instrukcje specjalne. Maksymalna długość: 2048 znaków.
Typ	Definiuje typ danych zmiennej (np. ciąg, liczba całkowita, wartość logiczna, tablica). Określa, jak wartość jest interpretowana i weryfikowana.
Domyślny zestaw wartości	Wartość początkowa przypisana do zmiennej, gdy nie zostanie podana żadna inna wartość. Zapewnia spójne zachowanie w przepływach pracy. Nie można zmienić nazwy domyślnego zestawu wartości.
Zestawy wartości alternatywnych (opcjonalnie)	Dodatkowe wstępnie zdefiniowane zestawy wartości, które można zastosować w określonych warunkach lub scenariuszach. Przydatne w przypadku konfiguracji specyficznych dla środowiska lub opcji rezerwowych.

Konwencje nazewnictwa

Nazwa zmiennej

Nazwa zmiennej w bibliotece zmiennych musi być zgodna z następującymi konwencjami:

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

W nazwie zmiennej nie jest uwzględniana wielkość liter.

Gdy zmienna ma zdefiniowaną wartość, jeśli spróbujesz zmienić jej typ, zostanie wyświetlone okno dialogowe zgody. W oknie dialogowym zostanie wyświetlone alerty, że wszystkie wartości zmiennych zostaną zresetowane i że ta zmiana może być zmianą powodującą niezgodność po stronie elementu odbiorcy.

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.