Jegyzetfüzet forrásának vezérlése és üzembe helyezése

Ez a cikk bemutatja, hogyan használható a Git-integrációs és üzembehelyezési folyamatok jegyzetfüzetekkel a Microsoft Fabricben. Megtudhatja, hogyan csatlakoztathat adattárakat, kezelheti a jegyzetfüzet forráskódját, és helyezhet üzembe jegyzetfüzeteket a környezetekben.

Mielőtt elkezdenéd

  • Csatlakoztassa a munkaterületet a Githez a jegyzetfüzet forráskövetési lépéseinek végrehajtása előtt. A beállítási utasításokért tekintse meg a Git-integráció első lépéseit.
  • Hozzon létre jegyzetfüzet-telepítési szabályokat a célszakaszban (például tesztelés vagy éles környezet), ne a fejlesztési szakaszban.
  • Az üzembehelyezési szabályok létrehozásához az elem tulajdonosának kell lennie.

Notebook Git-integráció

A hálójegyzetfüzetek támogatják a Git és az Azure DevOps integrációját a forráskezeléshez. A jegyzetfüzet módosításait verziószámozhatja, ágak használatával együttműködhet, és közvetlenül a Fabricben kezelheti a jegyzetfüzet életciklus-frissítéseit.

Ha a jegyzetfüzetet a csatolt függőségekkel (például környezetekkel) együtt véglegesíti, a másik munkaterületre való szinkronizálás megőrzi ezeket a kötéseket. A Fabric automatikusan az új munkaterület megfelelő erőforrásaihoz köti a jegyzetfüzetet.

Ennek a viselkedésnek a támogatása érdekében a Fabric logikai azonosítókat tárol a csatolt erőforrásokhoz a jegyzetfüzet metaadataiban. Ennek eredményeképpen a Git-diffek metaadat-frissítéseket jeleníthetnek meg a fizikai azonosítóktól a logikai azonosítókig.

Megjegyzés

A logikai azonosítókkal és az automatikus kötéssel kapcsolatos metaadat-frissítések akkor is megjelenhetnek a Git diff nézetekben, ha a jegyzetfüzet kódja nem változik.

Kapcsolat beállítása

A munkaterület beállításai között állítson be egy kapcsolatot az adattárral a módosítások véglegesítéséhez és szinkronizálásához. A beállítási utasításokért tekintse meg a Git-integráció első lépéseit. A csatlakozás után az elemek, köztük a jegyzetfüzetek is megjelennek a Forrás vezérlőpulton .

Képernyőkép a munkaterület forrásvezérlő paneléről.

Miután véglegesíti a jegyzetfüzetpéldányokat a Git-adattárban, láthatja a jegyzetfüzet mappastruktúráját az adattárban.

Most már elvégezheti a Git-műveleteket, például lekéréses kérelem létrehozását.

Jegyzetfüzet-ábrázolás a Gitben

Az alábbi szöveg egy jegyzetfüzetelem fájlstruktúráját mutatja be a Git-adattárban:

.
├── Notebook_1.Notebook/
│   ├── Resources/ (Optional)
│   │   └── builtin/
│   │       ├── large_dataset.parquet
│   │       └── model_output.parquet
│   ├── .platform
│   ├── fs-settings.json (Optional)
│   ├── notebook-content.py
│   └── notebook-settings.json (Optional)
└── Readme.md

.
├── Notebook_2.Notebook/
│   ├── Resources/ (Optional)
│   │   └── builtin/
│   │       ├── large_dataset.parquet
│   │       └── model_output.parquet
│   ├── .platform
│   ├── fs-settings.json (Optional)
│   ├── notebook-content.sql
│   └── notebook-settings.json (Optional)
└── Readme.md

Jegyzetfüzetelem véglegesítésekor a Fabric a szokásos .ipynb fájl helyett forrásfájlként tárolja. A PySpark-jegyzetfüzetek például a következőképpen lesznek tárolva notebook-content.py: . Ezt a formátumot könnyebben áttekintheti a Git diffsben.

A forrásfájl külön szakaszként tárolja a jegyzetfüzet metaadatait (beleértve az alapértelmezett lakehouse-t és a csatolt környezetet), a Markdown-cellákat és a kódcellákat. A Fabric ezzel a struktúrával rekonstruálja a jegyzetfüzetet a munkaterületre való visszaszinkronizáláskor.

A jegyzetfüzet cellakimenete nem szerepel a Gittel való szinkronizáláskor.

Az alábbi képernyőképen a Git-adattár forrásformátuma látható:

Képernyőkép a jegyzetfüzet Git-adattár tartalomformátumáról.

Megjegyzés

A jegyzetfüzeteket és a függő környezeteket ugyanabban a munkaterületen tarthatja, és a Git jegyzetfüzeteit és környezeti elemeit is verziószámozza. A Fabric ezeket a kapcsolatokat az új munkaterületekre való szinkronizáláskor képezi le.

Az alapértelmezett lakehouse-azonosító a jegyzetfüzet metaadataiban marad, amikor az adattárból egy Fabric-munkaterületre szinkronizál. Szükség esetén manuálisan kösse a jegyzetfüzetet az új lakehouse-elemhez. További információ: Lakehouse Git-integráció.

Notebook Git-beállítások

A Git-beállítások panelen szabályozhatja, hogy a jegyzetfüzetek hogyan használják a forrásvezérlőt, beleértve a Git-kötés beállításait és a véglegesítésekben szereplő erőforrások mappafájljainak kezelését.

Megjegyzés

Ne szerkessze notebook-settings.json a Git-adattárat az automatikus Git-kötés vagy -erőforrások szabályozásához. Ezeket a beállításokat a jegyzetfüzet beállításai lapon kezelheti.

Lakehouse automatikus összekapcsolás a Gitben

A Lakehouse automatikus kötése lehetővé teszi, hogy a Fabric megkeresse a megfelelő alapértelmezett Lakehouse-t az egyes Git-csatlakoztatott munkaterületekhez. Ez csökkenti a manuális újrakötést, ha a jegyzetfüzeteket fejlesztési, tesztelési és éles munkaterületek között helyezi át.

Engedélyezze ezt a funkciót a Jegyzetfüzet beállításai között. Miután engedélyezte, a Fabric létrehozza a notebook-settings.json-t az adattárban, és automatikusan kezeli ezt a fájlt. Ne szerkessze manuálisan a fájlt.

Képernyőkép a jegyzetfüzet git-integrációjáról.

Megjegyzés

A jegyzetfüzet Git-integráció támogatja a jegyzetfüzetek és a hozzájuk kapcsolt lakehouse-ok kapcsolatának megőrzését a munkaterületek közötti szinkronizáláskor. Ha egy jegyzetfüzetet egy másik munkaterületre szinkronizál, kiválaszthatja, hogy az a forrás-munkaterületen lévő tóházhoz vagy az új munkaterület tóházához kapcsolódik-e. A Gitben már verziószámozott jegyzetfüzetek esetében a csatolt tóház fizikai azonosítója a jegyzetfüzet metaadataiban logikai azonosítóra cserélődik. Ez a módosítás a Git diff nézetben jelenhet meg.

A Jegyzetfüzetek erőforrás mappájának támogatása a Gitben

Megjegyzés

A Környezeti erőforrások mappa és az üzembehelyezési folyamatokkal és a nyilvános API-kkal való integráció jelenleg nem támogatott.

A beépített Erőforrások mappa leküldhető a Githez, így a szkriptek és konfigurációs fájlok verziószámozottak lesznek a jegyzetfüzetben.

Ez a funkció alapértelmezés szerint nem kötelező és ki van kapcsolva. Engedélyezze a Git-beállítások szakaszban található Jegyzetfüzet-beállításokból. Az engedélyezés után az Erőforrások mappában lévő fájlok a véglegesítések részét képezik. Mivel a véglegesítések 50 MB-os korlátot tartalmaznak, használjon .gitignore fájl- vagy Git-szabályokat a nagyméretű vagy ideiglenes fájlok vagy mappák kizárásához.

Képernyőkép a jegyzetfüzet erőforrásairól a Git-konfigurációban.

Megjegyzés

Csak a .gitignore van hatással a beépített erőforrást tartalmazó gyökérmappában.

Miután konfigurálta a Git-szabályokat és véglegesíti a módosításokat, a Fabric menti a szabályokat az adattárban fs-settings.json . A Fabric létrehozza és kezeli ezt a fájlt, hogy konzisztens maradjon az adattár konfigurációja. Azt sem javasoljuk, hogy közvetlenül a Git-adattárban szerkessze a fájlt.

Képernyőkép a jegyzetfüzet-erőforrások struktúrájáról a Git-konfigurációban.

Jegyzetfüzet a telepítési folyamatokban

Az üzembe helyezési csővezetékekkel előléptethet notebook-módosításokat olyan szakaszokban, mint fejlesztés, tesztelés és éles környezet. Ellenőrizze a frissítéseket a korábbi szakaszokban, mielőtt bevezeti őket a termelési környezetbe.

A jegyzetfüzet üzembe helyezése támogatja az automatikus kötést az alapértelmezett lakehouse és a kapcsolt környezet esetén, ha a függő elemek ugyanabban a munkaterületen találhatók. Az üzembe helyezés során a Fabric újrakonfigurálhatja ezeket a függőségeket a cél-munkaterület megfelelő elemeihez. A metaadatok módosításai megjelenhetnek a diff nézetben.

Ha egy adott célállomás alapértelmezett lakehouse-ra van szüksége, konfiguráljon egy telepítési szabályt az automatikus kötés felülbírálásához.

Az új üzembehelyezési folyamat felhasználói felülete jelenleg ebben a cikkben van használatban. Az Új üzembehelyezési folyamat kikapcsolásával válthat a régi felhasználói felületre.

Megjegyzés

Ismert probléma: a jegyzetfüzetek fagyasztott cellaállapota nem marad meg az üzembe helyezés során.

A jegyzetfüzetek üzembe helyezési folyamaton keresztüli üzembe helyezéséhez kövesse az alábbi lépéseket.

  1. Hozzon létre egy üzembehelyezési folyamatot, vagy nyisson meg egy meglévőt. További információ: Üzembehelyezési folyamatok– első lépések.

  2. Munkaterületek hozzárendelése különböző szakaszokhoz az üzembe helyezési céloknak megfelelően.

  3. Elemek ( köztük jegyzetfüzetek) kijelölése, megtekintése és összehasonlítása a szakaszok között. A kiemelt jelvény a módosított elemek számát mutatja az előző szakasz és az aktuális szakasz között.

    Képernyőkép az üzembe helyezési folyamat jegyzetfüzetéről.

  4. Válassza a Telepítés lehetőséget, hogy a jegyzetfüzeteket a Fejlesztés, Tesztelés, és Élesítés fázisok között továbbítsa.

    Képernyőkép az elemek kijelöléséről és az üzembe helyezésről.

  5. Az Üzembe helyezés ebben a fázisban ablakban tekintse át az új és módosított elemeket. Ha egy vagy több elem meghiúsulása esetén is folytatni szeretné az üzembe helyezést, válassza a Telepítés folytatása lehetőséget, ha egy vagy több elem meghiúsul.

    Miután áttekintette és megerősítette a kijelölést, válassza az Üzembe helyezés lehetőséget.

    Képernyőkép az üzembe helyezési tartalom felugró ablakáról.png.

  6. (Nem kötelező.) Üzembehelyezési szabályok létrehozásához válassza a folyamat célszakasz-elemének üzembehelyezési szabályait (például Tesztelés vagy Éles üzem).

    A szabályok általános viselkedésével és korlátozásaival kapcsolatban lásd: Üzembehelyezési szabályok létrehozása.

    Képernyőkép az üzembehelyezési szabályok bejegyzéséről.

  7. Konfiguráljon egy alapértelmezett lakehouse-szabályt minden egyes jegyzetfüzet-telepítéshez.

    Ez a szabály szabályozza, hogy a jegyzetfüzet melyik tóhoz csatlakozik a célszakaszban az üzembe helyezés után.

    Az Üzembehelyezési szabályok beállítása panelen válassza az Alapértelmezett lakehouse csempét.

    Használja a Forrás és Cél legördülő menüket a forrásszakasz alapértelmezett lakehouse-jának leképezésére a célszakasz alapértelmezett lakehouse-jára.

    • Ugyanaz a lakehouse, mint a forrásnál: Tartsa meg ugyanazt az alapértelmezett lakehouse-beállítást, mint az eredeti szakasznál.
    • N/A (nincs alapértelmezett lakehouse): Távolítsa el az alapértelmezett lakehouse-beállítást a célszakaszban.
    • Egyéb: Cserélje le a forrásszakasz alapértelmezett tóházát egy másik tóházra a célszakaszban.

    Ha az Egyéb lehetőséget választja a Teendő legördülő listában, adja meg a céltóház adatait:

    • Lakehouse-azonosító
    • Lakehouse neve
    • Lakehouse-munkaterület azonosítója

    Képernyőkép az alapértelmezett lakehouse beállításáról.

    Megjegyzés

    A szabály konfigurálásakor a Lakehouse-azonosítóra van szükség. Az elem URL-címéről lekérheti a lakehouse-azonosítót. Az üzembehelyezési szabályok elsőbbséget élveznek az automatikus kötéssel szemben. Ha egy üzembehelyezési szabály konfigurálva van, felülbírálja az automatikusan kötött lakehouse-t.

  8. Az üzembe helyezés állapotának figyelése az üzembe helyezési előzményekből.

Kapcsolódó tartalom

  • Last updated on