Indeling van Databricks-notebooks beheren

Notebooks in Databricks worden standaard aangemaakt in het formaat .ipynb (IPython of Jupyter). U kunt er ook voor kiezen om in plaats daarvan de bronindeling te gebruiken.

U kunt nog steeds notitieblokken importeren en exporteren in verschillende indelingen. Zie Databricks-notebooks importeren en exporteren.

Notitieboekformaten

Databricks ondersteunt het maken en bewerken van notebooks in twee indelingen: IPYNB (standaard) en bron.

U kunt bronbestanden, inclusief notebooks, beheren met behulp van Git-mappen. Alleen bepaalde Databricks-assettypen worden ondersteund in Git-mappen. Het formaat beïnvloedt hoe notitieboeken naar externe repositories worden gepusht, zoals beschreven in de onderstaande tabel.

Notitieblok bronformaat	Beschrijving
bron	Een basisindeling die alleen broncode vastlegt, met een achtervoegsel dat de codetaal aangeeft, zoals .py, .scala, .r en .sql.
IPYNB (Jupyter)	Een uitgebreide indeling die broncode, notebookomgeving, visualisatiedefinities, notebookwidgets en optionele uitvoer vastlegt. Een IPYNB-notebook kan code bevatten in elke taal die wordt ondersteund door Databricks-notebooks (ondanks het py deel van .ipynb). Met behulp van het IPYNB-formaat kun je optioneel de versie van de uitvoer van een notebook beheren samen met de notebook.

Het IPYNB-formaat ondersteunt ook een betere weergave-ervaring voor Databricks-notebooks op externe Git-repositories. Als u GitHub of GitLab gebruikt, kunt u functies inschakelen waarmee u verbeterde diffs van uw notebooks in pull requests krijgt, zodat u wijzigingen in een notebook gemakkelijker kunt bekijken en code kunt reviewen.

Zie Feature Preview: Rich Jupyter Notebook Diffs voor meer informatie over GitHub ondersteuning voor uitgebreide diffs van IPYNB-notebooks. Zie Jupyter Notebook-bestanden voor meer informatie over GitLab-ondersteuning voor IPYNB-notebooks.

Als u notebooks met bronindelingen wilt onderscheiden van gewone Python-, Scala- en SQL-bestanden, voegt Azure Databricks de opmerking 'Databricks notebook source' toe aan de bovenkant van Python-, Scala- en SQL-notebooks. Deze opmerking zorgt ervoor dat Azure Databricks het bestand correct parseert als een notebook in plaats van een scriptbestand.

Wijzig de standaardinstelling voor notitieboekopmaak

IPYNB-notebooks zijn het standaardformaat voor het maken van een nieuwe notebook op Azure Databricks.

Als u de standaardindeling wilt wijzigen in de Azure Databricks bronindeling, meldt u zich aan bij uw Azure Databricks werkruimte, klikt u in de rechterbovenhoek van de pagina op uw profiel en klikt u vervolgens op Settings en navigeert u naar Ontwikkelaar. Wijzig de standaardindeling van het notitieblok onder de Editor-instellingen rubriek.

Notitieblokindeling converteren

U kunt een bestaand notitieblok converteren naar een andere indeling via de gebruikersinterface van Azure Databricks.

Een bestaand notitieblok converteren naar een andere indeling:

1. Open het notitieblok in uw werkruimte.

2. Selecteer Bestand in het werkruimtemenu, selecteer Notitieboekformaat, en kies het gewenste formaat. U kunt kiezen tussen Jupyter (.ipynb) (Aanbevolen) of Bronbestand (.scala, .py, .sql, .r). De huidige indeling van het notitieblok wordt grijs weergegeven en bevat een vinkje ernaast.

   

Zie Databricks-notebooks importeren en exporteren voor meer informatie over de soorten notebooks die worden ondersteund in Azure Databricks.

Beheer IPYNB notebook-uitvoerverzoeken

Uitvoerresultaten zijn de uitkomsten van het uitvoeren van een notebook op het Databricks-platform, inclusief tabelweergaven en visualisaties. Voor IPYNB-notebooks in door bron beheerde mappen kunt u beheren hoe notebookuitvoer wordt doorgevoerd in de externe opslagplaats.

Sta toe dat notebookuitvoer wordt gecommit .ipynb

Uitvoer kan alleen worden doorgevoerd als een werkruimtebeheerder deze functie heeft ingeschakeld. De beheerinstelling voor Git-mappen staat standaard niet toe dat .ipynb notebookuitvoer wordt doorgevoerd. Als u beheerdersbevoegdheden voor de werkruimte hebt, kunt u deze instelling wijzigen:

1. Klik op uw gebruikersnaam in de bovenste balk van de Azure Databricks-werkruimte en selecteer Instellingen.

2. Klik onder Workspace admin op Ontwikkeling.

3. In de sectie Repos, stel Opslagplaatsen toestaan IPYNB-uitvoer te exporteren in op Toestaan: IPYNB-uitvoer kan worden ingeschakeld.

   

Belangrijk

Wanneer uitvoer wordt opgenomen, worden de visualisatie- en dashboardconfiguraties opgenomen in de .ipynb notebooks die u maakt.

Beheer IPYNB-notitieboek uitvoer artefact commits

Het .databricks/commit_outputs configuratiebestand in je repository bepaalt welke .ipynb notebook-uitvoer worden gecommit. Nadat een workspace-beheerder outputcommits toestaat, kun je dit bestand aanmaken vanuit het Git-dialoog:

1. Open het Git-dialoogvenster voor een Git-map die een .ipynb notebook bevat maar geen .databricks/commit_outputs bestand.

2. Klik in de info-alert bovenaan het dialoogvenster op 'Maak commit_outputs configuratiebestand aan.

   

Je kunt ook het Bestandsmenu gebruiken om uitvoer voor een specifiek IPYNB-notebook op te nemen of uit te sluiten. Als het configuratiebestand niet bestaat, maakt Azure Databricks het aan wanneer je je keuze maakt. Gebruik deze optie als je de melding in het Git-dialoog hebt weggeklikt.

1. Selecteer in het Bestandsmenu de optie Notebook-uitvoer vastleggen. Het menu-item is alleen beschikbaar voor IPYNB-notebooks in een Git-map, nadat een workspace-beheerder outputcommits toestaat.

   

2. Selecteer in het dialoogvenster Commit outputs configurationInclude Outputs of Exclude Outputs en klik vervolgens op Wijzigen.

   Dialoogvenster notitieblokuitvoer bevestigen.