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


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

Ez a cikk bemutatja, hogyan működnek a Git integrációs és üzembehelyezési folyamatai a Microsoft Fabric jegyzetfüzeteiben. Megtudhatja, hogyan állíthat be kapcsolatot az adattárral, kezelheti a jegyzetfüzeteket, és hogyan helyezheti üzembe őket különböző környezetekben.

Notebook Git-integráció

A hálójegyzetfüzetek Git-integrációt kínálnak az Azure DevOps forrásvezérléséhez. A Git-integrációval biztonsági másolatot készíthet a jegyzetfüzetről és verziószámozhatja a jegyzetfüzetet, szükség szerint visszatérhet az előző szakaszokra, együttműködhet vagy önállóan dolgozhat a Git-ágak használatával, és teljes mértékben kezelheti a jegyzetfüzet tartalom életciklusát a Fabricben.

Feljegyzés

2024 októberétől kezdődően a Notebook Git-integráció támogatja a csatolt környezet leképezési kapcsolatának megőrzését az új munkaterületre való szinkronizáláskor, ami azt jelenti, hogy amikor a jegyzetfüzetet és a csatolt környezetet együtt véglegesíti a Git-adattárral, és egy másik munkaterületre szinkronizálja, az újonnan létrehozott jegyzetfüzet és környezet össze lesz kötve. Ez a frissítés hatással lesz a gitben verziózott meglévő jegyzetfüzetekre és függő környezetekre, a csatolt környezet fizikai azonosítója a jegyzetfüzet metaadatainak tartalmában logikai azonosítóra lesz lecserélve, a módosítás a diff nézetben jelenik meg.

Kapcsolat beállítása

A munkaterület beállításaiból egyszerűen beállíthat egy kapcsolatot az adattárral a módosítások véglegesítéséhez és szinkronizálásához. A kapcsolat beállításához 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 sikeresen véglegesíti a jegyzetfüzetpéldányokat a Git-adattárban, megjelenik a jegyzetfüzet mappastruktúrája az adattárban.

Most már végrehajthatja a jövőbeli műveleteket, például lekéréses kérelem létrehozását.

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

Az alábbi kép egy példa az adattárban lévő egyes jegyzetfüzetelemek fájlstruktúrájára:

Képernyőkép a jegyzetfüzet Git-adattárfájl-szerkezetéről.

Amikor véglegesíti a jegyzetfüzetelemet a Git-adattárban, a rendszer a normál .ipynb fájl helyett forráskódformátumra konvertálja a jegyzetfüzetkódot. A PySpark-jegyzetfüzetek például notebook-content.py fájllá alakulnak. Ez a megközelítés lehetővé teszi a kódvizsgálatok egyszerűbb használatát a beépített diff funkciók használatával.

Az elem tartalomforrásfájljában a metaadatok (beleértve az alapértelmezett lakehouse-t és a csatolt környezetet), a Markdown-cellák és a kódcellák megmaradnak és megkülönböztethetők. Ez a módszer támogatja a pontos helyreállítást, ha visszaszinkronizálást alkalmaz a Fabric-munkaterületre.

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

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

Feljegyzés

  • A Jegyzetfüzet-erőforrásokban lévő fájlok jelenleg nem lesznek lekötve az adattárhoz. A fájlok véglegesítése egy közelgő kiadásban támogatott.
  • Javasoljuk, hogy a jegyzetfüzeteket és a függő környezetet ugyanabban a munkaterületen kezelje, és a Git használatával a verziókövetést is vezérelje mind a jegyzetfüzet , mind a környezeti elemek számára. A Fabric Git rendszer kezeli a leképezési kapcsolatot a jegyzetfüzet és a csatolt környezet új munkaterületekre való szinkronizálásakor.
  • Az alapértelmezett lakehouse-azonosító megmarad a jegyzetfüzetben, amikor az adattárból egy Fabric-munkaterületre szinkronizál. Ha az alapértelmezett lakehouse-t tartalmazó jegyzetfüzetet véglegesíti, manuálisan kell hivatkoznia egy újonnan létrehozott lakehouse-elemre. További információ: Lakehouse Git-integráció.

Jegyzetfüzet az üzembehelyezési folyamatokban

Az üzembe helyezési folyamat használatával a jegyzetfüzet kódját különböző környezetekben is üzembe helyezheti, például fejlesztés, tesztelés és éles környezetek között. Ez a funkció lehetővé teszi a fejlesztési folyamat gördülékenyebbé tételét, a minőség és a konzisztencia biztosítását, valamint a manuális hibák csökkentését az egyszerűsített, alacsony kódszámú műveletek használatával. Az üzembe helyezési szabályokkal testre szabhatja a jegyzetfüzetek viselkedését az üzembe helyezéskor, például módosíthatja a jegyzetfüzet alapértelmezett tóházát.

Feljegyzés

  • Most az üzembehelyezési folyamat új tervét használja, a régi felhasználói felület az "Új üzembehelyezési folyamat" kikapcsolásával érhető el.
  • Októbertől kezdődően a Fabric-jegyzetfüzet támogatja az automatikus kötés funkciót, amely az alapértelmezett lakehouse-t és a csatolt környezetet köti össze ugyanazon a munkaterületen a következő fázisban való üzembe helyezéskor. A módosítás hatással lesz az üzembe helyezési folyamat meglévő jegyzetfüzeteire.
    • Az alapértelmezett lakehouse és csatolt környezet (ha az összes függő elem ugyanabban a munkaterületen található) helyébe az újonnan létrehozott elemek kerülnek a cél-munkaterületen, a jegyzetfüzet metaadatainak módosítása a következő üzembe helyezési körben a diff nézetben lesz kiemelve.
    • Beállíthatja az alapértelmezett lakehouse üzembehelyezési szabályait az automatikusan kötött tóház felülbírálásához.
  • Ismert probléma: A jegyzetfüzet zárolt cellaállapota elveszik az üzembe helyezés során. Jelenleg a kapcsolódó feladatokon dolgozunk.

Az alábbi lépésekkel fejezheti be a jegyzetfüzet üzembe helyezését az üzembe helyezési folyamattal.

  1. Hozzon létre egy új üzembehelyezési folyamatot, vagy nyisson meg egy meglévő üzembehelyezési folyamatot. (További információ: Bevezetés az üzembe helyezési folyamatok használatbavételéhez.)

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

  3. Jelölje ki, tekintse meg és hasonlítsa össze az elemeket, köztük a jegyzetfüzeteket a különböző szakaszok között, ahogyan az alábbi példában látható. A kiemelt jelvény, amely azt jelzi, hogy az előző szakasz és az aktuális szakasz között megváltozott az elemek száma.

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

  4. Válassza az Üzembe helyezés lehetőséget a jegyzetfüzetek fejlesztési, tesztelési és éles fázisokban való üzembe helyezéséhez.

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

    Képernyőkép a tartalom üzembe helyezéséről pop-up.png.

  5. (Nem kötelező.) Az üzembehelyezési szabályok kiválasztásával üzembehelyezési szabályokat hozhat létre az üzembe helyezési folyamathoz. Az üzembehelyezési szabályok bejegyzése az üzembe helyezési folyamat célszakaszában van.

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

    A Fabric támogatja az alapértelmezett lakehouse paraméterezését az egyes jegyzetfüzetpéldányokhoz az üzembe helyezési szabályokkal való üzembe helyezéskor. Három lehetőség áll rendelkezésre a cél alapértelmezett lakehouse megadására: Ugyanaz a forrás lakehouse, n/A (nincs alapértelmezett lakehouse) és egyéb lakehouse.

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

    A szabály beállításával biztonságos adatelkülönítés érhető el. A jegyzetfüzet alapértelmezett lakehouse-ját az üzembe helyezés során célként megadott érték váltja fel.

    Feljegyzés

    Ha az alapértelmezett lakehouse-t állítja be az üzembehelyezési szabályokban, a Lakehouse-azonosítónak rendelkeznie kell. A lakehouse azonosítóját lekérheti az elem URL-címére mutató hivatkozásból. Az üzembehelyezési szabályok magasabb prioritással bírnak, mint az automatikus kötés, az automatikusan kötött tóház felülíródik, amikor az üzembehelyezési szabály konfigurálva van.

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