Navigera i Databricks-anteckningsboken och filredigeraren

Den här artikeln beskriver de funktioner som är tillgängliga för att hjälpa dig att navigera i Databricks Notebook och filredigeraren, inklusive kortkommandon, kodförslag och automatisk komplettering, variabel inspektion och koddelegering. När du använder notebook-filen eller filredigeraren är Databricks Assistant tillgängligt för att hjälpa dig att generera, förklara och felsöka kod. Mer information finns i Få kodningshjälp från Databricks Assistant.

Du kan välja mellan ett urval av redigeringsteman. Välj Visa > redigerartema och gör ett val från menyn.

Kommandopalett

Du kan snabbt utföra åtgärder i notebook-filen med hjälp av kommandopaletten. Om du vill öppna en panel med notebook-åtgärder klickar du på I det nedre högra hörnet på arbetsytan eller använder du genvägen Cmd + Skift + P på MacOS eller Ctrl + Skift + P i Windows.

Minikarta för cellkörning

Om du vill få en visuell översikt över körningsstatusen för notebook-filen använder du minikartan för cellkörning. Minikartan visas i högermarginalen och visar ett statusfält för varje körbar cell.

Statusstaplar anger följande körningstillstånd:

• Ljusgrå: Cellen är statisk.
• Mörkgrå: Cellen hoppas över eller placeras i kö för körning.
• Ljusgrå med rörligt fält: Cellen körs för närvarande.
• Grön: Cellen kördes utan fel.
• Röd: Cellen misslyckades med ett fel.

Så här interagerar du med minikartan:

• Hovra över minikartan för att se en lista över körbara celler, deras rubriker och deras körningstillstånd.
• Klicka på en post för att gå direkt till cellen i notebook-filen.
• Klicka på Gå till sista körningscellen eller Gå till cellen som först misslyckades för att navigera till den senaste körningen eller den första misslyckade cellen.

Minikartan hjälper dig att snabbt spåra körningsförloppet och snabbt navigera vid felsökning eller utveckling.

Sök efter och ersätt text

Om du vill hitta och ersätta text i en notebook-fil använder du kortkommandot ( Cmd + F Mac) eller Ctrl + F(Windows) eller klickar på Redigera > sök... för att öppna dialogrutan Sök . Ange den text som du vill hitta. Den aktuella matchningen är markerad i orange och alla andra matchningar är markerade i gult. Om du vill komma åt den interna webbläsarsökningen trycker du på Cmd + F (Mac) eller Ctrl + F(Windows) igen.

Klicka på Öppna alternativet Ersätt . Ange den text som du vill använda i stället. Om du vill ersätta den aktuella matchningen klickar du på Ersätt. Om du vill ersätta alla matchningar i anteckningsboken klickar du på Ersätt alla.

Om du vill flytta mellan matchningar klickar du på (föregående matchning) eller (nästa matchning). Du kan också trycka på Shift + Enter och Enter gå till föregående respektive nästa matchningar.

Stäng verktyget sök och ersätt genom att klicka på Eller tryck på esc.

Variabelkontroll

Om du vill visa information om en variabel som definierats i en SQL- eller Python-notebook-fil hovra markören över variabelnamnet. Python-variabelinspektion kräver Databricks Runtime 12.2 LTS eller senare.

Se Variabelutforskare.

Gå till definition

När en Python-notebook-fil är kopplad till en beräkningsresurs kan du snabbt gå till definitionen av en variabel, funktion eller koden bakom en %run -instruktion. Det gör du genom att högerklicka på variabeln eller funktionsnamnet och sedan klicka på Gå till definition eller Granska definition.

Håll ned cmd-tangenten på macOS eller Ctrl-tangenten i Windows och hovra över variabeln eller funktionsnamnet. Om en definition hittas omvandlas namnet till en hyperlänk.

Funktionen "Gå till definition" är tillgänglig i Databricks Runtime 12.2 LTS och senare.

Koddelegering

Med koddelegering kan du tillfälligt dölja kodavsnitt. Detta kan vara användbart när du arbetar med långa kodblock eftersom du kan fokusera på specifika kodavsnitt som du arbetar med.

Om du vill dölja kod placerar du markören längst till vänster i en cell. Nedåtriktade pilar visas vid logiska punkter där du kan dölja ett kodavsnitt. Klicka på pilen för att dölja ett kodavsnitt. Klicka på pilen igen (pekar nu till höger) för att visa koden.

Mer information, inklusive kortkommandon, finns i VS Code-dokumentationen.

Stöd för Multicursor

Du kan skapa flera markörer för att göra samtidiga redigeringar enklare, som du ser i videon:

Så här skapar du flera markörer i en cell:

• På macOS håller du ned Option nyckeln och klickar på varje plats för att lägga till en markör.
• I Windows håller du ned Alt nyckeln och klickar på varje plats för att lägga till en markör.
• Du kan också ändra genvägen. Se Ändra genväg för val av multicursor och kolumn.

På macOS kan du skapa flera lodrätt justerade markörer med hjälp av kortkommandot Option+Command+ uppåt- eller nedåtpilen.

Kolumnmarkering (ruta)

Om du vill markera flera objekt i en kolumn klickar du längst upp till vänster i det område som du vill avbilda. Then:

• På macOS trycker Shift + Option du på och drar till den nedre högra för att samla in en eller flera kolumner.
• I Windows trycker Shift + Alt du på och drar till det nedre högra hörnet för att avbilda en eller flera kolumner.
• Du kan också ändra genvägen. Se Ändra genväg för val av multicursor och kolumn.

Ändra genväg för val av multicursor och kolumn

Det finns en alternativ genväg för val av multicursor och kolumn (ruta). Med den alternativa markeringen ändras genvägarna på följande sätt:

• Så här skapar du flera markörer i en cell:
  • På macOS håller du ned Cmd nyckeln och klickar på varje plats för att lägga till en markör.
  • I Windows håller du ned Ctrl nyckeln och klickar på varje plats för att lägga till en markör.
• Om du vill markera flera objekt i en kolumn klickar du längst upp till vänster i det område som du vill avbilda. Then:
  • På macOS trycker Option du på och drar till den nedre högra för att samla in en eller flera kolumner.
  • I Windows trycker Alt du på och drar till det nedre högra hörnet för att avbilda en eller flera kolumner.

Gör följande för att aktivera de alternativa genvägarna:

1. Klicka på ditt användarnamn längst upp till höger på arbetsytan och klicka sedan på Inställningar i listrutan.
2. I sidofältet Inställningar väljer du Utvecklare.
3. I avsnittet Kodredigeraren ändrar du inställningen Nyckelmodifierare för flera markörer till Cmd för macOS eller Ctrl för Windows.

När du aktiverar alternativa genvägar ändras inte kortkommandot för att skapa flera lodrätt justerade markörer.

Bläddra bland data

Använd schemawebbläsaren för att utforska Unity Catalog-objekt som är tillgängliga för notebook-filen. Klicka på Öppna schemawebbläsaren till vänster i anteckningsboken.

Knappen För dig visar bara de objekt som du har använt i den aktuella sessionen eller som tidigare markerats som en favorit.

När du skriver text i rutan Filter ändras visningsrutan så att endast de objekt som innehåller den text som du skriver visas. Endast objekt som för närvarande är öppna eller har öppnats i den aktuella sessionen visas. Filtret gör inte en fullständig sökning av kataloger, scheman, tabeller och volymer som är tillgängliga för notebooken.

Om du vill öppna Kebab-menyn hovra markören över objektets namn enligt följande:

Om objektet är en tabell kan du göra följande:

• Skapa och kör en cell automatiskt för att visa en förhandsgranskning av data i tabellen. Välj förhandsversion i en ny cell från menyn för kebab i tabellen.
• Visa en katalog, ett schema eller en tabell i Katalogutforskaren. Välj Öppna i Katalogutforskaren från menyn för kebab. En ny flik öppnas som visar det markerade objektet.
• Hämta sökvägen till en katalog, ett schema eller en tabell. Välj Kopiera ... sökväg från kebabmenyn för objektet.
• Lägg till en tabell i Favoriter. Välj Lägg till i favoriter från kebabmenyn för tabellen.

Om objektet är en katalog, ett schema eller en volym kan du kopiera objektets sökväg eller öppna den i Katalogutforskaren.

Infoga ett tabell- eller kolumnnamn direkt i en cell:

1. Klicka på markören i cellen på den plats där du vill ange namnet.
2. Flytta markören över tabellnamnet eller kolumnnamnet i schemawebbläsaren.
3. Klicka på som visas till höger om objektets namn.

Använda webbterminalen och Databricks CLI

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

I Databricks Runtime 15.0 och senare kan du använda Databricks CLI från webbterminalen i en notebook. Mer information om krav och användning finns i Köra gränssnittskommandon i Azure Databricks-webbterminalen .

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

Anpassad automatisk komplettering

Automatisk komplettering slutför automatiskt kodsegment när du skriver dem. Slutförbara objekt omfattar typer, klasser och objekt, samt SQL-databas, tabellnamn, structs, kartor, matriser och frågefragment. När du refererar till vanliga tabelluttryck (CTE: er) som använder SELECT *, ger automatisk komplettering kolumnrekommendationer baserat på den underliggande tabellstrukturen. Databricks använder metadata och användning för Unity Catalog för att anpassa förslag.

• För Python-celler måste notebook-filen kopplas till en beräkningsresurs för att automatisk komplettering ska fungera och du måste köra alla celler som definierar slutförbara objekt.
• För SQL-celler föreslår autokomplettering nyckelord och grundläggande syntax, även om notebook-filen inte är kopplad till någon beräkningsresurs.
  • Om arbetsytan är aktiverad för Unity Catalog föreslår automatisk komplettering även katalog-, schema-, tabell- och kolumnnamn för tabeller i Unity Catalog.
  • Om arbetsytan inte är aktiverad för Unity Catalog måste anteckningsboken kopplas till en beräkningsresurs för all användning eller ett SQL-lager för att föreslå tabell- eller kolumnnamn.

Förslag för automatisk komplettering visas automatiskt när du skriver in en cell. Använd upp- och nedpilarna eller musen för att välja ett förslag och tryck på Tabb eller Retur för att infoga markeringen i cellen.

Automatisk komplettering är aktiverat som standard men kan inaktiveras i användarinställningarna:

• Om du vill inaktivera förslag för automatisk komplettering kan du växla Komplettera automatiskt när du skriver. När automatisk komplettering är av kan du visa förslag för automatisk komplettering genom att trycka på Ctrl + Blanksteg.
• För att förhindra att Retur infogar förslag för automatisk komplettering, växla alternativet Returtangenten accepterar förslag för automatisk komplettering.

Matchning av hakparentes

När du klickar nära en parentes, hakparentes eller klammerparentes markerar redigeraren det tecknet och dess matchande hakparentes.

Python-felmarkering

Arbetsytor med partnerdrivna AI-funktioner aktiverade kan också välja Åtgärda med Assistent för AI-assisterade förslag.

Databricks-notebookar stöder följande markering av fel:

• Python-syntaxfelmarkering: Alla syntaxfel i Python-kodceller är markerade i rött. Om möjligt föreslår assistenten en snabbkorrigering åt dig. Detta stöds för beräkning som kör Databricks Runtime 12.1 och senare eller serverlös beräkning. Du kan konfigurera syntaxfelmarkering med pyproject.toml filer. Se Konfigurera Python-syntaxbelysning.
• Fel vid markering av Python-format: Python-kodformateringsfel och varningar är understrukna i gult eller rött, beroende på allvarlighetsgrad. Detta kan hjälpa dig att identifiera formateringsproblem som oväntad indrag, lång linjelängd med mera. Hovra över syntaxvarningarna för att se mer information. Detta stöds för beräkning som kör Databricks Runtime 12.1 och senare eller serverlös beräkning.
• Felmarkering av Python-typ: Typkontroll kan förbättra kodkvaliteten, läsbarheten och underhållsbarheten i Python- och PySpark-projekt. Typkontroller kan flagga fel relaterade till icke-existerande attribut, argument som saknas och felmatchade argument i funktionsanrop före kodkörning. Hovra över de markerade varningarna om du vill se mer information. Detta stöds för beräkning som kör Databricks Runtime 16.0 och senare eller serverlös miljö 2.

Aktivera Python-felmarkering

Gör följande för att aktivera eller inaktivera felmarkering:

1. Klicka på ditt användarnamn längst upp till höger på arbetsytan och klicka sedan på Inställningar i listrutan.
2. I sidofältet Inställningar väljer du Utvecklare.
3. Växla inställningen för Python-syntaxfelmarkering (under Kodredigeraren), Python-formatfelmarkering (under Experimentella funktioner) och/eller Python-typfelmarkering (under Experimentella funktioner).

Konfigurera markering av Python-syntax

När en notebook-fil är ansluten till beräkning som kör Databricks Runtime 16.4 eller senare, eller i version 3 eller senare av den serverlösa miljön, kan du anpassa beteendet för syntaxmarkering genom att skapa en pyproject.toml fil. För en viss notebook-fil används den närmaste pyproject.toml filen i dess direkta överordnade sökväg i arbetsytans filsystem. Om det inte går att hitta en i den överordnade sökvägen används en pyproject.toml fil från den aktuella användarens hemmamapp.

Om du till exempel har en anteckningsbok med sökvägen a/b/c/d/notebook.py och det finns pyproject.toml filer på a/b/pyproject.toml och a/b/c/pyproject.toml, så kommer den andra att användas eftersom den är närmare. En pyproject.toml fil på /a/b/c/e/pyproject.toml skulle inte anses eftersom den inte finns i den direkta stamvägen.

Azure Databricks använder standardsyntax för pyproject.toml filer. Du kan till exempel läsa Ruff-dokumentationen för att se hur du konfigurerar Ruff-lintern med en pyproject.toml fil.

För närvarande har Azure Databricks endast stöd för att konfigurera ruff, pylint, pyright och flake8 för linting via pyproject.toml.

För att aktivera en linter pyproject.toml måste filen ha ett [tool.<name-of-linter>] block.

Om du uttryckligen vill inaktivera en linter lägger du till följande block:

[tool.<name-of-linter>]
disabled=true

Du kan också inaktivera Azure Databricks-skrivna syntaxmarkeringsregler med ett block som:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Eftersom Flake8 förväntar sig en konfiguration i ett annat format måste du skicka konfigurationen för Flake8 som en sträng:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Anpassa SQL-formatering

Du kan anpassa inställningarna för SQL-formatering i den nya SQL-redigeraren och notebook-redigeraren. Klicka på Visa > inställningar för utvecklare. Rulla ned till SQL-format och ange dina inställningar.

Använda kortkommandon

Om du vill visa kortkommandon väljer du Hjälp > Kortkommandon. Vilka kortkommandon som är tillgängliga beror på om markören finns i en kodcell (redigeringsläge) eller inte (kommandoläge).

Tabellerna nedan visar tillgängliga kortkommandon.

Genvägar till redigeringsläge

Genvägar till kommandoläge

Delade genvägar