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 akár a főkönyvtárban, akár 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.

A könyvtári elem 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 Fabric 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égek elhelyezkedése változhat a különböző Fabric-élmények között. 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és fájlok

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

  • definíció.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.pbism
  • \definition mappa, amely TMDL fájlokat tartalmaz

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.

Felhasználói adatfunkciók fájljai

A felhasználói adattárolási mappa a következő fájlokat tartalmazza:

  • function-app.py – A Python-függvény kódja. Ez a fő fájl, amelyet szerkeszt.
  • definitions.json – Elemdefiníciók, például kapcsolatok és tárhivatkozások.
  • resources/functions.json – Metaadatok az elemen belüli kapcsolatokról, kódtárakról és függvényekről. Ne szerkessze manuálisan a fájlt.

A Git és a felhasználói adatfüggvények integrációjával kapcsolatos utasításokért tekintse meg a Felhasználói adatforrások forráskezelését és üzembe helyezését ismertető cikket.

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.

Megjegyzés

A címtárnak tartalmaznia kell vagy a item.metadata.json és item.config.json fájlokat, vagy a fájlt. Nem lehet a tiéd 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: (sztring) Automatikusan generált munkaterületközi azonosító, amely egy elemet és annak forrásvezérlő-megjelenítését jelöli.
  • 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.

Ha átnevezi az összetevőt a munkaterületen, és a Git összetevőmappájának "." utótagja van, akkor a véglegesítés után a Gitben a könyvtár és a displayName könyvtár neve megegyezik.

A logikai azonosító összekapcsolja a munkaterület egy elemét egy Git-ág megfelelő elemével. Az azonos logikai azonosítókkal rendelkező elemeket a rendszer azonosnak tekinti. A logikai azonosító akkor is megőrzi a hivatkozást, ha a név vagy a könyvtár megváltozik. Mivel egy ág több munkaterületre is szinkronizálható, lehetséges, hogy a különböző munkaterületeken lévő elemek azonos logikai azonosítóval rendelkeznek, de egyetlen munkaterületen nem lehet két azonos logikai azonosítójú elem. A logikai azonosító akkor jön létre, ha a munkaterület egy Git-ághoz csatlakozik, vagy egy új elem szinkronizálása történik. A logikai azonosító szükséges ahhoz, hogy a Git-integráció megfelelően működjön. Ezért alapvető fontosságú, hogy semmilyen módon ne változtassa meg.

Megjegyzés

Amikor az 1. verzióban véglegesíti a Git módosításait, a rendszerfájlok automatikusan frissülnek a 2- es verzióra a módosításokkal együtt. Emellett a Power BI Desktop fejlesztői módban exportált új fájlok a 2- es verziójú fájlformátumban lesznek mentve.

Megjegyzés

  • A típus mező érzékeny a kis- és nagybetűkre. 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.

Kapcsolódó tartalom

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

  • Last updated on