Del via


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.

Sikkerhetskontekst for å kjøre notatblokk

Utførelsen av en notatblokk kan utløses av tre forskjellige manerer i Fabric med full fleksibilitet til å møte ulike scenarier:

  • Interaktiv kjøring: Brukeren utløser kjøringen manuelt via de ulike UX-oppføringene eller kaller rest-API-en. Kjøringen kjører under den gjeldende brukerens sikkerhetskontekst.
  • Kjør som datasamlebåndaktivitet: Kjøringen utløses fra Fabric Data Factory pipeline. Du finner detaljtrinnene i notatblokkaktiviteten. Kjøringen kjører under pipelineeierens sikkerhetskontekst.
  • Planlegger: Kjøringen utløses fra en planleggerplan. Kjøringen kjører under sikkerhetskonteksten til brukeren som konfigurerer/oppdaterer planleggerplanen.

Fleksibiliteten til disse utførelsesalternativene med forskjellig sikkerhetskontekst gjør at du kan oppfylle ulike scenarier og krav, men krever også at du er oppmerksom på sikkerhetskonteksten når du utformer og utvikler notatblokken, ellers kan det føre til uventet atferd og til og med noen sikkerhetsproblemer.

Første gang en notatblokk opprettes, vises en advarsel for å minne deg på risikoen ved å kjøre koden uten å se gjennom den.

Skjermbilde som viser advarsel om kjøring av notatblokk.

Her er noen anbefalte fremgangsmåter for å unngå sikkerhetsproblemer:

  • Før du kjører notatblokken manuelt, åpner du notatblokkinnstillingen og kontrollerer detaljinndelingen under Om-panelet for endringsoppdateringen. Kontroller at du er OK med den siste endringen.
  • Før du legger til en notatblokkaktivitet i et datasamlebånd, åpner du notatblokkinnstillingen og kontrollerer detaljinndelingen under Om-panelet for endringsoppdateringen. Kontroller at du er OK med den nyeste endringen. Hvis du ikke er sikker på den siste endringen, bør du åpne notatblokken for å se gjennom endringen før du legger den til i datasamlebåndet.
  • Før du oppdaterer planleggerplanen, åpner du notatblokkinnstillingen og kontrollerer detaljinndelingen under Om-panelet for endringsoppdateringen. Kontroller at du har det bra med den siste endringen. Hvis du ikke er sikker på den siste endringen, bør du åpne notatblokken for å se gjennom endringen før du oppdaterer planleggerplanen.
  • Skill arbeidsområdet i ulike faser (utvikling, test, prod) og kontroller tilgangen til ulike faser for å unngå sikkerhetsproblemet. Legg bare til brukeren du stoler på, i prod-fasen.

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.

Skjermbilde som viser hvor du finner notatblokkalternativer på Ny-menyen.

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

Skjermbilde som viser hvor du eksporterer notatblokken.

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.

Skjermbilde som viser hvor du lagrer en kopi.

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.

Skjermbilde som viser hvor du bytter manuell lagring.

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.

Skjermbilde som viser hvor du fester et standard 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.

Skjermbilde som viser hurtigmenyen for filer i 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.

Animert GIF for notatblokkressurser.

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.

Skjermbilde som viser en kodecelle med en annen bruker som redigerer.

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.

    Skjermbilde som viser hvor du velger Del.

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

    Skjermbilde som viser hvor du velger tillatelser.

  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.

    Skjermbilde som viser hvor du oppretter og sender kobling.

  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.

    Skjermbilde som viser hvor du administrerer tillatelser i arbeidsområdet.

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.

    Skjermbilde som viser hvor du velger Kommentar.

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

    Skjermbilde som viser hvor du velger Ny.

  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.

Merke andre i en kommentar

«Merking» refererer til omtale og varsler en bruker i en kommentartråd, noe som forbedrer samarbeidet effektivt på detaljene.

  1. Velg en kodeinndeling i en celle og ny kommentartråd.

  2. Skriv inn brukernavnet, og velg det riktige i forslagslisten hvis du vil nevne noen for diskusjon om en bestemt inndeling.

  3. Del innsikten din og legg dem inn .

  4. Et e-postvarsel utløses, og brukeren klikker koblingen Åpne kommentarer for raskt å finne denne cellen.

  5. Videre kan du godkjenne og konfigurere tillatelsene for brukere når du merker noen som ikke har tilgang, slik at koderessursene dine er godt forvaltet.

Animert GIF for merking av andre i en kommentar.

Merk

For et kommentarelement vil ikke den merkede brukeren motta et e-postvarsel lenger hvis du oppdaterer kommentaren innen én time. Men det vil sende e-postvarsling til den nye merkede brukeren.

Bytt notatblokkmodus

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

Skjermbilde som viser hvor byttingsmoduser.

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