Formát zdrojového kódu integrácie so službou Git
Položky v službe Microsoft Fabric sú uložené v priečinku. Priečinok obsahujúci položku sa môže nachádzať v koreňovom adresári alebo podadresári. Keď pripojíte pracovný priestor k službe git, pripojte sa k priečinku obsahujúcemu položky. Každá položka v priečinku je zastúpená v vlastnom podadresári.
Názov adresára
Keď uložíte novú položku v Git, integrácia Git automaticky vytvorí adresár pre túto položku.
Názov adresára položky je založený na nasledujúcich pravidlách:
- Vzor názvu je
{display name}.{public facing type}
. - Ak je to potrebné, vykonajú sa nasledujúce zmeny zobrazovaného názvu:
- Ak tento názov priečinka nie je k dispozícii, namiesto zobrazovaného názvu sa použije názov logickejid položky (GUID).
Ak máte napríklad v pracovnom priestore nasledujúce položky (všimnite si, že prvá a tretia položka majú neviditeľný úvodný a koncový priestor):
V odkladacom priestore Git sa vytvárajú nasledujúce adresáre:
- Po vytvorení integrácia systému Git nikdy nezmení názov adresára. Aj keď zmeníte názov položky, názov adresára zostane rovnaký.
- Ak manuálne zmeníte názov adresára položiek, nezabudnite vziať do úvahy závislosti položky. Ak napríklad zmeníte adresár sémantického modelu, mali by ste sa uistiť, že ste aktualizovali cestu sémantického modelu v súbore závislosti zostavy. Majte na pamäti, že miesta závislosti sa líšia medzi rôznymi prostrediami služby Fabric. Zmena názvu adresára nespôsobí prichádzajúce zmeny v pracovnom priestore.
Obsah adresára
Každý adresár položiek obsahuje súbory definície položiek a automaticky generované systémové súbory.
Súbory definície položiek
Adresár každej položky má konkrétne a povinné súbory, ktoré danú položku definujú.
V službe Microsoft Fabric sú v súčasnosti podporované tieto položky:
- databáz zrkadlových zrkadiel
- Zápisník
- Stránkovaná zostava
- Správa
- Sémantický model
Zrkadlové databázy
Zrkadlené databázové priečinky obsahujú súbor .json definujúci zrkadlovú databázu.
Pokyny na používanie integrácie systému Git so zrkadlovými databázami nájdete v téme CI/CD pre zrkadlové databázy.
Poznámkové bloky
Priečinky poznámkového bloku obsahujú súbor .py :
Pokyny na používanie integrácie systému Git s poznámkovými blokmi nájdete v téme Ovládací prvok zdroja poznámkového bloku a nasadenie.
Súbory stránkovanej zostavy
Priečinky stránkovanej zostavy obsahujú súbor .rdl definujúci stránkovanú zostavu. RDL (Report Definition Language) je reprezentácia XML definície stránkovanej zostavy.
Ďalšie informácie o jazyku RDL nájdete Report Definition Language (RDL). Pokyny na používanie integrácie Git so stránkovanými zostavami nájdete v téme Integrácia Git so stránkovanými zostavami.
Súbory zostáv
Priečinky zostáv obsahujú nasledujúce súbory:
- definition.pbir
- report.json
Ďalšie informácie o priečinkoch zostáv a úplnom zozname ich obsahu nájdete v téme Priečinok zostáv projektov v aplikácii Power BI Desktop.
Súbory sémantických modelov
Priečinky sémantického modelu obsahujú nasledujúce súbory:
- definition.pbidataset
- súbor model.bim (formát TMSL) ALEBO \definition folder (formát TMDL)
Ďalšie informácie o priečinkoch sémantických modelov a úplnom zozname ich obsahu nájdete v téme Priečinok sémantických modelov projektov v aplikácii Power BI Desktop.
Automaticky generované systémové súbory
Okrem súborov definícií položiek obsahuje každý adresár položiek jeden alebo dva automaticky generované systémové súbory v závislosti od toho, ktorú verziu používate:
- Adresár verzie 1 obsahuje item.metadata.json a item.config.json. V1 – oba súbory sa musia nachádzať v adresári.
- Adresár verzie 2 obsahuje platformu .platform. Tento súbor obsahuje obsah súborov item.metadata.json aj item.config.json. Ak máte tento súbor, nemôžete mať ďalšie dva súbory. Ak používate verziu 1 a potvrdiť zmeny, systémové súbory sa automaticky aktualizujú na túto verziu.
Poznámka
Adresár musí obsahovať item.metadata.json
súbory a item.config.json
alebo.platform
súbor. Nemôžete mať všetky tri súbory.
Súbor platformy
Vo verzii 2 namiesto dvoch zdrojových súborov v každom adresári položiek súbor .platform kombinuje všetky informácie do jedného súboru spolu s vlastnosťou $schema . Ak máte tento súbor, nemôžete mať ďalšie dva súbory.
{
"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"
}
}
Súbor .platform
obsahuje nasledujúce atribúty:
-
version
: Číslo verzie systémových súborov. Toto číslo sa používa na povolenie spätnej kompatibility. Číslo verzie položky sa môže líšiť. -
logicalId
: Automaticky vygenerovaný identifikátor krížového pracovného priestoru predstavujúci položku a jej reprezentáciu ovládacieho prvku zdroja. -
type
: (reťazec) Typ položky (sémantický model, zostava atď.) -
displayName
: (reťazec) Názov položky. -
description
: (voliteľný reťazec) Popis položky.
Poznámka
- V poli Typ sa rozlišuje veľké a malé písmená. Nemeňte spôsob, akým sa automaticky vygeneruje, alebo môže zlyhať.
- Hoci by ste vo všeobecnosti nemali meniť logický identifikátor alebo zobrazovaný názov položky, jednou výnimkou môže byť, ak vytvárate novú položku kopírovaním existujúceho adresára položiek. V takom prípade je potrebné zmeniť logickú hodnotuId a zobrazovaný názov na niečo jedinečné v odkladacom priestore.