Udostępnij przez

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.

Obsługiwane elementy

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

Zrzut ekranu notatnika referencyjnego elementu.

Uwaga / Notatka

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

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.

Uprawnienia wymagane do tworzenia/używania odwołań do elementów

Używanie zmiennych odwołania do elementu obejmuje dwie warstwy uprawnień:

  • Tworzenie/edytowanie — mimo że każdy współautor obszaru roboczego może modyfikować wartości zmiennych, zmienna referencyjna elementu zezwala tylko użytkownikom na ustawianie jako elementów wartości, dla których mają uprawnienia do odczytu. Dotyczy to dowolnej wartości, domyślnego zestawu aktywnych wartości lub innych zestawów wartości. Należy pamiętać, że podczas zapisywania elementu biblioteki zmiennych sprawdzanie uprawnień jest wykonywane na aktywnych wartościach zmiennych odwołania do elementu dla użytkownika, który zapisuje element, nawet jeśli te wartości pozostają niezmienione.
  • Użyj zmiennej ref elementu — podczas tworzenia/aktualizowania odwołania do zmiennej w elemencie odbiorcy użytkownicy nie mogą ustawić odwołania do zmiennej referencyjnej elementu, chyba że mają co najmniej uprawnienie DO ODCZYTU dla elementu w aktywnym zestawie wartości.

Walidacja uprawnień

Walidacja uprawnień jest wyzwalana w następujących przypadkach użycia:

  • Edytuj element biblioteki zmiennej, który zawiera zmienne odwołania do elementu Podczas edycji sprawdzamy, czy istnieją elementy, do których istnieją odwołania, oraz że użytkownik ma co najmniej uprawnienia do odczytu dla wszystkich wartości odwołań do elementów w aktywnym zestawie wartości dla następujących scenariuszy:

  • Interfejs użytkownika — podczas zapisywania elementu Biblioteka zmiennych sprawdzanie uprawnień jest wykonywane na aktywnych wartościach zmiennych referencyjnych elementów dla użytkownika, który zapisuje element, nawet jeśli te wartości pozostają niezmienione.

  • Interfejsy API/Aktualizacja Gita — walidacja uprawnień jest wykonywana podczas aktualizacji i kończy się niepowodzeniem, jeśli brak uprawnień do odczytu aktywnej wartości odniesienia elementu w zaktualizowanym obszarze roboczym.

  • Wdrożenie — wdrożenie elementu zmiennej w bibliotece zakończy się niepowodzeniem, jeśli nie będzie można odczytać aktywnej wartości z odwołania do elementu w docelowym obszarze roboczym.

  • Wyświetl dodatkowe szczegóły dotyczące elementu na stronie biblioteki zmiennych (tylko interfejs użytkownika). Użytkownicy z dostępem do biblioteki zmiennych (posiadający uprawnienia co najmniej na poziomie przeglądarki WS), którzy nie mają uprawnień do danego elementu w zmiennej, nie będą widzieć jego szczegółów w interfejsie użytkownika. Zamiast tego zobaczą identyfikator elementu z wiadomością wyświetlaną po najechaniu kursorem, a nie komponent szczegółów.

Zrzut ekranu przedstawiający uprawnienia.

  • Tworzenie/edytowanie zmiennej referencyjnej elementu

    • Interfejs użytkownika — podczas aktualizowania wartości dowolnego zestawu wartości (wartość domyślna lub inna) użytkownik może wybrać element z listy zawierającej tylko elementy, do których ma co najmniej uprawnienie do odczytu.
    • Interfejsy API/aktualizacja usługi Git lub wdrożenie — zobacz temat Edytowanie elementu biblioteki zmiennych powyżej.

  • Używanie zmiennej referencyjnej elementu w produkcie konsumenckim

    • Interfejs użytkownika — tworzenie odwołania do zmiennej — podczas tworzenia w elemencie odwołania do zmiennej „odwołanie do elementu” przy użyciu okna dialogowego interfejsu użytkownika „Wybierz zmienną” (na przykład w obszarze Skrót dla usługi Lakehouse i potoku danych), sprawdzane jest, czy użytkownik tworzący odwołanie ma co najmniej uprawnienia do odczytu elementów w zmiennych „odwołanie do elementu” (weryfikacja dotyczy tylko wartości aktywnych). Jeśli nie, użytkownik zobaczy tylko identyfikator elementów.

Zachowanie w potokach CI/CD i etapach wdrażania.

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 statyczne

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

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.

Treści powiązane

  • Last updated on