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

Om du vill skapa en ny notebook-fil klickar du på knappen Ny i arbetsytans sidofält eller Skapa en anteckningsbok i valfri mapp.

Öppna en anteckningsfil

Om du vill öppna en anteckningsbok använder du sökfunktionen i arbetsytan Search eller använder arbetsytans webbläsare för att navigera till anteckningsboken och klickar på anteckningsbokens namn eller ikon.

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.

Du kan köra en enskild cell, en grupp celler eller hela notebook-filen. En notebook-cell kan innehålla högst 10 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.

verktygsfält för Notebook

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:

Ikon	Beskrivning
	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 DLT. Den här knappen visas bara om anteckningsboken är en del av en DLT-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:

Ikon	Beskrivning
	Ö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. 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

Med menyn cellåtgärder kan du köra, klippa ut och kopiera celler, flytta runt celler i anteckningsboken och dölja kod eller resultat.

Köra en cell

Om du vill köra kodceller klickar du på nedåtpilen längst upp till vänster i kodcellen.

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 avsnittet "Senast uppdaterad" i användargränssnittet.

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. Ett fel stoppar körningen och du kan inte 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.

Databricks Assistant: Aktivera eller inaktivera Databricks Assistant för kodförslag i cellen.

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, klicka och håll 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å .

Öppna Databricks Assistant

Om du vill öppna textrutan Databricks Assistant i en cell klickar du på ikonen Databricks Assistant i cellens övre högra hörn.

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.