Sdílet prostřednictvím

Formát zdrojového kódu integrace Gitu

  • Článek

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ž položku uložíte v Gitu, integrace Gitu pro tuto položku automaticky vytvoří adresář.

Za názvem adresáře položky následuje <item name>.<item type> typ položky. Pokud tento název není k dispozici, použije se název logického IDENTIFIKÁTORu (GUID) položky následovaný typem položky.

Snímek obrazovky adresáře Git obsahujícího položky

  • 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 mezi typy úloh liší.

Obsah adresáře

Každý adresář položek obsahuje definiční soubory položek a buď jeden nebo dva 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 :

Snímek obrazovky se stromem adresáře zobrazujícím soubory v adresáři poznámkového bloku

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

Snímek obrazovky se stromem adresáře zobrazujícím soubory v adresáři sestavy

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.jsonnebo 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.

Související obsah

Začínáme s integrací Gitu