Microsoft Fabric-jegyzetfüzetek létrehozása és kezelése a Visual Studio Code-ban
A Synapse Visual Studio (VS) Code bővítménye teljes mértékben támogatja a CRUD (létrehozás, olvasás, frissítés és törlés) jegyzetfüzet-műveleteket a Fabricben. A bővítmény támogatja a helyi és a távoli munkaterületek közötti szinkronizálást is; a módosítások szinkronizálásakor kezelheti a helyi és a távoli munkaterület közötti ütközéseket vagy eltéréseket.
Ezzel a bővítménnyel jegyzetfüzeteket is futtathat a távoli Apache Spark-számításon a Fabrichez.
Jegyzetfüzet megnyitása a Synapse kiterjesztéssel
Ha a Háló portál jegyzetfüzet-szerzői lapján a Megnyitás VS Code-ban gombra kattint, közvetlenül megnyithatja ugyanazt a jegyzetfüzetet a Fabric Synapse VS Code bővítményével. Miután aktiválta a bővítményt a VS Code-ban, és egyszer megnyitotta a jegyzetfüzetet, a munkaterületnek automatikusan csatlakoznia kell a jegyzetfüzethez.
Tipp.
Ha még nem telepítette a VS Code Synapse bővítményét, először telepítenie kell. További információ: A Synapse bővítmény telepítése. A bővítmény nyilvános kiadása után a telepítés automatikus lesz.
A jegyzetfüzetek listájának megtekintése
A jegyzetfüzetfa csomópont az aktuális munkaterületen található összes jegyzetfüzetelemet listázza. A VS Code módosításai alapján a lista különböző színeket és karaktereket jelenít meg a legújabb állapot jelzéséhez, ahogyan az alábbi képen is látható.
- Alapértelmezett: Az alapértelmezett vagy inicializált állapotot a jegyzetfüzetnév jobb oldalán lévő fehér szöveg és karakter jelzi. A jegyzetfüzet a távoli munkaterületen található, és nem töltötte le helyileg.
- Módosítva: A név és a sárga szöveg jobb oldalán található M karakter azt jelzi, hogy a jegyzetfüzetet helyileg letöltötte és szerkesztette a VS Code-ban, és még nem tette közzé a függőben lévő módosításokat a távoli munkaterületre.
- Helyi: Az L karakter és a zöld szöveg azt jelzi, hogy a jegyzetfüzet le van töltve, és a tartalom megegyezik a távoli munkaterületével.
- Ütközés: A C karakter és a piros szöveg azt jelzi, hogy ütközések állnak fenn a helyi verzió és a távoli munkaterület verziója között.
Jegyzetfüzet létrehozása
A VS Code Explorerben mutasson a jegyzetfüzet eszköztárára. Megjelenik a Jegyzetfüzet létrehozása lehetőség.
Válassza a Jegyzetfüzet létrehozása lehetőséget, és adjon meg egy nevet és leírást. A rendszer létrehoz egy új jegyzetfüzetet a távoli munkaterületen, és az alapértelmezett állapotban jelenik meg a jegyzetfüzetlistában.
Jegyzetfüzet letöltése
A jegyzetfüzet tartalmának szerkesztése előtt le kell töltenie a jegyzetfüzetet a VS Code-ba.
A VS Code jegyzetfüzetlistájában mutasson a jegyzetfüzet nevére. A Letöltés lehetőség megjelenik a jegyzetfüzet neve mellett.
Válassza a Letöltés lehetőséget , és mentse a jegyzetfüzetet a helyi munkakönyvtárba.
Jegyzetfüzet megnyitása
A VS Code Explorerben mutasson a letöltött jegyzetfüzet nevére. A jegyzetfüzet mellett több lehetőség is megjelenik, beleértve a Jegyzetfüzet mappa megnyitása lehetőséget is.
Válassza a Jegyzetfüzet mappa megnyitása lehetőséget , és a jegyzetfüzet megnyílik a VS Code Editor képernyőn.
Jegyzetfüzet törlése
Tipp.
A hiba elkerülése érdekében zárja be a jegyzetfüzet mappát Az Explorer nézetben, és zárja be a jegyzetfüzetet szerkesztő nézetben a jegyzetfüzet törlése előtt.
Jegyzetfüzet törlése:
A VS Code Explorerben mutasson a törölni kívánt jegyzetfüzet nevére; beállítások jelennek meg a név jobb oldalán, beleértve a Jegyzetfüzet törlése lehetőséget is.
Válassza a Jegyzetfüzet törlése lehetőséget. Amikor a rendszer kéri, válassza ki, hogy csak a helyi példányt, vagy a helyi és a távoli munkaterület másolatait is törli.
Helyi módosítások közzététele a távoli munkaterületen
A helyi módosítások leküldése a távoli munkaterületre:
A VS Code Explorerben mutasson a távoli munkaterületen közzétenni kívánt jegyzetfüzet nevére; beállítások jelennek meg a név jobb oldalán, beleértve a Közzététel lehetőséget is.
Válassza a Közzététel lehetőséget. A távoli munkaterület verziója frissül a helyi VS Code-módosításokkal.
- Ha a helyi frissítés egyesítési ütközéseket hoz létre, a rendszer kérni fogja, hogy oldja fel őket, mielőtt az egyesítés befejeződik.
Ha valaki más is megnyitotta ugyanazt a jegyzetfüzetet a Háló portálon, a rendszer értesítést kap a helyi VS Code-módosítások elfogadásáról vagy elutasításáról, ahogyan az az alábbi képen látható.
- Elfogadás: a VS Code-ról való módosítás sikeresen mentve van a munkaterületen.
- Elutasítás: a VS Code-ról való módosítás figyelmen kívül lesz hagyva.
Módosítások lekérése a távoli munkaterületről
Ha a helyi verziót a legújabb munkaterületi verzióval szeretné frissíteni, lekéri a távoli verziót:
A VS Code Explorerben mutasson a frissíteni kívánt jegyzetfüzet nevére; beállítások jelennek meg a név jobb oldalán, beleértve a Jegyzetfüzet frissítése lehetőséget is.
Válassza a Jegyzetfüzet frissítése lehetőséget. A VS Code lekéri a legújabb verziót a távoli munkaterületről, és megnyitja a VS Code diff szerkesztőt, hogy összehasonlíthassa a két jegyzetfüzetfájlt. A bal oldali képernyő a munkaterületről, a jobb oldali képernyő pedig a helyi verzióból származik:
Frissítse a bal oldalon található kód/markdown cellát a probléma megoldásához.
Ha az összes ütközést megoldotta, a diff szerkesztő jobb felső sarkában található Egyesítés lehetőséget választva ellenőrizheti, hogy az egyesítés befejeződött-e. (Amíg nem választja a Egyesítés, a jegyzetfüzet ütközés módban marad.)
Fontos
Miután egyszer megnyitotta a diff-szerkesztőt, a bővítmény NEM frissíti automatikusan a diff nézet bal oldalát, hogy lekérje a legújabb frissítést a távoli munkaterületről.
Jegyzetfüzet futtatása vagy hibakeresése távoli Spark-számításon
Az ezzel a bővítménysel szállított kernel synapse-spark-kernel kiválasztásával futtathatja a kódcellát a távoli Spark-számítás tetején. Miután kiválasztotta ezt a kernelt, a futtatókörnyezet során a bővítmény elfogja az összes PySpark API-hívást, és lefordítja őket a távoli Spark-számításnak megfelelő HTTP-hívásra. A tiszta Python-kód esetében a rendszer továbbra is a helyi környezetben hajtja végre.
