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ž 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:
  • 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 Fabric.

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 Fabric

  • 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. Například pokud změníte adresář sémantického modelu, měli byste aktualizovat cestu k sémantickému modelu v souboru závislostí sestavy. Mějte na paměti, že umístění závislostí se liší mezi různými zkušenostmi s Fabric. 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:

Zrcadlené databáze

Zrcadlené složky databáze obsahují .json soubor definující zrcadlenou databázi.

Pokyny k použití integrace Gitu se zrcadlenými databázemi najdete v tématu CI/CD pro zrcadlené databáze.

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, který definuje stránkovanou sestavu. RDL (Jazyk definice sestavy) je XML reprezentace definice stránkované sestavy.

Další informace o jazyce RDL (Report Definition Language) naleznete v tématu . 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 v sekci "Složka sestav projektu Power BI Desktop".

Sémantické soubory modelu

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

  • definice.pbism
  • Složka \definition se soubory TMDL

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

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 .platform. 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 buď soubory item.metadata.json a item.config.json, nebo soubor . Nemůžete mít všechny tři soubory.

Platformový soubor

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: (řetězec) Automaticky vygenerovaný identifikátor mezi pracovními prostory představující položku a její reprezentaci ve správě zdrojového kódu.
  • type: (string) Typ položky (sémantický model, sestava atd.)
  • displayName: (řetězec) Název položky.
  • description: (volitelný textový řetězec) Popis položky.

Chcete-li přejmenovat položku, změňte položku displayName. Změna názvu složky nezmění zobrazovaný název položky v pracovním prostoru.

Logický identifikátor propojuje položku v pracovním prostoru s odpovídající položkou ve větvi Git. Předpokládá se, že položky se stejnými logickými id jsou stejné. Logický identifikátor zachová odkaz i v případě, že se název nebo adresář změní. Vzhledem k tomu, že větev je možné synchronizovat s více pracovními prostory, je možné mít položky v různých pracovních prostorech se stejným logickým ID, ale jeden pracovní prostor nemůže mít dvě položky se stejným logickým ID. Logické ID se vytvoří, když je pracovní prostor připojený k větvi Git nebo se synchronizuje nová položka. Logické ID je nezbytné k tomu, aby integrace Gitu fungovala správně. Proto je nezbytné ho žádným způsobem neměnit.

Poznámka:

Když potvrdíte změny v Gitu ve verzi 1, systémové soubory se automaticky aktualizují na verzi 2 spolu se změnami. Všechny nové soubory exportované z vývojářského režimu Power BI Desktopu se také uloží ve formátu souboru verze 2.

Poznámka:

  • Pole type je citlivé na velikost písmen. 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