Basisbewerking in Databricks-notebooks

Een Databricks-notebook is een webcode-editor waarmee u code kunt schrijven en resultaten kunt weergeven voor interactieve gegevensanalyse. Deze pagina bevat de basisbeginselen van het gebruik van notebooks in Databricks, waaronder het navigeren in de werkbalk en het uitvoeren van verschillende celacties.

Een notitieblok maken

U kunt op verschillende manieren een nieuw notitieblok maken:

• Gebruik de knop Nieuw in de zijbalk
• Een notitieblok maken in elke map
• Een notitieblok maken op een nieuw tabblad

Een notitieblok openen

Als u een notitieblok wilt openen, gebruikt u de zoekfunctie van de werkruimte of gebruikt u de werkruimtebrowser om naar het notitieblok te navigeren en op de naam of het pictogram van het notitieblok te klikken.

Als u tabbladen voor notitieblokken en bestanden hebt ingeschakeld, kunt u een notitieblok openen op een nieuw tabblad.

Notitieblokken naast elkaar bewerken

Als u notitieblokken naast elkaar wilt weergeven en bewerken, klikt u op het Als u een gesplitste weergave van het huidige notitieblok wilt toevoegen. U kunt ook een notitiebloktabblad slepen en naar rechts neerzetten om notitieblokken naast elkaar te bewerken.

Notebookcellen

Notebooks bevatten een verzameling van twee typen cellen: codecellen en Markdown-cellen. Codecellen bevatten uitvoerbare code. Markdown-cellen bevatten Markdown-code die wordt weergegeven als tekst en afbeeldingen. Gebruik Markdown om uw code te documenteren of te illustreren. U kunt cellen van elk type aan uw notitieblok toevoegen of verwijderen om uw werk te structuren. Een notebook kan maximaal 10.000 cellen bevatten.

U kunt één cel, een groep cellen of het hele notitieblok uitvoeren. Een notebookcel kan maximaal 6 MB bevatten en de uitvoer is beperkt tot 20 MB.

Notebook werkbalkpictogrammen en knoppen

De werkbalk bevat menu's en pictogrammen die u kunt gebruiken om het notitieblok te beheren en te bewerken.

Naast de naam van het notitieblok staan knoppen om de standaardtaal van het notebook te wijzigen en als het notitieblok is opgenomen in een Databricks Git-map, het Git-dialoogvensteropenen.

Als u vorige versies van het notitieboek wilt weergeven, klik op 'Laatste bewerking...' aan de rechterkant van de menu's.

De pictogrammen en knoppen rechts van de werkbalk worden beschreven in de volgende tabel:

Icon	Description
	Voer alle cellen uit of stop de uitvoering. De naam van deze knop wordt gewijzigd, afhankelijk van de status van het notitieblok.
	Open rekenkiezer. Wanneer het notebook is verbonden met een cluster of SQL Warehouse, wordt met deze knop de naam van de rekenresource weergegeven.
	Open taakplanningsysteem.
	Open Lakeflow-declaratieve pijplijnen. Deze knop wordt alleen weergegeven als het notebook deel uitmaakt van een pijplijn.
	Machtigingen dialoog openen.

Acties rechterzijbalk

Er zijn verschillende acties beschikbaar in de rechterzijbalk van het notitieblok, zoals beschreven in de volgende tabel:

Icon	Description
	Open opmerkingen in notitieblok .
	Open MLflow Notebook-experiment.
	Open versiegeschiedenis van notitieblok.
	Open variable Explorer. (Beschikbaar voor Python-variabelen met Databricks Runtime 12.2 LTS en hoger.)
	Open het Python-omgevingsvenster. In dit deelvenster ziet u alle Python-bibliotheken die beschikbaar zijn voor het notebook, waaronder notebookbibliotheken, clusterbibliotheken en bibliotheken die zijn opgenomen in de Databricks Runtime. Alleen beschikbaar wanneer het notebook is gekoppeld aan een cluster.

cellen maken

Notebooks hebben twee typen cellen: code en Markdown.

Als u een nieuwe cel wilt maken, plaatst u de muisaanwijzer boven of onder aan een cel. Klik op + Code of + Tekst om respectievelijk een code of Markdown-cel te maken.

Standaard wordt in een codecel uitgegaan van de codetaal van uw notebook, die boven aan de pagina is opgegeven. Als u talen wilt combineren, kunt u een andere taal voor een cel opgeven. Zie Standaardtaal instellen.

De inhoud van Markdown-cellen wordt weergegeven in HTML. Dit fragment bevat bijvoorbeeld markeringen voor een kop op niveau één:

%md ### Libraries
Import the necessary libraries.

Wordt weergegeven als volgt:

Als u een nieuwe cel wilt maken, plaatst u de muisaanwijzer boven of onder aan een cel. Klik op Code of Text om respectievelijk een code of Markdown-cel te maken.

Celacties

U kunt verschillende acties uitvoeren op een cel. In het menu voor het uitvoeren van cellen kunt u kiezen of u een cel, alle cellen erboven of alle onderliggende cellen wilt uitvoeren. Er zijn celpictogrammen waarmee u snel de programmeertaal kunt wijzigen, een cel kunt verwijderen en toegang kunt krijgen tot de assistent. In het menu celacties kunt u cellen knippen en kopiëren, cellen verplaatsen in het notitieblok en code of resultaten in een cel verbergen.

Een cel uitvoeren

Om een codecel uit te voeren, klikt u rechtsboven op de rechterpijl van de cel. Als u het cellrunmenu wilt openen, klikt u op de pijl-omlaag ernaast en selecteert u de context waarin u de cel wilt uitvoeren.

Nadat een cel is uitgevoerd, wordt rechts van het uitvoeringsmenu van de cel een melding weergegeven met de laatste keer dat de cel is uitgevoerd en de duur. Plaats de muisaanwijzer op de kennisgeving voor meer informatie.

Als u gedetailleerde uitvoeringsinformatie standaard wilt weergeven, klikt u rechtsboven op uw profielafbeelding. Klik vervolgens op Settings>Developer>Gedetailleerde opdrachtuitvoeringsgegevens weergeven.

Als u een uitvoer van een tabellair resultaat hebt, kunt u deze informatie ook openen door de muisaanwijzer op de tekst 'Laatst vernieuwd' in de rechterbenedenhoek van de tabel te plaatsen.

Geselecteerde cellen uitvoeren

U kunt één cel of een verzameling cellen uitvoeren. Als u één cel wilt selecteren, klikt u ergens in de cel. Als u meerdere cellen wilt selecteren, houdt u de Command-toets in MacOS of de Ctrl-toets in Windows ingedrukt en klikt u op de cel buiten het tekstgebied, zoals wordt weergegeven in de schermafbeelding.

Als u de geselecteerde cellen wilt uitvoeren, klikt u op Run>Run and debug>Run selected cell(s) of gebruikt u de sneltoets Command + Enter op MacOS of Crtl + Enter in Windows. Het gedrag van deze opdracht is afhankelijk van de rekenresource waaraan het notebook is gekoppeld.

• Op een rekenresource waarop Databricks Runtime 13.3 LTS of lager wordt uitgevoerd, worden geselecteerde cellen afzonderlijk uitgevoerd. Als er een fout optreedt in een cel, wordt de uitvoering voortgezet met de volgende cellen.
• Op een rekenresource met Databricks Runtime 14.0 of hoger, of in een SQL-warehouse, worden geselecteerde cellen uitgevoerd als een batch. Elke fout stopt de uitvoering en u kunt de uitvoering van afzonderlijke cellen niet annuleren. U kunt de knop Onderbreken gebruiken om de uitvoering van alle cellen te beëindigen.

Geselecteerde tekst uitvoeren

U kunt code of SQL-instructies markeren in een notebookcel en alleen de gemarkeerde code uitvoeren. Dit is handig als u code en query's snel wilt herhalen.

1. Markeer de regels die je wilt uitvoeren.

2. Selecteer Geselecteerde tekst > Uitvoeren of gebruik de sneltoets Ctrl+Shift+Enter. Als er geen tekst is gemarkeerd, Geselecteerde tekst uitvoeren de huidige regel uitvoert.

   

Als u gemengde talen in een celgebruikt, moet u de %<language> regel in de selectie opnemen.

Geselecteerde tekst uitvoeren ook samengevouwen code uitvoert, indien aanwezig in de gemarkeerde selectie.

Speciale celopdrachten, zoals %run, %pip, en %sh, worden ondersteund.

U kunt Geselecteerde tekst uitvoeren niet gebruiken op cellen met meerdere uitvoertabbladen (cellen waarin u een gegevensprofiel of visualisatie hebt gedefinieerd).

Celpictogrammen

In de volgende schermafbeelding worden de pictogrammen beschreven die rechtsboven in een notebookcel worden weergegeven:

Taalkiezer: Selecteer de taal voor de cel.

Cel verwijderen: Verwijder de cel.

Databricks Assistant: Openen of sluiten van Databricks Assistant inline in de codecel. U kunt een prompt invoeren voor de assistent om u te helpen code te genereren.

Celfocus: De cel vergroten om het bewerken gemakkelijker te maken.

menu Celacties weergeven: Het menu celacties openen. De opties in dit menu verschillen enigszins voor code- en Markdown-cellen.

Een cel verwijderen

Als u een cel wilt verwijderen, klikt u op het prullenbakpictogram rechts van de cel. Dit pictogram wordt alleen weergegeven wanneer u de cursor over de cel beweegt.

Een cel verplaatsen

Als u een cel omhoog of omlaag wilt verplaatsen, klikt u op het sleepgreeppictogram en houdt u het links van de cel ingedrukt.

U kunt ook omhoog of omlaag in het menu celacties selecteren.

cellen knippen, kopiëren en plakken

Er zijn verschillende opties voor het knippen en kopiëren van cellen. Als u echter de Safari-browser gebruikt, zijn alleen de sneltoetsen beschikbaar.

• Selecteer in het menu celacties cel knippen of cel kopiëren.
• Gebruik sneltoetsen: Command-X of Ctrl-X om te knippen en Command-C of Ctrl-C om te kopiëren.
• Gebruik het menu Bewerken boven aan het notitieblok. Selecteer Knippen of Kopiëren.

Nadat u cellen hebt geknipt of gekopieerd, kunt u deze cellen ergens anders in het notitieblok plakken, in een ander notitieblok of een notitieblok in een ander browsertabblad of -venster. Als u cellen wilt plakken, gebruikt u de sneltoets Command-V of Ctrl-V. De cellen worden onder de huidige cel geplakt.

Als u knip- of plakbewerkingen ongedaan wilt maken, kunt u de sneltoets Command-Z of Ctrl-Z gebruiken, of de menuopties Bewerken > Knipcellen ongedaan maken of Bewerken > Plakexcellen ongedaan maken.

Als u aangrenzende cellen wilt selecteren, klikt u in een Markdown-cel en gebruikt u Shift + Omhoog of Omlaag om de cellen erboven of eronder te selecteren. Gebruik het menu Bewerken om de geselecteerde cellen als groep te kopiëren, knippen, plakken of verwijderen. Als u alle cellen wilt selecteren, selecteert u Bewerken > Alle cellen selecteren of gebruikt u de opdrachtmodussnelkoppeling Cmd+A-.

Codeopmerkingen toevoegen

Als u een opmerking wilt toevoegen aan code in een cel, markeert u de code. Rechts van de cel wordt een opmerkingspictogram weergegeven. Klik op het pictogram om het opmerkingenvak te openen.

Een cel toevoegen aan een dashboard

Als u een Markdown-cel of cel met tabelresultaten aan een dashboard wilt toevoegen, selecteert u Toevoegen aan dashboard in het menu celacties. Zie Dashboards in notitieblokkenvoor meer informatie.

Een koppeling maken naar een cel

Als u een URL-koppeling naar een specifieke opdracht in uw notitieblok wilt ophalen, klikt u op om de focusmodus te openen en de URL te kopiëren vanuit de adresbalk van de browser. Om de focusmodus te verlaten, klikt u op het icoon .

Als u een URL-koppeling naar een specifieke opdracht in uw notitieblok wilt ophalen, klikt u op Als u de focusmodus wilt openen en de URL wilt kopiëren vanuit de adresbalk van de browser. Als u de focusmodus wilt afsluiten, klikt u op .

Databricks Assistant openen

Als u een tekstvak van de Databricks-assistent in een cel wilt openen, klikt u op het in de rechterbovenhoek van de cel.

U kunt deze gebruiken in een codecel om hulp of suggesties voor uw code te krijgen. Databricks Assistant moet zijn ingeschakeld in uw werkruimte.