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:
  • 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úcu zmenu 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:

Zrkadlené databázy

Zrkadlené databázové priečinky obsahujú .json súbor definujúci zrkadlenú 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.

Súbory poznámkového bloku

Priečinky poznámkového bloku obsahujú .py súbor:

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ánkovaných zostáv 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 sprá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.pbism
  • \definition folder with TMDL files (Priečinok definície s súbormi 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 doménu .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.

Note

Váš adresár musí obsahovať buď item.metadata.json súbory anditem.config.json, alebo súbor..platform 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: (reťazec) Automaticky generovaný 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.

Ak premenujete artefakt v pracovnom priestore a v priečinku artefaktu v službe Git s príponou ., potom sa po potvrdení displayName bude zhodovať názov adresára a v Git.

LogicalId spája položku v pracovnom priestore s jej zodpovedajúcou položkou vo vetve Git. Predpokladá sa, že položky s rovnakými logickýmiidmi sú rovnaké. LogicalId zachová prepojenie aj v prípade zmeny názvu alebo adresára. Keďže vetvu je možné synchronizovať s viacerými pracovnými priestormi, je možné mať položky v rôznych pracovných priestoroch s rovnakým logickým id, ale jeden pracovný priestor nemôže mať dve položky s rovnakým logickým id. LogicalId sa vytvorí, keď je pracovný priestor pripojený k vetve Git alebo sa synchronizuje nová položka. Na správne fungovanie integrácie Git je potrebná logická hodnota . Preto je nevyhnutné ho žiadnym spôsobom zmeniť.

Note

Pri potvrdení zmien do Git vo verzii 1 sa systémové súbory automaticky aktualizujú na verziu 2 spolu so zmenami. Všetky nové súbory exportované z režimu vývojára aplikácie Power BI Desktop sa tiež uložia vo formáte súboru verzie 2.

Note

  • V poli typu sa rozlišujú veľké a malé písmená. Nemeňte spôsob, akým sa automaticky vygeneruje, alebo môže zlyhať.
  • Aj keď by ste vo všeobecnosti nemali meniť logicalId alebo zobrazovaný názov položky, jednou výnimkou môže byť, ak vytvárate novú položku skopírovaním existujúceho adresára položiek. V takom prípade musíte zmeniť logicalId a zobrazovaný názov na niečo jedinečné v úložisku.

Súvisiaci obsah

Začnite integráciou Git.

  • Last updated on