Grundläggande redigering i Databricks-notebook-filer

En Databricks-notebook-fil är en webbaserad kodredigerare som gör att du kan skriva kod och visa resultat för interaktiv dataanalys. Den här sidan beskriver grunderna i att använda notebook-filer i Databricks, inklusive hur du navigerar i verktygsfältet och utför olika cellåtgärder.

Skapa en anteckningsbok

Du kan skapa en ny notebook-fil på flera sätt:

• Använd knappen Nytt i sidopanelen
• Skapa en notebook i valfri mapp
• Skapa en notebook-fil på en ny flik

Öppna en anteckningsfil

Om du vill öppna en notebook-fil använder du funktionen Sök på arbetsytan eller använder arbetsytans webbläsare för att navigera till anteckningsboken och klickar på anteckningsbokens namn eller ikon.

Om du har flikar för notebook-filer och filer aktiverade kan du öppna en anteckningsbok på en ny flik.

Redigera anteckningsböcker sida vid sida

Om du vill visa och redigera anteckningsböcker sida vid sida klickar du på Om du vill lägga till en delad vy över den aktuella anteckningsboken. Du kan också dra en anteckningsboksflik och släppa den till höger för att redigera anteckningsböcker sida vid sida.

.

Notebook-celler

Notebook-filer innehåller en samling med två typer av celler: kodceller och Markdown-celler. Kodceller innehåller runnbar kod. Markdown-celler innehåller Markdown-kod som återges som text och grafik. Använd Markdown för att dokumentera eller illustrera koden. Du kan lägga till eller ta bort celler av någon av typerna i anteckningsboken för att strukturera ditt arbete. En notebook-fil kan innehålla upp till 10 000 celler.

Du kan köra en enskild cell, en grupp celler eller hela notebook-filen. En notebook-cell kan innehålla högst 6 MB och dess utdata är begränsade till 20 MB.

Verktygsfältsikoner och knappar i notebook-miljön

Verktygsfältet innehåller menyer och ikoner som du kan använda för att hantera och redigera anteckningsboken.

Bredvid notebook-namnet finns knappar för att ändra standardspråket för notebook-filen och om notebook-filen ingår i en Databricks Git-mapp öppna git-dialogrutan.

Om du vill visa tidigare versioner av anteckningsboken klickar du på "Senaste redigering..." meddelande till höger om menyerna.

Ikonerna och knapparna till höger i verktygsfältet beskrivs i följande tabell:

Icon	Description
	Kör alla celler eller stoppa utförandet. Namnet på den här knappen ändras beroende på anteckningsbokens tillstånd.
	Öppna beräkningsväljare. När notebook-filen är ansluten till ett kluster eller SQL-lager visar den här knappen namnet på beräkningsresursen.
	Öppna jobbhanteraren.
	Öppna Lakeflow Deklarativa Pipelines. Den här knappen visas bara om anteckningsboken är en del av en pipeline.
	** Öppna dialogrutan för behörigheter .

Åtgärder för den högra sidofältet

Flera åtgärder är tillgängliga från anteckningsbokens högra sidofält, enligt beskrivningen i följande tabell:

Icon	Description
	Öppna anteckningsboks kommentarer.
	Öppna MLflow-anteckningsboksexperiment.
	Öppna notebook-versionshistorik.
	Öppna variabelutforskaren. (Tillgängligt för Python-variabler med Databricks Runtime 12.2 LTS och senare.)
	Öppna Python-miljöpanelen. Den här panelen visar alla Python-bibliotek som är tillgängliga för notebooken, inklusive notebook-specifika bibliotek, bibliotek för kluster och bibliotek som ingår i Databricks Runtime. Endast tillgängligt när notebooken är ansluten till ett kluster.

Skapa celler

Notebook-filer har två typer av celler: kod och Markdown.

Om du vill skapa en ny cell hovra över en cell överst eller längst ned. Klicka på + Kod eller + Text för att skapa en kod eller Markdown-cell.

Som standardinställning förutsätter en kodcell kodspråket som anges i din notebook, vilket specificeras överst på sidan. Om du vill blanda språk kan du ange ett annat språk för en cell. Se Ange standardspråk.

Innehållet i Markdown-celler återges i HTML. Det här kodfragmentet innehåller till exempel markering för en rubrik på nivå ett:

%md ### Libraries
Import the necessary libraries.

Renderas enligt följande:

Om du vill skapa en ny cell hovra över en cell överst eller längst ned. Klicka på Code eller Text för att skapa en kod eller Markdown-cell.

Cellåtgärder

Du kan utföra olika åtgärder på en cell. På cellkörningsmenyn kan du välja om du vill köra en cell, alla celler ovanför den eller alla celler under den. Det finns cellikoner som gör att du snabbt kan ändra kodningsspråket, ta bort en cell och komma åt assistenten. Med menyn cellåtgärder kan du klippa ut och kopiera celler, flytta runt celler i anteckningsboken och dölja kod eller resultat i en cell.

Köra en cell

Om du vill köra en kodcell klickar du på högerpilen längst upp till vänster i cellen. Om du vill komma åt cellkörningsmenyn klickar du på nedåtpilen bredvid den och väljer kontexten för att köra cellen.

När en cell har körts visas ett meddelande till höger om cellkörningsmenyn som visar den senaste gången cellen kördes och dess varaktighet. Hovra markören över meddelandet för mer information.

Om du vill visa detaljerad körningsinformation som standard klickar du på profilbilden längst upp till höger. Klicka sedan på Inställningar>Developer>Visa detaljerad kommandokörningsinformation.

Om du har ett tabellresultat kan du också komma åt den här informationen genom att hovra över texten "Senast uppdaterad" i tabellens nedre högra hörn.

Köra markerade celler

Du kan köra en enskild cell eller en samling celler. Om du vill markera en enskild cell klickar du var som helst i cellen. Om du vill markera flera celler håller du ned Command på MacOS eller Ctrl-tangenten i Windows och klickar på cellen utanför textområdet enligt skärmbilden.

Om du vill köra de markerade cellerna klickar du på Kör>Kör och felsök>Kör markerade celler eller använder kortkommandot Command + Enter på MacOS eller Crtl + Enter i Windows. Beteendet för det här kommandot beror på den beräkningsresurs som anteckningsboken är kopplad till.

• På en beräkningsresurs som kör Databricks Runtime 13.3 LTS eller tidigare körs de markerade cellerna individuellt. Om ett fel uppstår i en cell, fortsätter utförandet med de efterföljande cellerna.
• På en beräkningsresurs som kör Databricks Runtime 14.0 eller senare, eller på ett SQL-lager, körs markerade celler som en batch. Varje fel stoppar körningen, och det går inte att avbryta körningen av enskilda celler. Du kan använda knappen Avbryt för att stoppa körningen av alla celler.

Kör markerad text

Du kan markera kod- eller SQL-uttryck i en notebook-cell och bara köra den markerade koden. Detta är användbart när du snabbt vill iterera kod och frågor.

1. Markera de rader som du vill köra.

2. Välj Kör > Kör markerad text eller använd kortkommandot Ctrl+Shift+Enter. Om ingen text är markerad kör Kör vald text den aktuella raden.

   

Om du använder blandade språk i en cellmåste du inkludera raden %<language> i markeringen.

Kör markerad text kör även hopfälld kod, om det finns någon i det markerade.

Särskilda cellkommandon som %run, %pipoch %sh stöds.

Du kan inte använda Kör markerad text på celler som har flera utdataflikar (dvs. celler där du har definierat en dataprofil eller visualisering).

Cellikoner

Följande skärmbild beskriver ikonerna som visas längst upp till höger i en notebook-cell:

Språkväljare: Välj cellens språk.

Ta bort cell: Ta bort cellen.

Databricks Assistant: Växla mellan att öppna och stänga Databricks Assistant direkt i kodcellen. Du kan ange en uppmaning till assistenten som hjälper dig att generera kod.

Cellfokus: Förstora cellen för att göra redigeringen enklare.

Visa menyn för cellåtgärder: Öppna menyn för cellåtgärder. Alternativen i den här menyn skiljer sig något åt för kod- och Markdown-celler.

Ta bort en cell

Om du vill ta bort en cell klickar du på papperskorgsikonen till höger om cellen. Den här ikonen visas bara när du hovrar markören över cellen.

Flytta en cell

Om du vill flytta upp eller ned en cell klickar du på och håller ned drahandtagsikonen till vänster om cellen.

Du kan också välja Flytta upp eller Flytta ned från menyn cellåtgärder.

Klipp ut, kopiera och klistra in celler

Det finns flera alternativ för att klippa ut och kopiera celler. Men om du använder Webbläsaren Safari är det bara kortkommandona som är tillgängliga.

• På menyn cellåtgärder väljer du Klipp ut cellen eller Kopiera cell.
• Använd kortkommandon: Command-X eller Ctrl-X för att klippa ut och Command-C eller Ctrl-C att kopiera.
• Använd menyn Redigera överst i anteckningsboken. Välj Klipp ut eller Kopiera.

När du har klippt ut eller kopierat celler kan du klistra in cellerna någon annanstans i notebook-filen, i en annan anteckningsbok eller i en annan webbläsarflik eller ett annat fönster. Om du vill klistra in celler använder du kortkommandot Command-V eller Ctrl-V. Cellerna klistras in nedanför den aktuella cellen.

Om du vill ångra åtgärder för klipp ut eller klistra in kan du använda kortkommandot Command-Z eller Ctrl-Z eller menyalternativen Redigera > Ångra klippta celler eller Redigera > Ångra inklistringsceller.

Om du vill markera intilliggande celler klickar du i en Markdown-cell och använder sedan Skift + Upp eller Nedåt för att markera cellerna ovanför eller under den. Använd redigeringsmenyn för att kopiera, klippa ut, klistra in eller ta bort de markerade cellerna som en grupp. Om du vill markera alla celler markerar du Redigera > Markera alla celler eller använder kommandolägesgenvägen Cmd+A.

Lägga till kodkommentar

Om du vill lägga till en kommentar i koden i en cell markerar du koden. Till höger om cellen visas en kommentarsikon. Klicka på ikonen för att öppna kommentarsrutan.

Lägga till en cell på en instrumentpanel

Om du vill lägga till en Markdown-cell eller en cell som har tabellresultat på en instrumentpanel väljer du Lägg till på instrumentpanelen från menyn cellåtgärder. Mer information finns i instrumentpaneler för notebooks.

Länka till en cell

Om du vill hämta en URL-länk till ett specifikt kommando i anteckningsboken klickar du på ikonen för att öppna fokusläget och kopiera URL:en från webbläsarens adressfält. Om du vill avsluta fokusläget klickar du på .

Om du vill hämta en URL-länk till ett specifikt kommando i anteckningsboken klickar du på Öppna fokusläget och kopiera URL:en från webbläsarens adressfält. Om du vill avsluta fokusläget klickar du på .

Öppna Databricks Assistant

Om du vill öppna en textruta för Databricks Assistant i en cell klickar du på Databricks Assistant-ikonen i det övre högra hörnet av cellen.

Du kan använda den i en kodcell för att få hjälp eller förslag på din kod. Databricks Assistant måste vara aktiverat på din arbetsyta.