Elementverweisvariablentyp (Vorschau)

Um Flexibilität und Skalierbarkeit zu verbessern, führen wir erweiterte Variablen zusammen mit den vorhandenen grundlegenden Variablentypen ein. Diese erweiterten Variablen sind so konzipiert, dass sie wichtige Anforderungen erfüllen, z. B. die Parametrisierung externer und interner Verbindungen (z. B. Snowflake, AWS, OneLake).

Eine Item-Referenz Variable ist ein erweiterter Variablentyp, der in der Fabric Variablenbibliothek verwendet wird, um einen Verweis auf ein vorhandenes Fabric-Element (z. B. ein Seehaus, ein Notizbuch oder eine Datenpipeline) zu speichern, indem die Arbeitsbereichs-ID und die Element-ID gespeichert werden. Diese Variable ermöglicht die interne Verbindungsparameterisierung, sodass Entwickler Elemente dynamisch mit bestimmten Fabric Elementen basierend auf der Bereitstellungsphase oder dem Arbeitsbereichskontext verknüpfen können.

Verwendung

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

  1. Melden Sie sich bei Fabric an.
  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 einen Elementverweis für den Typ aus, und klicken Sie dann auf die ... , um einen Wert auszuwählen.
  5. Dadurch wird ein Dialogfeld geöffnet, um das gewünschte Element auszuwählen. Es werden alle Elemente angezeigt, für die Sie über Berechtigungen verfügen, die für die Auswahl verfügbar sind. Verwenden Sie den Explorer auf der linken Seite, um die Liste nach Arbeitsbereich zu filtern. Verwenden Sie den Filter in der oberen rechten Ecke, um nach Typ zu filtern.

Screenshot der für den Elementverweis verfügbaren Elemente. 6. Nach der Auswahl wird sie auf der Varlib-Seite wie folgt angezeigt – als schreibgeschützte Komponente, die den Namen des Elements anzeigt.

Screenshot der Artikelreferenz.

Wenn Sie einen Elementverweis bearbeiten müssen oder den Wert doppelt überprüfen müssen:

  • um weitere Details anzuzeigen, klicken Sie auf den Wert.
  • um diesen Wert oder die Werte anderer Wertsätze zu bearbeiten, klicken Sie auf die Schaltfläche neben dem Wert.

Screenshot des Elementreferenz-Pop-ups.

Funktionsweise

Der Wert einer Artikelreferenzvariable ist im Wesentlichen ein statischer Zeiger auf einen Fabric-Artikel, der durch Workspace ID + Item ID identifiziert wird. Der Wert wird als Ein paar GUIDs gespeichert, die dem Arbeitsbereich des Zielelements und dem Element selbst entsprechen. Ein Verweis kann z. B. intern gespeichert werden als:

  • WorkspaceID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Diese beiden IDs identifizieren das referenzierte Element eindeutig.

Beachten Sie beim Arbeiten mit Elementverweise Folgendes:

  • Elementverweise ermöglichen die interne Verbindungsparameterisierung, sodass Entwickler Elemente dynamisch mit bestimmten Fabric Ressourcen basierend auf der Bereitstellungsphase oder dem Arbeitsbereichskontext verknüpfen können.
  • Der Verweis ist statisch, zeigt auf ein bestimmtes Element und passt sich nicht automatisch über verschiedene Umgebungen hinweg an.
  • Verwenden Sie für phasenspezifische Variationen Wertsätze, bei denen jeder Satz auf ein anderes statisches Element verweisen kann (z. B. unterschiedliche Seehäuser pro Stufe).
  • Alle Werte über Wertsätze hinweg sollten demselben Elementtyp entsprechen, um Kompatibilität zu gewährleisten und Laufzeitfehler zu verhindern. Wir erzwingen jedoch nicht, dass derselbe Elementtyp über Wertsätze hinweg vorhanden ist.

Darstellung in Git und APIs

Verwalte die Variablenbibliothek als Code. Durch die Verwendung von Git- oder REST-APIs können Sie mit Item-Referenzvariablen in einem klaren JSON-Format arbeiten. Alle Variablen erscheinen in der Definitionsdatei der Variablenbibliothek (in Git gespeichert, meist .json), und listen Eigenschaften wie Name, Typ und Wert auf.

Bei einer statischen Elementreferenzvariable ist der Wert eine strukturierte Datenangabe für Arbeitsbereichs- und Element-IDs. Beispiel:


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

Beachten Sie Folgendes beim Arbeiten über die API:

  • Nur IDs werden gespeichert; Namen und Metadaten werden zur Laufzeit abgerufen oder in Fabric zwischengespeichert.
  • Beim Erstellen oder Aktualisieren über die API müssen Sie die Arbeitsbereichs- und Element-IDs bereitstellen. Ungültige IDs verursachen Fehler.

Unterstützte Elemente

Es folgt eine Liste der Elemente, die derzeit mithilfe der Elementreferenz unterstützt werden:

Hinweis

Durch %%configure wird das Notizbuch nicht unterstützt.

Python Codebeispiel

Das folgende Codebeispiel zeigt, wie sie einen Elementverweis in einem Python-Skript verwenden.

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)

Dieser Code macht Folgendes:

  • Löst eine Elementreferenzvariable aus einer Variablenbibliothek in Fabric auf.
  • Ruft das Metadatenobjekt für dieses referenzierte Element ab.
  • Extrahiert die Arbeitsbereichs-ID und Element-ID.
  • Druckt sie, damit sie programmgesteuert verwendet werden können.

Zum Erstellen/Verwenden von Elementverweisvariablen erforderliche Berechtigungen

Die Verwendung von Elementverweisvariablen umfasst zwei Berechtigungsebenen:

  • Erstellen und Bearbeiten einer Elementverweisvariable: Benutzer mit der Rolle eines Mitwirkenden oder einer höheren Rolle im Arbeitsbereich können Variablen in der Bibliothek erstellen und bearbeiten, während Betrachter nur Leserechte haben.
  • Zugreifen auf die Elementverweisvariable: Zusätzlich zu rechten in der Variablenbibliothek benötigen Sie mindestens Leseberechtigungen für die Elementreferenzvariable , auf die Sie verweisen möchten.

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

Einschränkungen

Derzeit können Sie nur auf Fabric-Elemente und semantische Modelle verweisen. Andere Power BI Elemente wie Dataflow Gen1 werden derzeit nicht unterstützt.

Zusatzinformation

Die Variablenbibliothek ermöglicht CI/CD für Fabric-Inhalte über Umgebungen hinweg (Dev, Test, Prod), indem sie Item-Referenzvariablen für stufenspezifische Konfigurationen verwendet. Beachten Sie folgende Punkte:

  • Artikelreferenzen sind an einen bestimmten Arbeitsbereich und eine Item-ID gebunden.
  • Beim Bereitstellen in eine neue Phase verweisen diese Verweise weiterhin auf den ursprünglichen Arbeitsbereich, es sei denn, sie werden manuell aktualisiert.
  • Verwenden Sie mehrere Wertesets für jede Stufe und aktivieren Sie die korrekte Menge manuell oder über API-Skripte.

Weitere Informationen finden Sie unter Wertsätze in Variablenbibliotheken.

Verwandte Inhalte

  • Last updated on