Git-integreringens källkodsformat
Objekt i Microsoft Fabric lagras i en mapp. Mappen som innehåller objektet kan antingen finnas i rotkatalogen eller i en underkatalog. När du ansluter arbetsytan till git ansluter du till mappen som innehåller objekten. Varje objekt i mappen representeras i sin egen underkatalog.
Katalognamn
När du sparar ett nytt objekt i Git skapar Git-integrering automatiskt en katalog för objektet.
Namnet på objektkatalogen baseras på följande regler:
- Mönstret för namnet är
{display name}.{public facing type}
. - Vid behov görs följande ändringar i visningsnamnet:
- Ogiltiga tecken ersätts med HTML-numret.
- Inledande blanksteg ersätts med dess HTML-nummer.
- Avslutande blanksteg eller punkt ersätts med dess HTML-nummer.
- Om det mappnamnet inte är tillgängligt används namnet på objektets logiskaID (GUID) i stället för visningsnamnet.
Om du till exempel har följande objekt på en arbetsyta (observera att de första och tredje objekten har ett osynligt inledande respektive avslutande utrymme):
Följande kataloger skapas på Git-lagringsplatsen:
- När git-integreringen har skapats ändras aldrig namnet på en katalog. Även om du ändrar namnet på objektet förblir katalognamnet detsamma.
- Om du ändrar namnet på en objektkatalog manuellt måste du ta hänsyn till objektets beroenden. Om du till exempel ändrar en semantisk modells katalog bör du se till att uppdatera sökvägen till den semantiska modellen i rapportens beroendefil. Tänk på att beroendeplatser varierar mellan olika infrastrukturresurser. Att ändra katalognamnet orsakar inte någon inkommande ändring i arbetsytan.
Kataloginnehåll
Varje objektkatalog innehåller objektdefinitionsfilerna och automatiskt genererade systemfiler.
Objektdefinitionsfiler
Varje objekts katalog har specifika, nödvändiga filer som definierar objektet.
Följande objekt stöds för närvarande i Microsoft Fabric:
Notebook-filer
Notebook-mappar innehåller en .py fil:
Anvisningar om hur du använder Git-integrering med notebook-filer finns i Källkontroll och distribution av notebook-filer.
Sidnumrerade rapportfiler
Sidnumrerade rapportmappar innehåller en rdl-fil som definierar den sidnumrerade rapporten. RDL (Report Definition Language) är en XML-representation av en sidnumrerad rapportdefinition.
Mer information o RDL finns i Report Definition Language (RDL). Anvisningar om hur du använder Git-integrering med sidnumrerade rapporter finns i Git-integrering med sidnumrerade rapporter.
Rapportfiler
Rapportmappar innehåller följande filer:
- definition.pbir
- report.json
Mer information om rapportmappar och en fullständig lista över deras innehåll finns i Power BI Desktop-projektrapportmappen.
Semantiska modellfiler
Semantiska modellmappar innehåller följande filer:
- definition.pbidataset
- model.bim-fil (TMSL-format) ELLER \definitionsmapp (TMDL-format)
Mer information om semantiska modellmappar och en fullständig lista över deras innehåll finns i power BI Desktop-projektets semantiska modellmapp.
Automatiskt genererade systemfiler
Förutom objektdefinitionsfilerna innehåller varje objektkatalog en eller två automatiskt genererade systemfiler, beroende på vilken version du använder:
- En version 1-katalog innehåller item.metadata.json och item.config.json. Med V1 måste båda filerna finnas i katalogen.
- En version 2-katalog innehåller .platform. Den här filen innehåller innehållet i både item.metadata.json och item.config.json filer. Om du har den här filen kan du inte ha de andra två filerna. Om du använder version 1 och genomför ändringar uppdateras systemfilerna automatiskt till den här versionen.
Kommentar
Katalogen måste innehålla antingen item.metadata.json
filerna och item.config.json
eller .platform
filen. Du kan inte ha alla tre filerna.
Plattformsfil
I version 2, i stället för att ha två källfiler i varje objektkatalog, kombinerar .platform-filen all information till en fil tillsammans med en $schema egenskap. Om du har den här filen kan du inte ha de andra två filerna.
{
"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"
}
}
Filen .platform
innehåller följande attribut:
version
: Versionsnummer för systemfilerna. Det här talet används för att aktivera bakåtkompatibilitet. Versionsnumret för objektet kan vara annorlunda.logicalId
: En automatiskt genererad identifierare för flera arbetsytor som representerar ett objekt och dess källkontrollrepresentation.type
: (sträng) Objektets typ (semantisk modell, rapport osv.)displayName
: (sträng) Objektets namn.description
: (valfri sträng) Beskrivning av objektet.
Kommentar
- Typfältet är skiftlägeskänsligt. Ändra inte hur det genereras automatiskt eller så kan det misslyckas.
- Även om du vanligtvis inte bör ändra logiskaId eller visningsnamn för ett objekt, kan ett undantag vara om du skapar ett nytt objekt genom att kopiera en befintlig objektkatalog. I så fall måste du ändra logicalId och visningsnamnet till något unikt på lagringsplatsen.