Megosztás a következőn keresztül:


Git-integrációs forráskód formátuma

A Microsoft Fabric elemei egy mappában vannak tárolva. Az elemet tartalmazó mappa lehet a gyökérkönyvtárban vagy egy alkönyvtárban. Amikor a munkaterületet a githez csatlakoztatja, csatlakozzon az elemeket tartalmazó mappához. A mappa minden eleme saját alkönyvtárában jelenik meg.

Címtár neve

Amikor új elemet ment a Gitbe, a Git-integráció automatikusan létrehoz egy könyvtárat az adott elemhez.

Az elemkönyvtár neve a következő szabályokon alapul:

  • A név mintája.{display name}.{public facing type}
  • Szükség esetén a rendszer a következő módosításokat hajtja végre a megjelenítendő névben:
  • Ha ez a mappanév nem érhető el, a rendszer az elem logikai azonosítójának (GUID) nevét használja a megjelenítendő név helyett.

Ha például a munkaterületen a következő elemek találhatók (vegye figyelembe, hogy az első és a harmadik elemnek láthatatlan kezdő és záró területe van):

Képernyőkép a Háló munkaterület elemeinek listájáról.

A git-adattárban a következő könyvtárak jönnek létre:

Képernyőkép a Háló elemeket tartalmazó Git-könyvtárak nevéről.

  • A létrehozás után a Git-integráció soha nem változtatja meg a címtár nevét. Még ha módosítja is az elem nevét, a címtár neve változatlan marad.
  • Ha manuálisan módosítja egy elemkönyvtár nevét, vegye figyelembe az elem függőségeit. Ha például módosítja egy szemantikai modell könyvtárát, akkor mindenképpen frissítenie kell a szemantikai modell elérési útját a jelentés függőségi fájljában. Ne feledje, hogy a függőségi helyek különböző hálóélmények között változnak. A címtár nevének módosítása nem okoz bejövő változást a munkaterületen.

Címtártartalom

Minden elemkönyvtár tartalmazza az elemdefiníciós fájlokat , és automatikusan létrehozott rendszerfájlokat.

Elemdefiníciós fájlok

Minden elem könyvtárában meghatározott, szükséges fájlok találhatók, amelyek meghatározzák az adott elemet.

A Microsoft Fabric jelenleg a következő elemeket támogatja:

Tükrözött adatbázisok

A tükrözött adatbázismappák egy .json fájlt tartalmaznak, amely meghatározza a tükrözött adatbázist.

A tükrözött adatbázisok Git-integrációjának utasításaiért lásd: CI/CD a tükrözött adatbázisokhoz.

Jegyzetfüzetfájlok

A jegyzetfüzetmappák .py fájlt tartalmaznak:

A Git-integráció jegyzetfüzetekkel való használatával kapcsolatos utasításokért lásd a jegyzetfüzet forráskezelését és üzembe helyezését.

Többoldalas jelentésfájlok

A lapszámozott jelentésmappák egy .rdl fájlt tartalmaznak, amely meghatározza a lapszámozott jelentést. Az RDL (jelentésdefiníció nyelve) egy többoldalas jelentésdefiníció XML-reprezentációja.

További információ az RDL-ről: jelentésdefiníciós nyelv (RDL). A Git-integráció lapszámozott jelentésekkel való használatával kapcsolatos utasításokért lásd : Git-integráció lapszámozott jelentésekkel.

Jelentésfájlok

A jelentésmappák a következő fájlokat tartalmazzák:

  • definition.pbir
  • report.json

A jelentésmappákról és azok teljes listájáról további információt a Power BI Desktop projektjelentési mappájában talál.

Szemantikai modellfájlok

A szemantikai modellmappák a következő fájlokat tartalmazzák:

  • definition.pbidataset
  • model.bim fájl (TMSL formátum) VAGY \definition mappa (TMDL formátum)

A szemantikai modellmappákról és azok teljes listájáról további információt a Power BI Desktop projekt szemantikai modellmappájában talál.

Automatikusan létrehozott rendszerfájlok

Az elemdefiníciós fájlok mellett minden elemkönyvtár tartalmaz egy vagy két automatikusan létrehozott rendszerfájlt attól függően, hogy melyik verziót használja:

  • Az 1-es verziójú címtár item.metadata.json és item.config.json tartalmaz. A V1 esetén mindkét fájlnak a könyvtárban kell lennie.
  • A 2-es verziójú címtár .platformot tartalmaz. Ez a fájl item.metadata.json és item.config.json fájlok tartalmát is tartalmazza. Ha rendelkezik ezzel a fájllal, nem rendelkezhet a másik két fájllal. Ha az 1-es verziót használja, és módosításokat véglegesítenek, a rendszer fájljai automatikusan erre a verzióra frissülnek.

Feljegyzés

A címtárnak tartalmaznia kell a fájlokat és a item.metadata.json fájlokat item.config.json..platform Nem lehet mind a három fájl.

Platformfájl

A 2. verzióban a .platform fájl ahelyett, hogy minden elemkönyvtárban két forrásfájlt tartalmaz, az összes információt egyetlen fájlba egyesíti egy $schema tulajdonsággal. Ha rendelkezik ezzel a fájllal, nem rendelkezhet a másik két fájllal.

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

A .platform fájl a következő attribútumokat tartalmazza:

  • version: A rendszerfájlok verziószáma. Ez a szám a visszamenőleges kompatibilitás engedélyezésére szolgál. Az elem verziószáma eltérő lehet.
  • logicalId: Egy elem és a forrásvezérlő ábrázolása automatikusan létrehozott munkaterületközi azonosító.
  • type: (sztring) Az elem típusa (szemantikai modell, jelentés stb.)
  • displayName: (karakterlánc) Az elem neve.
  • description: (nem kötelező sztring) Az elem leírása.

Feljegyzés

  • A típusmező megkülönbözteti a kis- és nagybetűk értékét. Ne módosítsa az automatikus létrehozás módját, vagy sikertelen lehet.
  • Bár általában nem szabad módosítania egy elem logikai azonosítóját vagy megjelenítendő nevét , egy kivétel lehet, ha egy meglévő elemkönyvtár másolásával hoz létre új elemet. Ebben az esetben a logikai azonosítót és a megjelenítendő nevet az adattárban egyedire kell módosítania.

Ismerkedés a Git-integrációval.