Udostępnij za pośrednictwem

Typ zmiennej referencyjnej połączenia (wersja zapoznawcza)

Zmienna referencyjna połączenia to zmienna obszaru roboczego, która przechowuje identyfikator połączenia danych zewnętrznych (na przykład Snowflake, Azure SQL), umożliwiając elementom odwołowanie się do zasobów zewnętrznych bez osadzania poświadczeń lub parametrów połączenia.

Jak stosować

Zmienna referencyjna połączenia może być używana podobnie 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 połączenia dla typu, a następnie kliknij przycisk ..., aby wybrać wartość

Zrzut ekranu przedstawiający elementy dostępne dla odwołania do połączenia. 5. Po wybraniu odwołania do połączenia powinny być gotowe do użycia.

Zrzut ekranu przedstawiający odwołanie do połączenia.

Jeśli musisz edytować odwołanie do połączenia lub musisz dokładnie sprawdzić wartość, możesz kliknąć prawym przyciskiem myszy wartość, aby wyświetlić wyskakujące okienko z informacjami o odwołaniu do połączenia.

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

Jak to działa

Wartość zmiennej odwołania połączenia to statyczny wskaźnik do obiektu połączenia zidentyfikowanego przez jego identyfikator połączenia. Wartość jest przechowywana jako ciąg znaków odpowiadający identyfikatorowi połączenia docelowego. Przykład:

ConnectionID = aaaaa-0000-1111-2222-bbbbbbbbbbbb

Ten identyfikator jednoznacznie identyfikuje przywołytowane połączenie. Statyczne odwołanie nie dostosowuje się automatycznie do różnych środowisk wdrażania. Wymaga to, aby połączenie docelowe istniało w momencie wyboru i pozostaje wskazywane na to konkretne połączenie, chyba że zostanie ręcznie zmienione.

Podczas pracy z odwołaniami do połączeń należy pamiętać o następujących kwestiach:

  • Przechowuje wstępnie zdefiniowany identyfikator połączenia na poziomie dzierżawy.
  • Referencje połączeń nie wiążą się automatycznie podczas wdrażania. Ich wartości pozostają stałe w różnych środowiskach.
  • Umożliwia CI/CD i automatyzację przez parametryzowanie połączeń zewnętrznych dla różnych środowisk (deweloperskie, testowe, produkcyjne).
  • Umożliwia dynamiczną konfigurację relacji zewnętrznych (na przykład przełączanie źródeł danych lub poświadczeń na środowisko).
  • Wartości są wybierane za pośrednictwem okna dialogowego interfejsu użytkownika, a nie za pomocą wolnego tekstu, dzięki czemu można wybierać tylko autoryzowane połączenia.
  • Do wyboru są dostępne tylko połączenia z co najmniej uprawnieniami do odczytu.

Reprezentacja w usłudze Git i interfejsach API

Odwołanie do połączenia to zaawansowany typ zmiennej, której schemat wartości przechowuje connectionId, a platforma rozpoznaje i wyświetla metadane. Zestaw do tworzenia obejmuje:

  • name: displayName zmiennej referencyjnej połączenia
  • Uwaga: opcjonalnie można użyć do opisu lub innych notatek.
  • type: "connectionReference" (typ zaawansowany)
  • value: na zestaw wartości, każda wartość przechowuje { "connectionId": "<GUID/ID string>" }

Przykład:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

Wymagane uprawnienia do tworzenia/używania odwołań do połączeń

Używanie zmiennych referencyjnych połączeń obejmuje dwie warstwy uprawnień:

  • Tworzenie i edytowanie zmiennej referencyjnej połączenia: użytkownicy z rolami Kontrybutora lub wyższymi w obszarze roboczym mogą tworzyć i edytować zmienne w bibliotece, podczas gdy osoby przeglądające mają tylko możliwość odczytu.
  • Uzyskiwanie dostępu do zmiennej referencyjnej połączenia: Oprócz uprawnień do biblioteki zmiennych, musisz mieć co najmniej uprawnienie do odczytu w zmiennej referencyjnej połączenia, do której chcesz się odwołać.

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

Obsługiwane elementy

Poniżej znajduje się lista pozycji, które obsługują zmienne referencyjne połączeń.

Przykład kodu w języku Python

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

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

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

  • Rozwiązuje zmienną referencyjną połączenia z biblioteki zmiennych Fabric
  • Pobiera obiekt metadanych połączenia
  • Wyodrębnia identyfikator connectionId (identyfikator połączenia)
  • Drukuje identyfikator, aby można go było używać w kodzie lub wywołaniach interfejsu API.

Ograniczenia

Następujące ograniczenia dotyczą zmiennych referencyjnych połączeń:

  • Wbudowane połączenia w notatnikach nie są obsługiwane, ponieważ connection_id dla połączenia notatnika nie jest identyczne.

Treści powiązane

  • Last updated on