Slik bruker du Microsoft Fabric-notatblokker

Microsoft Fabric-notatblokken er et primært kodeelement for utvikling av Apache Spark-jobber og maskinlæringseksperimenter. Det er en nettbasert interaktiv overflate som brukes av dataforskere og dataingeniører til å skrive kode som drar nytte av rike visualiseringer og Markdown-tekst. Datateknikere skriver kode for datainntak, dataforberedelse og datatransformasjon. Dataforskere bruker også notatblokker til å bygge maskinlæringsløsninger, inkludert oppretting av eksperimenter og modeller, modellsporing og distribusjon.

Med en Fabric-notatblokk kan du:

  • Kom i gang med null oppsettsinnsats.
  • Utforsk og behandle data enkelt med intuitiv lavkodeopplevelse.
  • Hold data sikre med innebygde sikkerhetsfunksjoner for virksomheter.
  • Analyser data på tvers av råformater (CSV, txt, JSON osv.), behandlede filformater (parkett, Delta Lake osv.), ved hjelp av kraftige Spark-funksjoner.
  • Vær produktiv med forbedrede redigeringsfunksjoner og innebygd datavisualisering.

Denne artikkelen beskriver hvordan du bruker notatblokker i datavitenskap og datateknikkopplevelser.

Opprette notatblokker

Du kan enten opprette en ny notatblokk eller importere en eksisterende notatblokk.

Opprette en ny notatblokk

I likhet med andre standard prosesser for oppretting av stoffelementer, kan du enkelt opprette en ny notatblokk fra hjemmesiden Fabric Dataingeniør ing, nytt arbeidsområde eller Opprett hub.

Importere eksisterende notatblokker

Du kan importere én eller flere eksisterende notatblokker fra den lokale datamaskinen til et Fabric-arbeidsområde fra hjemmesiden Dataingeniør ing eller datavitenskap. Fabric notebooks recognize the standard Jupyter Notebook .ipynb files, and source files like .py, .scala, and .sql, and create new notebook items accordingly.

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

Eksportere en notatblokk

Du kan eksportere notatblokken til andre standardformater. Synapse-notatblokken kan eksporteres til:

  • Standard notatblokkfil (.ipynb) som brukes for Jupyter-notatblokker.
  • En HTML-fil (HTML) som kan åpnes direkte fra en nettleser.
  • En Python-fil (PY).
  • En Latex-fil (TEX).

Screenshot showing where to export notebook.

Lagre en notatblokk

I Fabric lagres en notatblokk som standard automatisk etter at du har åpnet og redigert den. du trenger ikke å bekymre deg for å miste kodeendringer. Du kan også bruke Lagre en kopi til å klone en annen kopi i gjeldende arbeidsområde eller til et annet arbeidsområde.

Screenshot showing where to save a copy.

Hvis du foretrekker å lagre en notatblokk manuelt, kan du bytte til alternativet Manuell lagring for å ha en lokal gren av notatblokkelementet, og deretter bruke Lagre eller CTRL+s til å lagre endringene.

Screenshot showing where to switch manual save.

Du kan også bytte til manuell lagringsmodus ved å velge Rediger ->Lagre alternativer ->Manuell. Hvis du vil aktivere en lokal gren av notatblokken og deretter lagre den manuelt, velger du Lagre eller bruk hurtigtasten ctrl+s.

Koble til lakehouses og notatblokker

Fabric notebooks støtter nå tette interaksjoner med lakehouses; Du kan enkelt legge til et nytt eller eksisterende lakehouse fra Lakehouse Explorer.

Du kan navigere til forskjellige lakehouses i Lakehouse explorer og sette en lakehouse som standard ved å feste den. Standardinnstillingen er deretter montert i arbeidskatalogen for kjøretid, og du kan lese eller skrive til standard lakehouse ved hjelp av en lokal bane.

Screenshot showing where to pin a default lakehouse.

Merk

Du må starte økten på nytt etter å ha festet et nytt lakehouse eller gi nytt navn til standard lakehouse.

Legge til eller fjerne et lakehouse

Hvis du velger X-ikonet ved siden av et lakehouse-navn, fjernes det fra notatblokkfanen, men lakehouse-elementet finnes fortsatt i arbeidsområdet.

Velg Legg til lakehouse for å legge til flere lakehouses i notatblokken, enten ved å legge til en eksisterende eller opprette et nytt lakehouse.

Utforsk en lakehouse-fil

Undermappen og filene under Tabeller og filer-delen av Lake-visningen vises i et innholdsområde mellom lakehouse-listen og notatblokkinnholdet. Velg forskjellige mapper i inndelingen Tabeller og filer for å oppdatere innholdsområdet.

Mappe- og filoperasjoner

Hvis du velger en fil (.csv, .parquet, .txt, .jpg, .png osv.) med et høyre museklikk, kan du bruke Spark- eller Pandas-API-en til å laste inn dataene. En ny kodecelle genereres og settes inn under fokuscellen.

Du kan enkelt kopiere en bane med et annet format enn den valgte filen eller mappen og bruke den tilsvarende banen i koden.

Screenshot showing context menu of files in lakehouse.

Notatblokkressurser

Ressursutforskeren for notatblokken inneholder et Unix-lignende filsystem som hjelper deg med å administrere mapper og filer. Det gir en skrivbar filsystemplass der du kan lagre små filer, for eksempel kodemoduler, semantiske modeller og bilder. Du kan enkelt få tilgang til dem med kode i notatblokken som om du jobbet med det lokale filsystemet.

Animated GIF of notebook resources.

Denne innebygde mappen er en forhåndsdefinert systemmappe for hver notatblokkforekomst. Den bevarer opptil 500 MB lagringsplass for å lagre avhengighetene til gjeldende notatblokk. Dette er de viktigste funksjonene i notatblokkressurser:

  • Du kan bruke vanlige operasjoner som oppretting/sletting, opplasting/nedlasting, dra/slipp, gi nytt navn til, duplisere og søke gjennom brukergrensesnittet.
  • Du kan bruke relative baner som builtin/YourData.txt for rask utforskning. Metoden mssparkutils.nbResPath hjelper deg med å skrive hele banen.
  • Du kan enkelt flytte dine validerte data til et lakehouse via alternativet Skriv til lakehouse . Fabric har innebygde rike kodesnutter for vanlige filtyper for å hjelpe deg med å komme raskt i gang.
  • Disse ressursene er også tilgjengelige for bruk i kjøretilfellet referansenotatblokk via mssparkutils.notebook.run().

Merk

  • For øyeblikket støtter Fabric opplasting av bestemte filtyper gjennom brukergrensesnittet, inkludert .py-, .whl-, .jar-, .txt-, .json-, .yml-, .xml-, .csv-, .html-, .png-, .jpg- og XLSX-filer. Du kan skrive til den innebygde mappen med filtyper som ikke er i listen via kode, men Fabric-notatblokker støtter ikke generering av kodesnutter på filtyper som ikke støttes.
  • Hver filstørrelse må være mindre enn 50 MB, og den innebygde mappen tillater totalt opptil 100 fil-/mappeforekomster.
  • Når du bruker mssparkutils.notebook.run(), bruker du mssparkutils.nbResPath kommandoen til å få tilgang til målnotatblokkressursen. Den relative banen «innebygd/» peker alltid til den innebygde mappen i rotnotatblokken.

Samarbeide i en notatblokk

Fabric-notatblokken er et samarbeidselement som støtter flere brukere som redigerer samme notatblokk.

Når du åpner en notatblokk, angir du samtidig redigeringsmodus som standard, og hver redigering av notatblokken lagres automatisk. Hvis kollegene dine åpner samme notatblokk samtidig, ser du profilen deres, kjører utdata, markørindikator, utvalgsindikator og redigeringssporing. Ved å bruke samarbeidsfunksjonene kan du enkelt utføre parprogrammering, ekstern feilsøking og veiledningsscenarioer.

Screenshot showing a code cell with another user editing.

Dele en notatblokk

Deling av en notatblokk er en praktisk måte å samarbeide med gruppemedlemmer på. Autoriserte arbeidsområderoller kan vise eller redigere/kjøre notatblokker som standard. Du kan dele en notatblokk med angitte tillatelser.

  1. Velg Del på verktøylinjen for notatblokken.

    Screenshot showing where to select Share.

  2. Velg den tilsvarende kategorien for personer som kan vise denne notatblokken. Du kan velge Tillatelser for Deling, Rediger eller Kjør for mottakerne.

    Screenshot showing where to select permissions.

  3. Når du har valgt Bruk, kan du enten sende notatblokken direkte eller kopiere koblingen til andre. Mottakere kan deretter åpne notatblokken med den tilsvarende visningen gitt av tillatelsesnivået.

    Screenshot showing where to create and send link.

  4. Hvis du vil behandle notatblokktillatelsene ytterligere, velger du Liste over flere alternativer for>arbeidsområdeelement, og deretter velger du Behandle tillatelser. Fra dette skjermbildet kan du oppdatere eksisterende tilgang og tillatelser for notatblokken.

    Screenshot showing where to manage permissions in workspace.

Kommentere en kodecelle

Kommentering er en annen nyttig funksjon for samarbeidsscenarioer. For øyeblikket støtter Fabric å legge til kommentarer på cellenivå.

  1. Velg Kommentarer-knappen på verktøylinjen eller cellekommentarindikatoren for å åpne Kommentarer-ruten.

    Screenshot showing where to select Comment.

  2. Velg kode i kodecellen, velg Ny i Kommentarer-ruten , legg til kommentarer, og velg deretter Legg inn kommentar for å lagre.

    Screenshot showing where to select New.

  3. Hvis du trenger dem, kan du finne alternativene Rediger kommentar, Løs tråd og Slett tråd ved å velge Alternativet Mer ved siden av kommentaren.

Bytt notatblokkmodus

Stoffnotatblokker støtter to moduser som du enkelt kan bytte mellom: Redigeringsmodus og Visningsmodus .

Screenshot showing where switch modes.

  • Redigeringsmodus: Du kan redigere og kjøre cellene og samarbeide med andre i notatblokken.
  • Visningsmodus: Du kan bare vise celleinnhold, utdata og kommentarer i notatblokken. Alle operasjoner som gjør endringer i notatblokken, deaktiveres.