Zelfstudie: Een bundel maken en implementeren in de werkruimte

Om u te helpen aan de slag te gaan met Databricks Asset Bundles in de werkruimte, begeleidt deze zelfstudie u bij het maken van een bundel met een taak, het implementeren ervan en het uitvoeren van de taak in de bundel, allemaal vanuit de werkruimte.

Zie vereisten voor Databricks Asset Bundles in de werkruimte voor de vereisten voor het gebruik van bundels in de werkruimte.

Zie Wat zijn Databricks Asset Bundles?voor meer informatie over bundels.

Een bundel maken

Maak eerst een bundel in de Databricks-werkruimte:

1. Navigeer naar de Git-map waar u uw bundel wilt maken.

   Aanbeveling

   Als u de Git-map eerder hebt geopend in de editor in de werkruimte, kunt u het contextmenu van de werkruimtebrowser gebruiken om snel naar de Git-map te navigeren. Zie Ontwerpcontexten.

2. Klik op de knop Maken en klik vervolgens op Asset bundle. U kunt ook met de rechtermuisknop klikken op de Git-map of de bijbehorende kebab in de werkruimtestructuur en op Assetbundel maken> klikken:

   

3. Geef in het dialoogvenster Maak een assetbundel een naam op voor de assetbundel, zoals totally-awesome-bundle. De bundelnaam mag alleen letters, cijfers, streepjes en onderstrepingstekens bevatten. Selecteer Leeg project en klik vervolgens op Maken en implementeren .

   

Hiermee maakt u een eerste bundel in de Git-map, die een .gitignore Git-configuratiebestand en het vereiste Databricks Asset Bundles-bestand databricks.yml bevat. Het databricks.yml bestand bevat de hoofdconfiguratie voor de bundel. Zie de configuratie van Databricks Asset Bundle voor meer informatie.

Een notitieblok toevoegen

Voeg vervolgens een notitieblok toe aan uw bundel. In het volgende voorbeeld wordt 'Hallo wereld!' afgedrukt.

1. Klik op de tegel Notitieblokbundel toevoegen aan project. U kunt ook opde voor de bundel in de inhoudsopgave klikken en vervolgens op Notitieblok maken> klikken.

2. Wijzig de naam van het notitieblok in helloworld.

3. Stel de taal van het notebook in op Python en plak het volgende in de cel van het notebook:

   print("Hello World!")
   

Een taak definiëren

Definieer nu een taak waarmee het notebook wordt uitgevoerd.

1. Klik op het implementatiepictogram voor de bundel om over te schakelen naar het deelvenster Implementaties .

   

2. Klik in de sectie Bundelbronnen op Toevoegen en vervolgens op Nieuwe taakdefinitie.

   

3. Typ run-notebook in het veld Taaknaam van het Taak toevoegen aan bestaande bundel dialoogvenster. Klik op Toevoegen en implementeren.

4. Er wordt een bevestigingsdialoogvenster voor implementatie naar de ontwikkelomgeving weergegeven met informatie over de taakresource die wordt gemaakt in de werkruimte van de dev-omgeving. Klik op Implementeren.

5. Ga terug naar de bestanden van de bundel door op het mappictogram boven het implementatiepictogram te klikken. Er is een taakresource run-notebook.job.yml gemaakt met basis-YAML voor de taak en een aantal extra opmerkingen bij voorbeeldtaak YAML.

6. Voeg een notebooktaak toe aan de taakdefinitie. Vervang het voorbeeld van YAML in het run-notebook.job.yml bestand door het volgende:

   resources:
     jobs:
       run_notebook:
         name: run-notebook
         queue:
           enabled: true
         tasks:
           - task_key: my-notebook-task
             notebook_task:
               notebook_path: ../helloworld.ipynb
   

   

Zie de taak voor meer informatie over het definiëren van een taak in YAML. Zie Taken toevoegen aan taken in Databricks Asset Bundles voor yamL-syntaxis voor andere ondersteunde taaktakentypen.

De bundel implementeren

Implementeer vervolgens de bundel en voer de taak uit die de helloworld notebooktaak bevat.

1. Klik in het deelvenster Implementaties voor de bundel onder Doelen op de vervolgkeuzelijst om de dev doelwerkruimte te selecteren als deze nog niet is geselecteerd. Doelwerkruimten worden gedefinieerd in de targets koppeling van de bundel databricks.yml. Zie de implementatiemodi voor Databricks Asset Bundle.

   

2. Klik op de knop Implementeren . De bundel wordt gevalideerd en de details van de validatie worden weergegeven in een dialoogvenster.

3. Controleer de implementatiedetails in dit bevestigingsdialoogvenster Implementeren naar dev en klik vervolgens op Implementeren.

   

   Belangrijk

   Het implementeren van bundels en het uitvoeren van bundelbronnen voert code uit als de huidige gebruiker. Zorg ervoor dat u de code in de bundel vertrouwt, inclusief YAML, die configuratie-instellingen kan bevatten die opdrachten uitvoeren.

De status van de implementatie wordt uitgevoerd naar het venster Project-uitvoer.

De taak uitvoeren

Geïmplementeerde bundelbronnen worden vermeld onder Bundelbronnen. Klik op het afspeelpictogram dat is gekoppeld aan de taakresource om deze uit te voeren.

Navigeer naar Taakuitvoeringen vanaf de linkernavigatiebalk om de bundeluitvoering te zien. De naam van de bundeltaakuitvoering wordt bijvoorbeeld [dev someone] run-notebookvoorafgegaan door een voorvoegsel.

Volgende stappen

• Een bestaande resource toevoegen aan een bundel
• Samenwerken, beoordelen en implementeren in productie