Udostępnij za pośrednictwem

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

Zmienna referencyjna elementu jest zaawansowanym typem zmiennej używanym w Bibliotece Zmiennych Fabric do przechowywania odwołania do istniejącego elementu Fabric—takiego jak lakehouse, notes lub potok danych, przechowując jego identyfikator obszaru roboczego i identyfikator elementu. Ten typ zmiennej umożliwia parametryzację połączenia wewnętrznego, umożliwiając deweloperom dynamiczne łączenie elementów z określonymi elementami sieci szkieletowej 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 usługi Microsoft 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 odwołania do elementu jest zasadniczo statycznym wskaźnikiem do elementu Fabric identyfikowanego przez Workspace ID + Item ID. 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-44ee44ee44ee

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 sieci szkieletowej 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

Biblioteka zmiennych jest zarządzana jako kod. Korzystając z interfejsów API Git lub REST, zmienne referencyjne elementów mają przejrzysty format JSON. Wszystkie zmienne są wyświetlane w pliku definicji biblioteki zmiennych (przechowywanym w usłudze Git, zwykle .json), wyświetlając listę właściwości, takich jak nazwa, typ i wartość.

W przypadku zmiennej typu Odwołanie do elementu (statyczne) wartość jest danymi ustrukturyzowanymi dotyczącymi identyfikatorów obszaru roboczego i 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 w języku 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 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 usługi Power BI, takie jak Datamarts, usługa Dataflow Gen1 nie są obecnie obsługiwane.

Dodawanie informacji

Biblioteka Zmiennych umożliwia wdrażanie CI/CD dla treści Fabric między środowiskami (deweloperskim, testowym, produkcyjnym) przy zastosowaniu zmiennych referencyjnych elementów do specyficznej dla etapu konfiguracji. Należy pamiętać o następujących kwestiach:

  • Odwołania do elementów są powiązane z określonym obszarem roboczym i identyfikatorem elementu.
  • Przy wdrażaniu na nowy etap, odwołania te nadal wskazują na oryginalny obszar roboczy, chyba że zostaną ręcznie zaktualizowane.
  • Użyj 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