Delen via

Broncode-indeling voor Git-integratie

Items in Microsoft Fabric worden opgeslagen in een map. De map met het item kan zich in de hoofdmap of in een submap bevinden. Wanneer u uw werkruimte verbindt met Git, maakt u verbinding met de map met de items. Elk item in de map wordt weergegeven in een eigen submap.

De mapnaam

Wanneer u een nieuw item opslaat in Git, maakt Git-integratie automatisch een map voor dat item.

De mapnaam van het item is gebaseerd op de volgende regels:

  • Het patroon voor de naam is {display name}.{public facing type}.
  • Indien nodig worden de volgende wijzigingen in de weergavenaam aangebracht:
    • Ongeldige tekens worden vervangen door het HTML-nummer.
    • De voorloopspatie wordt vervangen door het HTML-nummer.
    • Een spatie of punt aan het einde wordt vervangen door het HTML-nummer.
  • Als deze mapnaam niet beschikbaar is, wordt de naam van de logicalID (GUID) van het item gebruikt in plaats van de weergavenaam.

Als u bijvoorbeeld de volgende items in een werkruimte hebt (houd er rekening mee dat de eerste en derde items respectievelijk een onzichtbare voorloop- en volgruimte hebben):

Schermopname van de lijst met items in een Fabric-werkruimte.

De volgende mappen worden gemaakt in de Git-opslagplaats:

Schermopname van de namen van de Git-mappen met de Fabric-items.

  • Zodra de git-integratie is gemaakt, wordt de naam van een map nooit gewijzigd. Zelfs als u de naam van het item wijzigt, blijft de mapnaam hetzelfde.
  • Als u de naam van een itemmap handmatig wijzigt, moet u rekening houden met de afhankelijkheden van het item. Als u bijvoorbeeld de map van een semantisch model wijzigt, moet u ervoor zorgen dat u het pad van het semantische model in het afhankelijkheidsbestand van het rapport bijwerkt. Houd er rekening mee dat afhankelijkheidslocaties verschillen tussen verschillende Fabric-ervaringen. Als u de mapnaam wijzigt, wordt er geen binnenkomende wijziging in de werkruimte veroorzaakt.

Mapinhoud

Elke itemmap bevat de itemdefinitiebestanden en automatisch gegenereerde systeembestanden.

Itemdefinitiebestanden

De map van elk item bevat specifieke, vereiste bestanden die dat item definiëren.

De volgende items worden momenteel ondersteund in Microsoft Fabric:

Gespiegelde databases

Gespiegelde databasemappen bevatten een .json bestand dat de gespiegelde database definieert.

Zie CI/CD voor gespiegelde databasesvoor instructies over het gebruik van Git-integratie met gespiegelde databases.

Notebook-bestanden

Notitieblokmappen bevatten een .py-bestand:

Zie Broncodebeheer en implementatie van Notebook voor instructies over het gebruik van Git-integratie met notebooks.

Gepagineerde rapportbestanden

Gepagineerde rapportmappen bevatten een RDL-bestand dat het gepagineerde rapport definieert. RDL (Report Definition Language) is een XML-weergave van een gepagineerde rapportdefinitie.

Zie Report Definition Language (RDL)voor meer informatie over RDL. Zie Git-integratie met gepagineerde rapporten voor instructies over het gebruik van Git-integratie met gepagineerde rapporten.

Rapportbestanden

Rapportmappen bevatten de volgende bestanden:

  • definition.pbir
  • report.json

Zie de projectrapportmap van Power BI Desktop voor meer informatie over rapportmappen en een volledige lijst met inhoud.

Semantische modelbestanden

Semantische modelmappen bevatten de volgende bestanden:

  • definitie.pbism
  • \definition-map met TMDL-bestanden

Zie de semantische modelmap van het Power BI Desktop-project voor meer informatie over semantische modelmappen en een volledige lijst met inhoud.

Automatisch gegenereerde systeembestanden

Naast de itemdefinitiebestanden bevat elke itemmap een of twee automatisch gegenereerde systeembestanden, afhankelijk van de versie die u gebruikt:

  • Een map met versie 1 bevat item.metadata.json en item.config.json. Met V1 moeten beide bestanden zich in de map bevinden.
  • Een map met versie 2 bevat .platform. Dit bestand bevat de inhoud van zowel item.metadata.json als item.config.json bestanden. Als u dit bestand hebt, kunt u de andere twee bestanden niet hebben. Als u versie 1 gebruikt en wijzigingen doorvoert, worden uw systeembestanden automatisch bijgewerkt naar deze versie.

Notitie

De map moet het item.metadata.json en item.config.json bestand bevatten of het .platform bestand. U kunt niet alle drie de bestanden hebben.

Platformbestand

In versie 2, in plaats van twee bronbestanden in elke itemmap te hebben, combineert het platformbestand alle informatie in één bestand, samen met een eigenschap $schema . Als u dit bestand hebt, kunt u de andere twee bestanden niet hebben.

{
    "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"
    }
}

Het .platform bestand bevat de volgende kenmerken:

  • version: versienummer van de systeembestanden. Dit getal wordt gebruikt om compatibiliteit met eerdere versies mogelijk te maken. Het versienummer van het item kan afwijken.
  • logicalId: (tekenreeks) Een automatisch gegenereerde werkruimte-overschrijdende identificator die een item en de bijbehorende broncontroleweergave vertegenwoordigt.
  • type: (tekenreeks) Het type van het item (semantisch model, rapport, enzovoort)
  • displayName: (tekenreeks) De naam van het item.
  • description: (optionele tekenreeks) Beschrijving van het item.

Als u de naam van het artefact in de werkruimte wijzigt en de artefactmap in Git een achtervoegsel '.' heeft, komen de displayName en de mapnaam in Git overeen na het doorvoeren.

De logicalId verbindt een item in een werkruimte met het bijbehorende item in een Git-vertakking. Items met dezelfde logicalIds worden verondersteld hetzelfde te zijn. De logicalId behoudt de koppeling, zelfs als de naam of map wordt gewijzigd. Omdat een vertakking kan worden gesynchroniseerd met meerdere werkruimten, is het mogelijk om items in verschillende werkruimten met dezelfde logicalId te hebben, maar één werkruimte kan geen twee items met dezelfde logicalId hebben. De logicalId wordt gemaakt wanneer de werkruimte wordt verbonden met een Git-branch of een nieuw item wordt gesynchroniseerd. De logicalId is nodig om Git-integratie goed te laten functioneren. Daarom is het essentieel om het op geen enkele manier te wijzigen.

Notitie

Wanneer u wijzigingen doorvoert in Git in versie 1, worden de systeembestanden automatisch bijgewerkt naar versie 2, samen met de wijzigingen. Ook worden alle nieuwe bestanden die worden geëxporteerd vanuit de ontwikkelaarsmodus van Power BI Desktop, opgeslagen in de bestandsindeling versie 2.

Notitie

  • Het typeveld is hoofdlettergevoelig. Wijzig niet de wijze waarop het automatisch wordt gegenereerd, anders kan het mislukken.
  • Hoewel u in het algemeen niet de logicalId of weergavenaam van een item moet wijzigen, kan één uitzondering zijn als u een nieuw item maakt door een bestaande itemmap te kopiëren. In dat geval moet u de logicalId en de weergavenaam wijzigen in iets unieks in de opslagplaats.

Gerelateerde inhoud

Aan de slag met Git-integratie.

  • Last updated on