Formát zdrojového kódu integrace Gitu

Položky v Microsoft Fabric jsou uložené ve složce. Složka obsahující položku může být buď v kořenovém adresáři, nebo v podadresáři. Když připojíte pracovní prostor k Gitu, připojte se ke složce obsahující položky. Každá položka ve složce je reprezentována ve vlastním podadresáři.

Název adresáře

Když uložíte novou položku v Gitu, integrace Gitu pro tuto položku automaticky vytvoří adresář.

Název adresáře položky je založený na následujících pravidlech:

  • Vzor pro název je {display name}.{public facing type}.
  • V případě potřeby jsou provedeny následující změny zobrazovaného názvu:
    • Neplatné znaky jsou nahrazeny číslem HTML.
    • Úvodní mezera se nahradí číslem HTML.
    • Koncová mezera nebo tečka se nahradí číslem HTML.
  • Pokud tento název složky není k dispozici, použije se místo zobrazovaného názvu název logického IDENTIFIKÁTORu (GUID) položky.

Pokud máte například v pracovním prostoru následující položky (všimněte si, že první a třetí položky mají neviditelné úvodní a koncové místo):

Snímek obrazovky se seznamem položek v pracovním prostoru Prostředky infrastruktury

V úložišti Git se vytvoří následující adresáře:

Snímek obrazovky s názvy adresářů Git obsahujících položky Infrastruktury

  • Po vytvoření integrace Gitu nikdy nezmění název adresáře. I když změníte název položky, zůstane název adresáře stejný.
  • Pokud ručně změníte název adresáře položek, nezapomeňte vzít v úvahu závislosti položky. Pokud například změníte adresář sémantického modelu, měli byste v souboru závislostí sestavy aktualizovat cestu k sémantickému modelu. Mějte na paměti, že umístění závislostí se liší mezi různými prostředími infrastruktury. Změna názvu adresáře nezpůsobí příchozí změnu v pracovním prostoru.

Obsah adresáře

Každý adresář položek obsahuje definiční soubory položek a automaticky generované systémové soubory.

Soubory definic položek

Adresář každé položky má specifické požadované soubory, které tuto položku definují.

Microsoft Fabric v současné době podporuje následující položky:

Soubory poznámkového bloku

Složky poznámkového bloku obsahují soubor .py :

Pokyny k použití integrace Gitu s poznámkovými bloky najdete v tématu Správa zdrojového kódu a nasazení poznámkového bloku.

Soubory stránkovaných sestav

Složky stránkované sestavy obsahují soubor .rdl definující stránkovanou sestavu. RDL (Report Definition Language) je reprezentace xml definice stránkované sestavy.

Další informace o RDL najdete v tématu Jazyk RDL (Report Definition Language). Pokyny k použití integrace Gitu se stránkovanými sestavami najdete v tématu Integrace Gitu se stránkovanými sestavami.

Soubory sestav

Složky sestav obsahují následující soubory:

  • definition.pbir
  • report.json

Další informace o složkách sestav a úplný seznam jejich obsahu najdete ve složce sestav projektu Power BI Desktopu.

Sémantické soubory modelu

Sémantické složky modelu obsahují následující soubory:

  • definition.pbidataset
  • soubor model.bim (formát TMSL) NEBO \definition folder (formát TMDL)

Další informace o sémantických složkách modelu a úplný seznam jejich obsahu najdete ve sémantické sémantické sémantické složce projektu Power BI Desktopu.

Automaticky generované systémové soubory

Kromě definičních souborů položek obsahuje každý adresář položek jeden nebo dva automaticky generované systémové soubory v závislosti na používané verzi:

  • Adresář verze 1 obsahuje item.metadata.json a item.config.json. U V1 musí být oba soubory v adresáři.
  • Adresář verze 2 obsahuje platformu. Tento soubor obsahuje obsah item.metadata.json i item.config.json souborů. Pokud máte tento soubor, nemůžete mít další dva soubory. Pokud používáte verzi 1 a potvrdíte změny, systémové soubory se automaticky aktualizují na tuto verzi.

Poznámka:

Adresář musí obsahovat soubory item.metadata.json nebo item.config.json .platform soubory. Nemůžete mít všechny tři soubory.

Soubor platformy

Ve verzi 2 místo dvou zdrojových souborů v každém adresáři položek soubor .platform kombinuje všechny informace do jednoho souboru spolu s vlastností $schema . Pokud máte tento soubor, nemůžete mít další dva soubory.

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

Soubor .platform obsahuje následující atributy:

  • version: Číslo verze systémových souborů. Toto číslo se používá k povolení zpětné kompatibility. Číslo verze položky se může lišit.
  • logicalId: Automaticky vygenerovaný identifikátor mezi pracovními prostory představující položku a jeho reprezentaci správy zdrojového kódu.
  • type: (řetězec) Typ položky (sémantický model, sestava atd.)
  • displayName: (řetězec) Název položky.
  • description: (volitelný řetězec) Popis položky.

Poznámka:

  • V poli typu se rozlišují malá a velká písmena. Neměňte způsob, jakým se automaticky generuje nebo může selhat.
  • I když byste neměli obecně měnit logické ID nebo zobrazovaný název položky, může být jedna výjimka, pokud vytváříte novou položku zkopírováním existujícího adresáře položek. V takovém případě musíte změnit logické ID a zobrazovaný název na něco jedinečného v úložišti.

Začínáme s integrací Gitu