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

  • Cikk

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.

Fontos

Ez a funkció előzetes verzióban érhető el.

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 .

Screenshot of workspace source control panel.

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:

Screenshot of notebook Git repo file structure.

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.

Screenshot of notebook Git repo content format.

Megjegyzé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.
  • A csatolt környezet megmarad a jegyzetfüzetben, amikor az adattárból egy Háló-munkaterületre szinkronizál. A munkaterületek közötti referenciakörnyezetek jelenleg nem támogatottak. A jegyzetfüzet futtatásához manuálisan kell csatolnia egy új környezethez vagy munkaterülethez az alapértelmezett beállításokat.
  • 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.

Fontos

Ez a funkció előzetes verzióban érhető el.

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ó.

    Screenshot of notebook in deployment pipeline.

  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.

  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.

    Screenshot of deployment rules entry.

    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 és más lakehouse esetén.

    Screenshot of set default lakehouse.

    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.

    Megjegyzés:

    Ha úgy dönt, hogy más lakehouse-t fogad be a célkörnyezetben, a Lakehouse-azonosítónak rendelkeznie kell. Egy tóház azonosítóját a lakehouse URL-hivatkozásán találja.

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

Kapcsolódó tartalom