Share via

Git-Integration im Quellcodeformat

  • Artikel

Elemente in Microsoft Fabric werden in einem Ordner gespeichert. Der Ordner, der das Element enthält, kann sich entweder im Stammverzeichnis oder in einem Unterverzeichnis befinden. Wenn Sie Ihren Arbeitsbereich mit Git verknüpfen, stellen Sie eine Verbindung mit dem Ordner her, der die Elemente enthält. Jedes Element im Ordner wird in einem eigenen Unterverzeichnis dargestellt. Diese Elementverzeichnisse haben denselben Namen wie das Element, gefolgt vom Elementtyp.

Screenshot: Git-Verzeichnis, das Elemente enthält.

Wichtig

Dieses Feature befindet sich in der Vorschauphase.

In jedem Elementverzeichnis befinden sich Elementdefinitionsdateien sowie eine oder zwei automatisch generierte Systemdateien.

Elementdefinitionsdateien

Das Verzeichnis jedes Elements verfügt über bestimmte obligatorische Dateien, die das jeweilige Element definieren.

Folgende Elemente werden derzeit in Microsoft Fabric unterstützt:

Notebook-Dateien

Notebook-Ordner enthalten eine PY-Datei:

Screenshot der Verzeichnisstruktur mit Dateien im Notebook-Verzeichnis.

Anweisungen zur Verwendung der Git-Integration in Notebooks finden Sie unter Quellcodeverwaltung und Bereitstellung von Notebooks.

Dateien für paginierte Berichte

Ordner für paginierte Berichte enthalten eine RDL-Datei, die den paginierten Bericht definiert. Bei der Berichtsdefinitionssprache (Report Definition Language, RDL) handelt es sich um eine XML-Darstellung der Definition eines paginierten Berichts.

Weitere Informationen zu RDL finden Sie unter Report Definition Language (RDL). Eine Anleitung für die Verwendung der Git-Integration mit paginierten Berichten finden Sie unter Git-Integration in paginierten Berichten.

Berichtsdateien

Berichtsordner enthalten die folgenden Dateien:

  • definition.pbir
  • report.json

Screenshot der Verzeichnisstruktur mit Dateien im Berichtsverzeichnis

Weitere Informationen zu Berichtsordnern und eine vollständige Liste ihrer Inhalte finden Sie unter Power BI Desktop-Projektberichtsordner.

Semantikmodelldateien

Semantikmodellordner enthalten folgende Dateien:

  • definition.pbidataset
  • Datei model.bim (TMSL-Format) ODER Ordner \definition (TMDL-Format)

Weitere Informationen zu Semantikmodellordnern und eine vollständige Liste ihrer Inhalte finden Sie unter Power BI Desktop-Projekt-Semantikmodellordner.

Automatisch generierte Systemdateien

Zusätzlich zu den Elementdefinitionsdateien enthält jedes Elementverzeichnis je nach verwendeter Version eine oder zwei automatisch generierte Systemdateien:

  • Ein Verzeichnis der Version 1 enthält item.metadata.json und item.config.json. Bei Verwendung von Version 1 müssen sich beide Dateien im Verzeichnis befinden.
  • Ein Verzeichnis der Version 2 enthält .platform. Diese Datei enthält den Inhalt der beiden Dateien item.metadata.json und item.config.json. Wenn Sie über diese Datei verfügen, dürfen die beiden anderen Dateien nicht vorhanden sein. Wenn Sie Version 1 verwenden und Änderungen committen, werden Ihre Systemdateien automatisch auf diese Version aktualisiert.

Hinweis

Ihr Verzeichnis muss entweder die item.metadata.json- und item.config.json-Dateien oder die .platform-Datei enthalten. Es dürfen nicht alle drei Dateien vorhanden sein.

Plattformdatei

In Version 2 enthält nicht jedes Elementverzeichnis zwei Quelldateien. Stattdessen fasst die Datei vom Typ .platform alle Informationen in einer einzelnen Datei zusammen, in Kombination mit einer $schema-Eigenschaft. Wenn Sie über diese Datei verfügen, dürfen die beiden anderen Dateien nicht vorhanden sein.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

Die .platform-Datei enthält die folgenden Attribute:

  • version: Versionsnummer der Systemdateien. Diese Nummer wird verwendet, um Abwärtskompatibilität zu ermöglichen. Die Versionsnummer des Elements kann sich unterscheiden.
  • logicalId: Ein automatisch generierter, arbeitsbereichsübergreifender Bezeichner, der ein Element und seine Quellcodeverwaltungsdarstellung darstellt.
  • type: (Zeichenkette) Der Typ des Elements (Semantikmodell, Bericht usw.)
  • displayName: (Zeichenkette) Der Name des Elements
  • description: (optionale Zeichenkette) Beschreibung des Elements

Hinweis

  • Für das Feld Typ wird zwischen Groß- und Kleinschreibung unterschieden. Ändern Sie nicht die Art und Weise, wie es automatisch generiert wird, weil das zu Fehlern führen könnte.
  • Die logische ID (logicalId) und der Anzeigename eines Elements sollten im Allgemeinen nicht geändert werden. Ein denkbarer Ausnahmefall wäre jedoch, wenn Sie ein neues Element durch Kopieren eines vorhandenen Elementverzeichnisses erstellen. In diesem Fall müssen Sie die logische ID (logicalId) und den Anzeigenamen in einen eindeutigen Wert im Repository ändern.

Zugehöriger Inhalt

Erste Schritte mit der Git-Integration.