Microsoft Fabric-jegyzetfüzetek használata

A Microsoft Fabric-jegyzetfüzet az Apache Spark-feladatok és gépi tanulási kísérletek fejlesztésének elsődleges kódeleme. Ez egy webes interaktív felület, amelyet adattudósok és adatszakértők használnak a gazdag vizualizációk és Markdown-szövegek előnyeit kihasználó kód írásához. Az adatmérnökök kódot írnak az adatbetöltéshez, az adatok előkészítéséhez és az adatátalakításhoz. Az adattudósok jegyzetfüzeteket is használnak gépi tanulási megoldások létrehozásához, beleértve a kísérletek és modellek létrehozását, a modellkövetést és az üzembe helyezést.

Hálójegyzetfüzetekkel a következőket teheti:

  • Első lépések a nulla beállítási munkával.
  • Egyszerűen feltárhatja és feldolgozhatja az adatokat intuitív, alacsony kódszámú felhasználói felülettel.
  • Az adatok védelme a beépített vállalati biztonsági funkciókkal.
  • Adatok elemzése nyers formátumok (CSV, txt, JSON stb.), feldolgozott fájlformátumok (parquet, Delta Lake stb.) között, hatékony Spark-képességek használatával.
  • Legyen hatékony a bővített szerzői képességekkel és a beépített adatvizualizációval.

Ez a cikk bemutatja, hogyan használhat jegyzetfüzeteket az adatelemzési és adatelemzési szolgáltatásokban.

Jegyzetfüzetek létrehozása

Létrehozhat egy új jegyzetfüzetet, vagy importálhat egy meglévő jegyzetfüzetet.

Új jegyzetfüzet létrehozása

A szokásos Hálóelem-létrehozási folyamatokhoz hasonlóan egyszerűen létrehozhat egy új jegyzetfüzetet a Háló adatmérnök kezdőlapjáról, a munkaterület Új lehetőségéből vagy a Létrehozási központból.

Meglévő jegyzetfüzetek importálása

Egy vagy több meglévő jegyzetfüzetet importálhat a helyi számítógépről egy Háló munkaterületre a adatmérnök vagy a Adattudomány kezdőlapjáról. A hálójegyzetfüzetek felismerik a standard Jupyter Notebook .ipynb fájlokat és a forrásfájlokat, például a .py, a .scala és a .sql fájlokat, és ennek megfelelően hoznak létre új jegyzetfüzetelemeket.

Screenshot showing where to find notebook options on the New menu.

Jegyzetfüzet exportálása

A jegyzetfüzetet más szabványos formátumokba is exportálhatja. A Synapse-jegyzetfüzet exportálható a következőbe:

  • A Jupyter-jegyzetfüzetekhez használt standard jegyzetfüzetfájl (.ipynb).
  • Egy HTML-fájl (.html), amely közvetlenül a böngészőből nyitható meg.
  • Egy Python-fájl (.py).
  • Latex-fájl (.tex).

Screenshot showing where to export notebook.

Jegyzetfüzet mentése

A Fabricben a jegyzetfüzetek alapértelmezés szerint automatikusan mentésre kerülnek a megnyitás és szerkesztés után; nem kell aggódnia a kódmódosítások elvesztése miatt. A Másolat mentése parancsot is használhatja egy másik példány klónozásához az aktuális munkaterületen vagy egy másik munkaterületen.

Screenshot showing where to save a copy.

Ha inkább manuálisan szeretne menteni egy jegyzetfüzetet, váltson a Manuális mentés beállításra, hogy a jegyzetfüzetelem egy helyi ága legyen, majd mentse a módosításokat a Mentés vagy a CTRL+s billentyűkombinációval.

Screenshot showing where to switch manual save.

Manuális mentési módra is válthat a Szerkesztés –>Mentési beállítások>Manuális lehetőség kiválasztásával. Ha be szeretné kapcsolni a jegyzetfüzet egy helyi ágát, majd manuálisan menteni, válassza a Mentés vagy a Ctrl+s billentyűparancsot.

Csatlakozás tóházak és jegyzetfüzetek

A hálójegyzetfüzetek mostantól támogatják a lakehouse-okkal való szoros interakciót; a Lakehouse Explorerből egyszerűen hozzáadhat egy új vagy meglévő tóházat.

A Lakehouse Explorerben navigálhat a különböző tóházakhoz, és a rögzítéssel beállíthatja az egyik tóházat alapértelmezettként. Az alapértelmezett beállítás ezután a futtatókörnyezet munkakönyvtárához van csatlakoztatva, és helyi elérési út használatával olvashat vagy írhat az alapértelmezett lakehouse-ba.

Screenshot showing where to pin a default lakehouse.

Megjegyzés:

Az új lakehouse rögzítése vagy az alapértelmezett lakehouse átnevezése után újra kell indítania a munkamenetet.

Tóház hozzáadása vagy eltávolítása

Ha a tóház neve melletti X ikont választja, az eltávolítja a jegyzetfüzet lapról, de a lakehouse elem továbbra is létezik a munkaterületen.

Válassza a Lakehouse hozzáadása lehetőséget, ha további tóházakat szeretne hozzáadni a jegyzetfüzethez egy meglévő hozzáadásával vagy egy új tóház létrehozásával.

Lakehouse-fájl felfedezése

A Lake nézet Táblák és fájlok szakaszában lévő almappák és fájlok a lakehouse-lista és a jegyzetfüzet tartalma közötti tartalomterületen jelennek meg. A tartalomterület frissítéséhez válasszon ki különböző mappákat a Táblák és fájlok szakaszban.

Mappa- és fájlműveletek

Ha jobb egérkattintással kiválaszt egy fájlt (.csv, .parquet, .txt, .jpg, .png stb.), a Spark vagy a Pandas API használatával betöltheti az adatokat. A rendszer létrehoz egy új kódcellát, és beszúrja a fókuszcella alá.

A kijelölt fájltól vagy mappától eltérő formátumú elérési utat egyszerűen másolhat, és használhatja a megfelelő elérési utat a kódban.

Screenshot showing context menu of files in lakehouse.

Jegyzetfüzet-erőforrások

A jegyzetfüzet erőforrás-kezelője Unix-szerű fájlrendszert biztosít a mappák és fájlok kezeléséhez. Írható fájlrendszerterületet biztosít, ahol kis méretű fájlokat, például kódmodulokat, szemantikai modelleket és képeket tárolhat. A jegyzetfüzetben lévő kóddal egyszerűen elérheti őket, mintha a helyi fájlrendszerrel dolgozik.

Animated GIF of notebook resources.

Ez a beépített mappa minden jegyzetfüzetpéldányhoz egy előre definiált rendszermappa. Legfeljebb 500 MB tárterületet őriz meg az aktuális jegyzetfüzet függőségeinek tárolásához. Ezek a jegyzetfüzet-erőforrások fő képességei:

  • Használhat olyan gyakori műveleteket, mint a létrehozás/törlés, a feltöltés/letöltés, az húzás,az átnevezés, a duplikálás és a keresés a felhasználói felületen keresztül.
  • Relatív útvonalakat is használhat, például builtin/YourData.txt gyors feltáráshoz. A mssparkutils.nbResPath metódus segít a teljes elérési út megírásában.
  • Az érvényesített adatokat egyszerűen áthelyezheti egy tóházba az Írás a lakehouse-ba lehetőséggel. A Fabric beágyazott rich code-kódrészleteket a gyakori fájltípusokhoz, amelyek segítenek a gyors kezdésben.
  • Ezek az erőforrások a referenciajegyzetfüzet-futtatási esethez is elérhetők a következőn keresztülmssparkutils.notebook.run(): .

Megjegyzés:

  • A Fabric jelenleg támogatja bizonyos fájltípusok feltöltését a felhasználói felületen keresztül, beleértve a .py, .whl, .jar, .txt, .json, .yml, .xml, .csv, .html, .png, .jpg és .xlsx fájlokat. A beépített mappába olyan fájltípusokkal írhat, amelyek nem szerepelnek a listában kóddal, a Fabric-jegyzetfüzetek azonban nem támogatják a kódrészletek nem támogatott fájltípusokon történő generálásához.
  • Minden fájlméretnek 50 MB-nál kisebbnek kell lennie, és a beépített mappa összesen legfeljebb 100 fájl-/mappapéldányt tesz lehetővé.
  • Ha ezt használja mssparkutils.notebook.run(), használja a mssparkutils.nbResPath parancsot a céljegyzetfüzet-erőforrás eléréséhez. A "builtin/" relatív elérési út mindig a gyökérjegyzetfüzet beépített mappájára mutat.

Együttműködés jegyzetfüzetben

A Háló jegyzetfüzet egy együttműködési elem, amely támogatja, hogy több felhasználó szerkessze ugyanazt a jegyzetfüzetet.

Amikor megnyit egy jegyzetfüzetet, alapértelmezés szerint a közös szerkesztési módot adja meg, és minden jegyzetfüzetszerkesztés automatikusan megtörténik. Ha munkatársai egyszerre nyitják meg ugyanazt a jegyzetfüzetet, láthatja a profiljukat, futtathatják a kimenetet, a kurzorjelzőt, a kijelölésjelzőt és a szerkesztési nyomkövetést. Az együttműködési funkciók használatával könnyedén elvégezheti a párok programozását, a távoli hibakeresést és az oktatói forgatókönyveket.

Screenshot showing a code cell with another user editing.

Jegyzetfüzet megosztása

A jegyzetfüzetek megosztása kényelmes módja a csapattagokkal való együttműködésnek. A jogosult munkaterületi szerepkörök alapértelmezés szerint megtekinthetik vagy szerkeszthetik/futtathatják a jegyzetfüzeteket. Megoszthat egy jegyzetfüzetet megadott engedélyekkel.

  1. Válassza a Megosztás lehetőséget a jegyzetfüzet eszköztárán.

    Screenshot showing where to select Share.

  2. Válassza ki a jegyzetfüzetet megtekintő személyek megfelelő kategóriáját. Kiválaszthatja a címzettek megosztási, szerkesztési vagy futtatási engedélyeit.

    Screenshot showing where to select permissions.

  3. Az Alkalmaz lehetőség kiválasztása után közvetlenül is elküldheti a jegyzetfüzetet, vagy átmásolhatja a hivatkozást másoknak. A címzettek ezután megnyithatják a jegyzetfüzetet az engedélyszintjüknek megfelelő nézettel.

    Screenshot showing where to create and send link.

  4. A jegyzetfüzet engedélyeinek további kezeléséhez válassza a Munkaterület elemlista További lehetőségek lehetőséget>, majd az Engedélyek kezelése lehetőséget. Ezen a képernyőn frissítheti a meglévő jegyzetfüzet-hozzáférést és -engedélyeket.

    Screenshot showing where to manage permissions in workspace.

Kódcella megjegyzése

A kommentelés egy másik hasznos funkció az együttműködésen alapuló forgatókönyvek esetében. A Fabric jelenleg támogatja a cellaszintű megjegyzések hozzáadását.

  1. A Megjegyzések panel megnyitásához válassza a jegyzetfüzet eszköztárának Megjegyzések gombját vagy a cella megjegyzésjelzőt.

    Screenshot showing where to select Comment.

  2. Jelöljön ki kódot a kódcellában, válassza az Új lehetőséget a Megjegyzések panelen, adjon hozzá megjegyzéseket, majd a Mentéshez válassza a Megjegyzés közzététele lehetőséget.

    Screenshot showing where to select New.

  3. Ha szüksége van rájuk, keresse meg a Megjegyzés szerkesztése, a Szál feloldása és a Szál törlése lehetőséget a megjegyzés melletti További lehetőség kiválasztásával.

Jegyzetfüzet mód váltása

A hálójegyzetfüzetek két módot támogatnak, amelyek között egyszerűen válthat: Szerkesztési és Megtekintési mód.

Screenshot showing where switch modes.

  • Szerkesztési mód: Szerkesztheti és futtathatja a cellákat, és együttműködhet másokkal a jegyzetfüzetben.
  • Megtekintési mód: Csak a jegyzetfüzet cellatartalma, kimenete és megjegyzései tekinthetők meg. A jegyzetfüzetet módosító összes művelet le van tiltva.