Navigeren in het Databricks-notebook en de bestandseditor

In dit artikel worden de functies beschreven die beschikbaar zijn om door de Databricks-notebook en bestandseditor te navigeren, waaronder sneltoetsen, codesuggesties en automatisch aanvullen, variabele inspectie en het vouwen van code. Wanneer u het notebook of de bestandseditor gebruikt, is Databricks Assistant beschikbaar om u te helpen code te genereren, uit te leggen en fouten op te sporen. Zie Hulp bij coderen van Databricks Assistant voor meer informatie.

U kunt kiezen uit een selectie editorthema's. Selecteer Weergave > Editor thema en maak een keuze uit het menu.

opdrachtpalet

U kunt snel acties uitvoeren in het notebook met behulp van het opdrachtenpalet. Als u een paneel met notitieblokacties wilt openen, klikt u op het pictogram van het opdrachtpalet in de rechterbenedenhoek van de werkruimte of gebruikt u de sneltoets Cmd + Shift + P op macOS of Ctrl + Shift + P op Windows.

Minimap voor celuitvoering

Gebruik de minimap voor celuitvoering om een visueel overzicht te krijgen van de uitvoeringsstatus van uw notebook. De minimap wordt weergegeven in de rechtermarge en toont een statusbalk voor elke uitvoerbare cel.

Statusbalken geven de volgende uitvoeringsstatussen aan:

• Lichtgrijs: Cel is statisch.
• Donkergrijs: De cel wordt overgeslagen of in de wachtrij geplaatst voor uitvoering.
• Lichtgrijs met bewegende balk: Cel wordt momenteel uitgevoerd.
• Groen: De cel is zonder fouten uitgevoerd.
• Rood: Cel is mislukt met een fout.

Ga als volgende te werk om te communiceren met de minimap:

• Beweeg de muisaanwijzer over de minimap om een lijst met uitvoerbare cellen, hun titels en de uitvoeringsstatussen weer te geven.
• Klik op een vermelding om rechtstreeks naar die cel in het notitieblok te gaan.
• Klik op Ga naar de laatste uitvoeringscel of ga naar de eerste mislukte cel om naar de laatst uitgevoerde of eerste mislukte cel te gaan.

Met de minimap kunt u de voortgang van de uitvoering in één oogopslag bijhouden en snel navigeren tijdens het opsporen of ontwikkelen van fouten.

Tekst zoeken en vervangen

Als u tekst in een notitieblok wilt zoeken en vervangen, gebruikt u de sneltoets Cmd + F (Mac) of (Windows) of Ctrl + Fklikt u op Zoeken bewerken > ... om het dialoogvenster Zoeken te openen. Voer de tekst in die u wilt zoeken. De huidige match is oranje gemarkeerd en alle andere matches zijn geel gemarkeerd. Als u toegang wilt krijgen tot de systeemeigen browserzoekopdrachten, drukt u nogmaals op Cmd + F (Mac) of Ctrl + F(Windows).

Klik op het om de optie Vervangen te openen. Voer in plaats daarvan de tekst in die u wilt gebruiken. Als u de huidige match wilt vervangen, klik dan op Vervangen. Als u alle overeenkomsten in het notitieblok wilt vervangen, klikt u op Alles vervangen.

Als u wilt schakelen tussen overeenkomsten, klikt u op (vorige overeenkomst) of (volgende overeenkomst). U kunt ook op Shift + Enter en Enter drukken om respectievelijk naar de vorige en volgende overeenkomsten te gaan.

Als u het hulpmiddel Zoeken en vervangen wilt sluiten, klikt u op of drukt u op Esc.

Variabele inspectie

Als u informatie wilt weergeven over een variabele die is gedefinieerd in een SQL- of Python-notebook, plaatst u de cursor boven de naam van de variabele. Python-variabele inspectie vereist Databricks Runtime 12.2 LTS of hoger.

Zie Variable Explorer.

Naar definitie gaan

Wanneer een Python-notebook is gekoppeld aan een rekenresource, kunt u snel naar de definitie van een variabele, functie of de code achter een %run instructie gaan. Klik hiervoor met de rechtermuisknop op de naam van de variabele of functie en klik vervolgens op Ga naar definitie of Definitie bekijken.

Houd de Cmd-toets op macOS of Ctrl in Windows ingedrukt en beweeg de muisaanwijzer over de naam van de variabele of functie. Als er een definitie wordt gevonden, wordt de naam omgezet in een hyperlink.

De functie Go to Definition is beschikbaar in Databricks Runtime 12.2 LTS en hoger.

Code vouwen

Met codevouwen kunt u secties met code tijdelijk verbergen. Dit kan handig zijn bij het werken met lange codeblokken, omdat u zich kunt richten op specifieke secties met code waaraan u werkt.

Als u code wilt verbergen, plaatst u de cursor uiterst links van een cel. Pijlen naar beneden worden weergegeven op logische punten waar u een codesectie kunt verbergen. Klik op de pijl om een codesectie te verbergen. Klik nogmaals op de pijl (nu naar rechts) om de code weer te geven.

Zie de VS Code-documentatie voor meer informatie, waaronder sneltoetsen.

Ondersteuning voor meerderecursor's

U kunt meerdere cursors maken om gelijktijdige bewerkingen gemakkelijker te maken, zoals wordt weergegeven in de video:

Meerdere cursors in een cel maken:

• Houd in macOS de Option toets ingedrukt en klik op elke locatie om een cursor toe te voegen.
• Houd in Windows de Alt toets ingedrukt en klik op elke locatie om een cursor toe te voegen.
• U heeft ook de mogelijkheid de snelkoppeling te wijzigen. Zie Wijzig snelkoppeling voor multicursor- en kolomselectie.

In macOS kunt u meerdere verticaal uitgelijnde cursors maken met behulp van de sneltoets Option+Command+ pijl-omhoog of pijl-omlaag.

Selectie van kolom (vak)

Als u meerdere items in een kolom wilt selecteren, klikt u linksboven in het gebied dat u wilt vastleggen. Then:

• Druk in macOS op Shift + Option en sleep naar rechtsonder om een of meer kolommen vast te leggen.
• Druk in Windows op Shift + Alt en sleep naar rechtsonder om een of meer kolommen vast te leggen.
• U heeft ook de mogelijkheid de snelkoppeling te wijzigen. Zie Wijzig snelkoppeling voor multicursor- en kolomselectie.

Snelkoppeling voor multicursor en kolomselectie wijzigen

Er is een alternatieve snelkoppeling beschikbaar voor de selectie van meerdere cursors en kolommen. Met de alternatieve selectie worden de sneltoetsen als volgt gewijzigd:

• Meerdere cursors in een cel maken:
  • Houd in macOS de Cmd toets ingedrukt en klik op elke locatie om een cursor toe te voegen.
  • Houd in Windows de Ctrl toets ingedrukt en klik op elke locatie om een cursor toe te voegen.
• Als u meerdere items in een kolom wilt selecteren, klikt u linksboven in het gebied dat u wilt vastleggen. Then:
  • Druk in macOS op Option en sleep naar rechtsonder om een of meer kolommen vast te leggen.
  • Druk in Windows op Alt en sleep naar rechtsonder om een of meer kolommen vast te leggen.

Ga als volgt te werk om de alternatieve sneltoetsen in te schakelen:

1. Klik op uw gebruikersnaam rechtsboven in de werkruimte en klik vervolgens op Instellingen in de vervolgkeuzelijst.
2. Selecteer Developerin de zijbalk Instellingen.
3. Wijzig in de sectie Code-editor de instelling voor toetsaanpassing voor meerdere cursorklikken in Cmd voor macOS of Ctrl voor Windows.

Wanneer u alternatieve sneltoetsen inschakelt, verandert de sneltoets voor het maken van meerdere verticaal uitgelijnde cursors niet.

Door gegevens bladeren

Gebruik de schemabrowser om Unity Catalog-objecten te verkennen die beschikbaar zijn voor het notebook. Klik op Aan de linkerkant van het notitieblok om de schemabrowser te openen.

Met de knop Voor u worden alleen de objecten weergegeven die u in de huidige sessie hebt gebruikt of die eerder zijn gemarkeerd als favoriet.

Terwijl u tekst in het vak Filter typt, verandert de weergave zodat alleen de objecten worden weergegeven die de tekst bevatten die u typt. Alleen objecten die momenteel zijn geopend of die zijn geopend in de huidige sessie, worden weergegeven. Het vak Filter voert geen volledige zoekopdracht uit van de catalogi, schema's, tabellen en volumes die beschikbaar zijn voor het notebook.

Om het te openen, beweegt u de cursor boven de naam van het object zoals weergegeven:

Als het object een tabel is, kunt u het volgende doen:

• Automatisch een cel maken en uitvoeren om een voorbeeld van de gegevens in de tabel weer te geven. Selecteer Voorbeeld in een nieuwe cel in het menu voor de tabel.
• Een catalogus, schema of tabel weergeven in Catalog Explorer. Selecteer Openen in Catalogusverkenner in het kebabmenu. Er wordt een nieuw tabblad geopend met het geselecteerde object.
• Haal het pad naar een catalogus, schema of tabel op. Selecteer Kopiëren … pad uit het kebabmenu voor het object.
• Voeg een tabel toe aan Favorieten. Selecteer Toevoegen aan favorieten in het menu van de tabel.

Als het object een catalogus, schema of volume is, kunt u het pad van het object kopiëren of openen in Catalog Explorer.

Een tabel- of kolomnaam rechtstreeks in een cel invoegen:

1. Klik op de cursor in de cel op de locatie waar u de naam wilt invoeren.
2. Verplaats de cursor over de tabelnaam of kolomnaam in de schemabrowser.
3. Klik op het dat rechts van de naam van het object wordt weergegeven.

Webterminal en Databricks CLI gebruiken

Als u de webterminal in een notitieblok wilt openen, klikt u op het onderaan de rechterzijbalk.

In Databricks Runtime 15.0 en hoger kunt u de Databricks CLI gebruiken vanuit de webterminal in een notebook. Zie Shell-opdrachten uitvoeren in de Azure Databricks-webterminal voor vereisten en gebruiksgegevens.

U kunt de CLI niet gebruiken vanuit een notebookcel. In een notebook werken opdrachten zoals %sh databricks ... niet met Databricks Runtime 15.0 of hoger.

Persoonlijke automatisch aanvullen

Automatisch aanvullen voltooit automatisch codesegmenten terwijl u ze typt. Invulbare objecten zijn typen, klassen en objecten, evenals SQL-database, tabelnamen, structs, kaarten, matrices en queryfragmenten. Wanneer u verwijst naar algemene tabelexpressies (CTE's) die gebruikmaken SELECT *van, biedt automatisch aanvullen kolomaanbevelingen op basis van de onderliggende tabelstructuur. Databricks maakt gebruik van metagegevens en gebruik van uw Unity Catalog om suggesties aan te passen.

• Voor Python-cellen moet het notebook worden gekoppeld aan een rekenresource om automatisch aanvullen te kunnen werken en moet u alle cellen uitvoeren die invulbare objecten definiëren.
• Voor SQL-cellen worden trefwoorden en basissyntaxis voorgesteld, zelfs wanneer het notebook niet aan een rekenkrachtbron is gekoppeld.
  • Als de werkruimte is ingeschakeld voor Unity Catalog, suggereert automatische aanvulling ook catalogus-, schema-, tabel- en kolomnamen in tabellen binnen Unity Catalog.
  • Als de werkruimte niet is ingeschakeld voor Unity Catalog, moet het notebook zijn gekoppeld aan een rekenresource voor alle doeleinden of een SQL-warehouse om tabel- of kolomnamen voor te stellen.

Suggesties voor automatisch aanvullen worden automatisch weergegeven wanneer u in een cel typt. Gebruik de pijl-omhoog- en pijl-omlaagtoets of de muis om een suggestie te selecteren en druk op Tab- of Enter- om de selectie in de cel in te voegen.

Automatisch aanvullen is standaard ingeschakeld, maar kan worden uitgeschakeld in uw gebruikersinstellingen:

• Als u suggesties voor automatisch aanvullen wilt uitschakelen, schakelt u Automatisch aanvullen terwijl u typt uit. Wanneer automatisch aanvullen is uitgeschakeld, kunt u suggesties voor automatisch aanvullen weergeven door op Ctrl+ spatiebalk te drukken.
• Om te voorkomen dat Enter suggesties voor automatisch aanvullen invoegt, schakelt u de optie Enter-toets accepteert suggesties voor automatisch aanvullen uit.

Haakjes die overeenkomen

Wanneer u op een haakje, vierkante haak of accolade klikt, markeert de editor dat teken en de bijbehorende haak.

Python-foutmarkering

Werkruimten waarvoor AI-functies met partnermogelijkheden zijn ingeschakeld, kunnen ook Fix met Assistent voor ai-ondersteunde suggesties selecteren.

Databricks-notebooks ondersteunen de volgende foutmarkeringen:

• Markering van Python-syntaxisfouten: eventuele syntaxisfouten in Python-codecellen worden rood gemarkeerd. Indien mogelijk stelt de assistent een snelle oplossing voor. Dit wordt ondersteund voor berekeningen met Databricks Runtime 12.1 en hoger of serverloze berekeningen. U kunt het markeren van syntaxisfouten configureren met pyproject.toml-bestanden. Zie Markering van Python-syntaxis configureren.
• Markering van Python-indelingsfouten: fouten en waarschuwingen voor python-codeopmaak worden geel of rood onderstreept, afhankelijk van de ernst. Dit kan helpen bij het identificeren van opmaakproblemen, zoals onverwachte inspringing, lange lijnlengte en meer. Beweeg de muisaanwijzer over de syntaxiswaarschuwingen voor meer informatie. Dit wordt ondersteund voor berekeningen met Databricks Runtime 12.1 en hoger of serverloze berekeningen.
• Markering van Python-typefouten: Typecontrole kan de kwaliteit, leesbaarheid en onderhoudbaarheid van code in Python- en PySpark-projecten verbeteren. Typecontrolefuncties kunnen fouten markeren die betrekking hebben op niet-bestaande kenmerken, ontbrekende argumenten en niet-overeenkomende argumenten in functie-aanroepen voordat code wordt uitgevoerd. Beweeg de muisaanwijzer over de gemarkeerde waarschuwingen voor meer informatie. Dit wordt ondersteund voor berekeningen met Databricks Runtime 16.0 en hoger of serverloze omgeving 2.

Markeren van Python-fouten inschakelen

Ga als volgt te werk om foutmarkeringen in of uit te schakelen:

1. Klik op uw gebruikersnaam rechtsboven in de werkruimte en klik vervolgens op Instellingen in de vervolgkeuzelijst.
2. Selecteer Developerin de zijbalk Instellingen.
3. Hiermee schakelt u de instelling voor foutmarkering van Python-syntaxis in (onder Code-editor), markering van Python-indelingsfouten (onder Experimentele functies) en/of markering van Python-typefouten (onder Experimentele functies).

Markering van Python-syntaxis configureren

Wanneer een notebook is verbonden met het berekenen van Databricks Runtime 16.4 of hoger of serverloze omgevingsversie 3 of hoger, kunt u het gedrag van syntaxismarkeringen aanpassen door een pyproject.toml bestand te maken. Voor een bepaald notebook wordt het dichtstbijzijnde pyproject.toml bestand in het directe bovenliggende pad in het werkruimtebestandssysteem gebruikt. Als een bestand niet kan worden gevonden in de bovenliggende map, wordt een pyproject.toml bestand in de basismap van de huidige gebruiker gebruikt.

Als u bijvoorbeeld een notitieblok met het pad a/b/c/d/notebook.py hebt en er bestanden zijn op de locaties pyproject.toml en a/b/pyproject.toml, wordt het tweede bestand gebruikt omdat het dichterbij het pad ligt. Een pyproject.toml bestand /a/b/c/e/pyproject.toml wordt niet meegenomen omdat het zich niet in het directe ouderpad bevindt.

Azure Databricks maakt gebruik van de standaardsyntaxis voor pyproject.toml bestanden. U kunt bijvoorbeeld verwijzen naar de documentatie van Ruff om te zien hoe u de Ruff linter configureert met een pyproject.toml bestand.

Op dit moment ondersteunt Azure Databricks alleen het configureren van ruff, pylint, pyright en flake8 voor linting via pyproject.toml.

Als u een linter wilt inschakelen, moet het pyproject.toml bestand een [tool.<name-of-linter>] blok hebben.

Als u een linter expliciet wilt uitschakelen, voegt u het volgende blok toe:

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

U kunt ook de door Azure Databricks geschreven syntaxismarkeringsregels uitschakelen met een blok, zoals:

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

Omdat Flake8 een configuratie in een andere indeling verwacht, moet u de configuratie voor Flake8 doorgeven als een tekenreeks:

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

SQL-opmaak aanpassen

U kunt instellingen voor SQL-opmaak aanpassen in de nieuwe SQL-editor en de notebook-editor. Klik op Instellingen voor ontwikkelaars weergeven>. Schuif omlaag naar SQL-indeling en geef uw instellingen op.

Sneltoetsen gebruiken

Als u sneltoetsen wilt weergeven, selecteert u Help > sneltoetsen. De beschikbare sneltoetsen zijn afhankelijk van of de cursor zich in een codecel bevindt (bewerkingsmodus) of niet (opdrachtmodus).

In de onderstaande tabellen worden beschikbare sneltoetsen weergegeven.

Snelkoppelingen in de modus bewerken

Sneltoetsen voor de opdrachtmodus

Gedeelde snelkoppelingen