Typ zmiennej referencyjnej elementu (wersja zapoznawcza)

Aby zwiększyć elastyczność i skalowalność, wprowadzamy zaawansowane zmienne wraz z istniejącymi podstawowymi typami zmiennych. Te zaawansowane zmienne zostały zaprojektowane tak, aby spełniały kluczowe wymagania, takie jak parametryzacja połączeń zewnętrznych i wewnętrznych (np. Snowflake, AWS, OneLake).

Zmienne odwołania do elementu są zaawansowanym typem zmiennych używanym w bibliotece zmiennych Fabric do przechowywania odwołania do istniejącego elementu Fabric, takiego jak lakehouse, notes lub potok danych, poprzez przechowywanie identyfikatora obszaru roboczego i identyfikatora elementu. Ten typ zmiennej umożliwia parametryzację połączenia wewnętrznego, umożliwiając deweloperom dynamiczne łączenie elementów z określonymi elementami Fabric na podstawie etapu wdrożenia lub kontekstu obszaru roboczego.

Jak stosować

Zmienna referencyjna elementu może być używana tak samo jak inne zmienne w bibliotece zmiennych.

  1. Zaloguj się do Fabric.
  2. Przejdź do swojego obszaru roboczego i biblioteki zmiennych
  3. U góry wybierz pozycję + Nowa zmienna
  4. Podaj nazwę zmiennej, wybierz odwołanie do elementu dla typu, a następnie kliknij przycisk ... , aby wybrać wartość
  5. Spowoduje to otwarcie okna dialogowego w celu wybrania żądanego elementu. Zobaczysz wszystkie elementy, dla których masz uprawnienia, dostępne do wyboru. Użyj eksploratora po lewej stronie, aby filtrować listę według obszaru roboczego. Użyj filtru w prawym górnym rogu, aby filtrować według typu.

Zrzut ekranu przedstawiający elementy dostępne dla odwołania do elementu. 6. Po wybraniu będzie on wyglądać następująco na stronie varlib — jako składnik tylko do odczytu przedstawiający nazwę elementu.

Zrzut ekranu przedstawiający odwołanie do elementu.

Jeśli musisz edytować odwołanie do elementu lub musisz dokładnie sprawdzić wartość:

  • aby wyświetlić dodatkowe szczegóły, kliknij wartość
  • aby edytować tę wartość lub wartości innych zestawów wartości, kliknij przycisk obok wartości.

Zrzut ekranu przedstawiający wyskakujące okienko odwołania do elementu.

Jak to działa

Wartość zmiennej referencyjnej przedmiotu to w zasadzie statyczny wskaźnik do elementu Fabric identyfikowany przez Workspace ID + ID elementu. Wartość jest przechowywana jako para identyfikatorów GUID odpowiadających obszarowi roboczemu elementu docelowego i samemu elementowi. Na przykład odwołanie może być przechowywane wewnętrznie jako:

  • WorkspaceID = aaaa-0000-1111-2222-bbbbbbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44e44ee

Te dwa identyfikatory razem jednoznacznie identyfikują odwołany element.

Podczas pracy z odwołaniami do elementów należy pamiętać o następujących kwestiach:

  • Odwołania do elementów umożliwiają parametryzację połączenia wewnętrznego, umożliwiając deweloperom dynamiczne łączenie elementów z określonymi zasobami Fabric na podstawie etapu wdrożenia lub kontekstu obszaru roboczego.
  • Odwołanie jest statyczne, wskazujące określony element i nie jest automatycznie dostosowywane w różnych środowiskach.
  • W przypadku specyficznych odmian dla etapów użyj zestawów wartości, w których każdy zestaw może wskazywać na inny element statyczny (np. różne magazyny typu lakehouse dla każdego etapu).
  • Wszystkie wartości w zestawach wartości powinny być tego samego typu elementu, aby zapewnić zgodność i zapobiec błędom środowiska uruchomieniowego. Jednak nie wymuszamy posiadania tego samego typu elementu w zestawach wartości.

Reprezentacja w usłudze Git i interfejsach API

Zarządzaj biblioteką zmiennych jako kodem. Korzystając z API Git lub REST, możesz pracować ze zmiennymi referencyjnymi elementów w przejrzystym formacie JSON. Wszystkie zmienne pojawiają się w pliku definicyjnym biblioteki zmiennych (przechowywanym w Gicie, zwykle .json), wymieniając właściwości takie jak nazwa, typ i wartość.

Dla zmiennej referencyjnej (statycznej) elementu wartością są dane strukturalne dotyczące przestrzeni roboczej i identyfikatorów elementów. Przykład:


{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

Podczas pracy za pomocą interfejsu API pamiętaj o następujących kwestiach:

  • Przechowywane są tylko identyfikatory; nazwy i metadane są pobierane w czasie wykonywania lub buforowane w Fabric.
  • Przy tworzeniu/aktualizowaniu za pośrednictwem interfejsu API podajesz identyfikatory obszarów roboczych i elementów. Nieprawidłowe identyfikatory powodują błędy.

Obsługiwane elementy

Poniżej znajduje się lista elementów, które są obecnie obsługiwane przy użyciu odwołania do elementu:

Uwaga / Notatka

Laptop za pośrednictwem %%configure nie jest obsługiwany.

przykład kodu Python

W poniższym przykładzie kodu pokazano, jak używać odwołania do elementu w skryscie języka Python.

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

Ten kod wykonuje następujące czynności:

  • Rozwiązuje zmienną referencyjną elementu z biblioteki zmiennych w Fabric.
  • Pobiera obiekt metadanych dla tego elementu, do którego odwołuje się odwołanie
  • Wyodrębnia identyfikator obszaru roboczego i identyfikator elementu
  • Drukuje je tak, aby mogły być używane programowo.

Uprawnienia wymagane do tworzenia/używania zmiennych referencyjnych elementu

Używanie zmiennych referencyjnych elementów obejmuje dwie warstwy uprawnień:

  • Tworzenie i edytowanie zmiennej referencyjnej elementu: Użytkownicy z rolami Contributor lub wyższymi w obszarze roboczym mogą tworzyć i edytować zmienne w bibliotece, podczas gdy osoby przeglądające mają jedynie dostęp do odczytu.
  • Uzyskiwanie dostępu do zmiennej referencyjnej elementu: oprócz praw do Biblioteki Zmiennych musisz mieć co najmniej uprawnienia do odczytu w zmiennej referencyjnej elementu, do której chcesz się odwołać.

Aby uzyskać więcej informacji na temat uprawnień i walidacji uprawnień, zobacz Uprawnienia biblioteki zmiennych

Ograniczenia

Obecnie można odwoływać się tylko do elementów sieci szkieletowej i modeli semantycznych. Inne elementy Power BI, takie jak Dataflow Gen1, nie są obecnie obsługiwane.

Dodatkowe informacje

Biblioteka zmiennych umożliwia stosowanie CI/CD do zawartości platformy Fabric w różnych środowiskach (Dev, Test, Prod) dzięki użyciu zmiennych odwołujących się do elementów na potrzeby konfiguracji specyficznych dla danego etapu. Należy pamiętać o następujących kwestiach:

  • Referencje do przedmiotów są powiązane z konkretnym obszarem roboczym i identyfikatorem przedmiotu.
  • Przy wdrażaniu na nowy etap, odwołania te nadal wskazują na oryginalny obszar roboczy, chyba że zostaną ręcznie zaktualizowane.
  • Używaj wielu zestawów wartości dla każdego etapu i aktywuj właściwy zestaw ręcznie lub za pomocą skryptów API.

Aby uzyskać więcej informacji, zobacz zestawy wartości w bibliotekach zmiennych.

Treści powiązane

  • Last updated on