Freigeben über

Verbindungsverweisvariablentyp (Vorschau)

Eine Verbindungsverweisvariable ist eine Arbeitsbereichsvariable, die die ID einer externen Datenverbindung speichert (z. B. Snowflake, Azure SQL), sodass Elemente auf externe Ressourcen verweisen können, ohne Anmeldeinformationen oder Verbindungszeichenfolgen einzubetten.

So verwenden Sie

Eine Verbindungsverweisvariable kann wie andere Variablen in einer Variablenbibliothek verwendet werden.

  1. Anmelden bei Microsoft Fabric
  2. Navigieren Sie zu Ihrem Arbeitsbereich und Ihrer Variablenbibliothek
  3. Wählen Sie oben +Neue Variable aus.
  4. Geben Sie einen Namen für die Variable ein, wählen Sie den Verbindungsverweis für den Typ aus, und klicken Sie dann auf die ... , um einen Wert auszuwählen.

Screenshot der für den Verbindungsverweis verfügbaren Elemente. 5. Nach der Auswahl sollte Ihr Verbindungsverweis einsatzbereit sein.

Screenshot des Verbindungsverweises.

Wenn Sie einen Verbindungsverweis bearbeiten oder den Wert überprüfen müssen, können Sie mit der rechten Maustaste auf den Wert klicken, um ein Popup mit Informationen zum Verbindungsverweis anzuzeigen.

Screenshot des Pop-ups für den Verbindungsverweis.

So funktioniert es

Der Wert einer Verbindungsverweisvariable ist ein statischer Zeiger auf ein Verbindungsobjekt, das durch seine Verbindungs-ID identifiziert wird. Der Wert wird als Zeichenfolge gespeichert, die der ID der Zielverbindung entspricht. Beispiel:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Diese ID identifiziert die referenzierte Verbindung eindeutig. Der statische Verweis passt sich nicht automatisch an verschiedene Bereitstellungsumgebungen an. Es erfordert, dass die Zielverbindung zum Zeitpunkt der Auswahl vorhanden ist und bleibt auf diese bestimmte Verbindung verweist, es sei denn, sie wurde manuell geändert.

Beachten Sie beim Arbeiten mit Verbindungsverweisen Folgendes:

  • Speichert einen vordefinierten Verbindungsbezeichner auf Mandantenebene.
  • Verbindungsverweise werden während der Bereitstellung nicht automatisch gebunden. Ihre Werte bleiben in allen Umgebungen fest.
  • Unterstützt CI/CD und Automatisierung durch Parametrisieren externer Verbindungen für verschiedene Umgebungen (Dev, Test, prod).
  • Ermöglicht die dynamische Konfiguration externer Beziehungen (z. B. Wechseln von Datenquellen oder Anmeldeinformationen pro Umgebung).
  • Werte werden über ein Benutzeroberflächendialogfeld ausgewählt, nicht Freitext, wobei sichergestellt wird, dass nur autorisierte Verbindungen ausgewählt werden können.
  • Für die Auswahl stehen nur Verbindungen mit mindestens Leseberechtigungen zur Verfügung.

Darstellung in Git und APIs

Ein Verbindungsreferenz ist ein erweiterter Variablentyp, dessen Wertschema die connectionId speichert (wobei die Plattform die Metadaten auflöst und anzeigt). Die Erstellungsnutzlast umfasst:

  • name: displayName der Verbindungsverweisvariable
  • Hinweis: Optional, kann zur Beschreibung oder anderen Notizen verwendet werden.
  • type: "connectionReference" (erweiterter Typ)
  • wert: pro Wertsatz, jeder Wert speichert { "connectionId": "<GUID/ID string>" }

Beispiel:


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

Zum Erstellen/Verwenden von Verbindungsverweisen erforderliche Berechtigungen

Die Verwendung von Verbindungsverweisvariablen umfasst zwei Berechtigungsebenen:

  • Erstellen und Bearbeiten einer Verbindungsverweisvariable: Benutzer mit der Rolle Mitglied mit Beitragsrechten oder einer höheren Rolle im Arbeitsbereich können Variablen in der Bibliothek erstellen und bearbeiten, während Viewer nur Lesezugriff haben.
  • Zugreifen auf die Verbindungsverweisvariable: Zusätzlich zu den Rechten der Variablenbibliothek benötigen Sie mindestens Leseberechtigungen für die Verbindungsverweisvariable , auf die Sie verweisen möchten.

Weitere Informationen zur Berechtigungs- und Berechtigungsüberprüfung finden Sie unter Variablenbibliotheksberechtigungen

Unterstützte Elemente

Es folgt eine Liste von Elementen, die Verbindungsverweisvariablen unterstützen:

Python-Codebeispiel

Das folgende Codebeispiel zeigt, wie Sie einen Verbindungsverweis in einem Python-Skript verwenden.

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

Dieser Code macht Folgendes:

  • Löst eine Verbindungsverweisvariable aus einer Fabric-Variablenbibliothek auf.
  • Ruft das Verbindungsmetadatenobjekt ab.
  • Extrahiert die Verbindungs-ID
  • Druckt die ID, damit sie in Code- oder API-Aufrufen verwendet werden kann.

Einschränkungen

Die folgenden Einschränkungen gelten für Verbindungsverweisvariablen:

  • Integrierte Verbindungen in Notizbüchern werden nicht unterstützt, da die connection_id für die Notizbuchverbindung nicht identisch ist.

Verwandte Inhalte

  • Last updated on