Zdieľať cez


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:
    • Neplatné znaky sa nahradia číslom HTML.
    • Úvodný priestor sa nahradí číslom HTML.
    • Koncová medzera alebo bodka sa nahradí číslom HTML.
  • 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):

Snímka obrazovky so zoznamom položiek v pracovnom priestore služby Fabric.

V odkladacom priestore Git sa vytvárajú nasledujúce adresáre:

Snímka obrazovky názvov adresárov Git obsahujúcich položky služby Fabric.

  • 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:

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.

Začnite integráciou Git.