Databricks Notebook-gränssnitt och kontroller

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

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

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

Celldesignen har uppdaterats

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

En uppdaterad celldesign är tillgänglig. Den här sidan innehåller information om hur du använder båda versionerna av celldesignen. En orientering till det nya användargränssnittet och svar på vanliga frågor finns i Orientering till det nya cellgränssnittet.

Om du vill aktivera eller inaktivera den nya celldesignen öppnar du sidan redigeringsinställningar på arbetsytan. I sidofältet klickar du på Utvecklare. Växla Nytt cellgränssnitt under Experimentella funktioner.

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 i text och grafik när cellen körs och kan användas för att dokumentera eller illustrera koden. Du kan lägga till eller ta bort celler i anteckningsboken för att strukturera ditt arbete.

Du kan köra en enskild cell, en grupp celler eller köra hela anteckningsboken samtidigt. En notebook-cell kan innehålla högst 10 MB. Utdata för notebook-celler är begränsade till 20 MB.

Ikoner och knappar i verktygsfältet Notebook

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

Icon	beskrivning
	Kör alla celler eller stoppa körningen. Namnet på den här knappen ändras beroende på anteckningsbokens tillstånd.
	Öppna beräkningsväljaren. När notebook-filen är ansluten till ett kluster eller SQL-lager visar den här knappen namnet på beräkningsresursen.
	Öppna jobbschemaläggaren.
	Öppna Delta Live Tables. Den här knappen visas bara om notebook-filen är en del av en Delta Live Tables-pipeline.
	Dialogrutan Öppna behörigheter.

Åtgärder för höger sidopanel

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

Icon	beskrivning
	Öppna kommentarer för notebook-filer.
	Öppna MLflow Notebook-experimentet.
	Öppna versionshistorik för notebook-filer.
	Ö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 notebook-filen, inklusive bibliotek med notebook-omfattning, klusterbibliotek och bibliotek som ingår i Databricks Runtime. Endast tillgängligt när notebook-filen är ansluten till ett kluster.

Bläddra bland data

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Om du vill utforska tabeller och volymer som är tillgängliga att använda i notebook-filen klickar du till vänster i anteckningsboken för att öppna schemawebbläsaren. Mer information finns i Bläddra bland data .

Menyn Cellåtgärder

Med menyn cellåtgärder kan du klippa ut och kopiera celler, flytta runt celler i anteckningsboken och dölja kod eller resultat. Menyn har ett annat utseende i det ursprungliga användargränssnittet och det nya användargränssnittet. Det här avsnittet innehåller instruktioner för båda versionerna.

Om Databricks Assistant är aktiverat på din arbetsyta kan du använda det i en kodcell för att få hjälp eller förslag på din kod. Om du vill öppna textrutan Databricks Assistant i en cell klickar du på ikonen Databricks Assistant i det övre högra hörnet av cellen.

Du kan enkelt ändra en cell mellan kod och markdown, eller ändra språket för en kodcell med hjälp av cellspråkknappen nära cellens övre högra hörn.

Menyn Cellåtgärder (ursprungligt användargränssnitt)

Från den här menyn kan du också köra kodceller:

Åtgärdsmenyn för cellen innehåller även knappar som gör att du kan dölja en cell eller ta bort en cell .

För Markdown-celler finns det också ett alternativ för att lägga till cellen på en instrumentpanel. Mer information finns i Instrumentpaneler i notebook-filer.

Arbeta med celler i det nya användargränssnittet

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 så att den blir enklare att redigera.

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

Om du vill köra kodceller i det nya användargränssnittet 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 körningens varaktighet. Hovra markören över meddelandet för mer information.

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 på menyn cellåtgärder. Mer information finns i Instrumentpaneler i notebook-filer.

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.

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.

Om du vill flytta upp eller ned en cell klickar du och håller utanför cellens övre vänstra hörn och drar cellen till den nya platsen. Du kan också välja Flytta upp eller Flytta ned från menyn cellåtgärder.

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:

Skapa en cell (ursprungligt användargränssnitt)

Om du vill skapa en ny cell i det ursprungliga användargränssnittet hovra över en cell överst eller längst ned och klicka på ikonen. Du kan också använda notebook-cellmenyn: klicka och välj Lägg till cell ovanför eller Lägg till cell nedan.

För en kodcell skriver du bara kod i cellen. Om du vill skapa en Markdown-cell väljer du Markdown från cellens språkknapp eller skriver %md längst upp i cellen.

Skapa en cell (nytt användargränssnitt)

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

Klipp ut, kopiera och klistra in celler

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

• På menyn cellåtgärder i det ursprungliga användargränssnittet eller det nya användargränssnittet väljer du Klipp ut cell eller Kopiera cell.
• Använd kortkommandon: Command-X eller Ctrl-X för att klippa ut och Command-C eller Ctrl-C 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 anteckningsboken, i en annan anteckningsbok eller i en anteckningsbok på 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 under den aktuella cellen.

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

Om du vill markera intilliggande celler klickar du i en Markdown-cell och använder sedan Skift + Upp eller Ned 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 väljer du Redigera > Markera alla celler eller använder kommandolägesgenvägen Cmd+A.

Notebook-innehållsförteckning

Om du vill visa en automatiskt genererad innehållsförteckning klickar du på ikonen längst upp till vänster i anteckningsboken (mellan det vänstra sidofältet och den översta cellen). Innehållsförteckningen genereras från markdown-rubrikerna som används i notebook-filen. Om du använder det nya användargränssnittet visas även celler med rubriker i innehållsförteckningen.

Visningsalternativ för cell

Det finns tre visningsalternativ för notebook-filer. Använd menyn Visa om du vill ändra visningsalternativet.

• Standardvy: resultaten visas omedelbart efter kodceller.
• Endast resultat: endast resultat visas.
• Sida vid sida: Kod- och resultatceller visas sida vid sida.

I det nya användargränssnittet är åtgärder tillgängliga från ikoner i cellrännan (området till höger och vänster om cellen). Om du till exempel vill flytta en cell uppåt eller nedåt använder du handtagspunkterna i den vänstra rännstenen. Om du vill ta bort en cell använder du papperskorgsikonen i den högra rännstenen.

För enklare redigering klickar du på fokuslägesikonen för att visa cellen med full bredd. Om du vill avsluta fokusläget klickar du på . Du kan också förstora den visade bredden på en cell genom att inaktivera Vycentrerad > layout.

Om du vill formatera alla celler i notebook-filen automatiskt till branschstandardlinjelängder och avstånd väljer du Redigera > anteckningsbok för format.

Rad- och kommandonummer

Om du vill visa eller dölja radnummer eller kommandonummer väljer du Radnummer eller Kommandonummer på Menyn Visa . För linjenummer kan du också använda kortkommandot Control+L.

Om du aktiverar rad- eller kommandonummer sparar Databricks dina inställningar och visar dem i alla dina andra notebook-filer för webbläsaren.

Rad- och kommandonummer (ursprungligt användargränssnitt)

Kommandonummer ovanför celler länkar till det specifika kommandot. Om du klickar på kommandonumret för en cell uppdateras url:en så att den fästs vid kommandot. Om du vill hämta en URL-länk till ett specifikt kommando i anteckningsboken högerklickar du på kommandonumret och väljer Kopiera länkadress.

Rad- och kommandonummer (nytt användargränssnitt)

Radnummer är inaktiverade som standard i det nya användargränssnittet. Om du vill aktivera dem väljer du Visa > radnummer. När en cell är i ett feltillstånd visas radnummer oavsett markering.

Om du vill växla kommandonummer väljer du Visa > kommandonummer.

Det nya användargränssnittet innehåller inte länkar till cellkommandonummer. Om du vill hämta en URL-länk till ett specifikt kommando i anteckningsboken klickar du för att öppna fokusläget och kopierar URL:en från webbläsarens adressfält. Om du vill avsluta fokusläget klickar du på .

Lägg till en cellrubrik

Om du vill lägga till en rubrik i en cell med det ursprungliga användargränssnittet väljer du Visa rubrik på menyn cellåtgärder.

Om du vill lägga till en rubrik i en cell med hjälp av det nya användargränssnittet gör du något av följande:

• Klicka på cellnumret som visas i mitten av cellens överkant och skriv rubriken.
• Välj Lägg till rubrik på menyn cellåtgärder.

Med det nya användargränssnittet visas celler som har rubriker i anteckningsbokens innehållsförteckning.

Visa notebook-filer i mörkt läge

Du kan välja att visa anteckningsböcker i mörkt läge. Om du vill aktivera eller inaktivera mörkt läge väljer du Visa > tema och väljer Ljust tema eller Mörkt tema.

Dölj och visa cellinnehåll

Cellinnehållet består av cellkod och de resultat som genereras genom att köra cellen. Du kan dölja och visa cellkoden och resultatet med hjälp av menyn cellåtgärder längst upp till höger i cellen.

Relaterade funktioner finns i Komprimerbara rubriker.

Dölj och visa cellinnehåll (ursprungligt användargränssnitt)

Om du vill dölja cellkod eller resultat klickar du på och väljer Dölj kod eller Dölj resultat. Du kan också välja att endast visa den första raden i en cell.

Om du vill visa dold cellkod eller resultat klickar du på Visa länkar:

Dölj och visa cellinnehåll (nytt användargränssnitt)

Om du vill dölja cellkod eller resultat klickar du på menyn för kebab längst upp till höger i cellen och väljer Dölj kod eller Dölj resultat. Du kan också välja Dölj cell om du bara vill visa den första raden i en cell. Om du vill expandera en komprimerad cell väljer du Expandera cell.

Om du vill visa dold cellkod eller resultat klickar du på visningsikonen: .

Komprimerbara rubriker

Celler som visas efter celler som innehåller Markdown-rubriker kan komprimeras till rubrikcellen. Om du vill expandera eller dölja celler efter celler som innehåller Markdown-rubriker i hela anteckningsboken väljer du Dölj alla rubriker på menyn Visa . Resten av det här avsnittet beskriver hur du expanderar eller döljer en delmängd celler.

Relaterade funktioner finns i Dölj och visa cellinnehåll.

Expandera och dölj rubriker (ursprungligt användargränssnitt)

Bilden visar en MLflow-konfiguration på nivå två med följande två celler komprimerade i den.

Om du vill expandera och komprimera rubriker klickar du på + och -.

Expandera och dölj rubriker (nytt användargränssnitt)

Bilden visar en MLflow-konfiguration på nivå två med följande två celler komprimerade i den.

Om du vill expandera och komprimera rubriker hovrar du markören över Markdown-cellen. Klicka på pilen som visas till vänster om cellen.

Beräkningsresurser för notebook-filer

Det här avsnittet beskriver alternativen för beräkningsresurser för notebook-filer. Du kan köra en notebook-fil i ett Databricks-kluster, eller för SQL-kommandon har du också möjlighet att använda ett SQL-lager, en typ av beräkning som är optimerad för SQL-analys.

Koppla en notebook-fil till ett kluster

Om du vill koppla en notebook-fil till ett kluster behöver du behörigheten KAN KOPPLA TILL klusternivå.

Viktigt!

Så länge en notebook-fil är ansluten till ett kluster har alla användare med behörigheten CAN RUN i notebook-filen implicit behörighet att komma åt klustret.

Om du vill koppla en notebook-fil till ett kluster klickar du på beräkningsväljaren i notebook-verktygsfältet och väljer ett kluster i listrutan.

Menyn visar ett urval av kluster som du nyligen har använt eller som för närvarande körs.

Om du vill välja från alla tillgängliga kluster klickar du på Mer.... Klicka på klusternamnet för att visa en nedrullningsbara meny och välj ett befintligt kluster.

Du kan också skapa ett nytt kluster genom att välja Skapa ny resurs... på den nedrullningsbara menyn.

Viktigt!

En bifogad notebook-fil har följande Apache Spark-variabler definierade.

Klass	Variabelnamn
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession (Spark 2.x)	spark

Skapa inte en SparkSession, SparkContext, eller SQLContext. Detta leder till inkonsekvent beteende.

Använda en notebook-fil med ett SQL-lager

När en notebook-fil är ansluten till ett SQL-lager kan du köra SQL- och Markdown-celler. Om du kör en cell på något annat språk (till exempel Python eller R) genereras ett fel. SQL-celler som körs på ett SQL-lager visas i SQL-lagrets frågehistorik. Användaren som körde en fråga kan visa frågeprofilen från notebook-filen genom att klicka på den förflutna tiden längst ned i utdata.

För att köra en notebook-fil krävs ett Pro- eller Serverlöst SQL-lager. Du måste ha åtkomst till arbetsytan och SQL-lagret.

Widgetar fungerar annorlunda när en notebook-fil är kopplad till ett SQL-lager. Mer information finns i Använda Databricks-widgetar i ett SQL-lager.

Så här kopplar du en notebook-fil till ett SQL-lager :

1. Klicka på beräkningsväljaren i notebook-verktygsfältet. Den nedrullningsbara menyn visar beräkningsresurser som för närvarande körs eller som du har använt nyligen. SQL-lager markeras med .

2. Välj ett SQL-lager på menyn.

   Om du vill se alla tillgängliga SQL-lager väljer du Mer... på den nedrullningsbara menyn. En dialogruta visas som visar beräkningsresurser som är tillgängliga för notebook-filen. Välj SQL Warehouse, välj det lager som du vill använda och klicka på Bifoga.

   

Du kan också välja ett SQL-lager som beräkningsresurs för en SQL-notebook-fil när du skapar ett arbetsflöde eller ett schemalagt jobb.

Begränsningar i SQL-lager inkluderar:

• När de är anslutna till ett SQL-lager har körningskontexter en tidsgräns för inaktivitet på 8 timmar.
• Maximal storlek för returnerade resultat är 10 000 rader eller 2 MB, beroende på vilket som är mindre.

Koppla från en notebook-fil

Om du vill koppla från en notebook-fil från en beräkningsresurs klickar du på beräkningsväljaren i notebook-verktygsfältet och hovra över det anslutna klustret eller SQL-lagret i listan för att visa en sidomeny. På sidomenyn väljer du Koppla från.

Du kan också koppla från notebook-filer från ett kluster med hjälp av fliken Notebook-filer på klusterinformationssidan.

När du kopplar från en notebook-fil tas körningskontexten bort och alla beräknade variabelvärden rensas från notebook-filen.

Dricks

Azure Databricks rekommenderar att du kopplar från oanvända notebook-filer från kluster. Detta frigör minne på drivrutinen.

Använda webbterminalen och Databricks CLI

Om du vill öppna webbterminalen i en notebook-fil klickar du längst ned i det högra sidofältet.

Använda Databricks CLI i en webbterminal

Från och med Databricks Runtime 15.0 kan du använda Databricks CLI från webbterminalen i notebook-filen.

Krav

• Anteckningsboken måste vara ansluten till ett kluster i läget Enskild användare eller Ingen isolering för delad åtkomst.
• CLI är inte tillgängligt på arbetsytor som är aktiverade för Private Link.

Det installerade CLI:et är alltid den senaste versionen. Autentiseringen baseras på den aktuella användaren.

Du kan inte använda CLI från en notebook-cell. Kommandon som %sh databricks ... i en notebook-fil fungerar inte med Databricks Runtime 15.0 eller senare.