Kılavuz: Çalışma alanında paket oluştur ve dağıt

Bu öğretici, çalışma alanında Databricks Varlık Paketlerini kullanmaya başlamanıza yardımcı olmak için bir iş ile paket oluşturma, dağıtma ve işi pakette çalıştırma konusunda size yol gösterir. Bunların tümü çalışma alanından gerçekleştirilir.

Çalışma alanında paket kullanma gereksinimleri için bkz. Çalışma alanı gereksinimlerinde Databricks Varlık Paketleri.

Paketler hakkında daha fazla bilgi için bkz. Databricks Varlık Paketleri nedir?.

Paket oluşturma

İlk olarak Databricks çalışma alanında bir paket oluşturun:

1. Paketinizi oluşturmak istediğiniz Git klasörüne gidin.

   Tavsiye

   Git klasörünü daha önce çalışma alanında düzenleyicide açtıysanız, Git klasörüne hızla gitmek için çalışma alanı tarayıcısı yazma bağlamları menüsünü kullanabilirsiniz. Bkz . Yazma bağlamları.

2. Oluştur düğmesine ve ardından Varlık paketi'ne tıklayın. Alternatif olarak, çalışma alanı ağacında Git klasörüne veya ilişkili kebabına sağ tıklayın ve Oluştur>Varlık paketi'ne tıklayın:

   

3. Varlık paketi oluştur iletişim kutusunda varlık paketine tamamen harika paket gibi bir ad verin. Paket adı yalnızca harf, sayı, kısa çizgi ve alt çizgi içerebilir. Projeyi boşalt'ı seçin ve oluştur ve dağıt'a tıklayın.

   

Bu, Git klasöründe bir Git yapılandırma dosyası ve gerekli Databricks Varlık Paketleri .gitignore dosyasını içeren bir databricks.yml başlangıç paketi oluşturur. Dosya, databricks.yml paket için ana yapılandırmayı içerir. Ayrıntılar için bkz. Databricks Varlık Paketi yapılandırması.

Notebook ekle

Ardından paketinize bir not defteri ekleyin. Aşağıdaki örnekteki not defteri "Merhaba Dünya!" yazdırır.

1. Not defteri ekleme proje kutucuğuna tıklayın. Alternatif olarak, içindekiler tablosunda paketin kebabına tıklayın ve ardından Oluştur>Not Defteri seçeneğini tıklayın.

2. Not defterini helloworld olarak yeniden adlandırın.

3. Not defterinin dilini Python olarak ayarlayın ve aşağıdakileri not defterinin hücresine yapıştırın:

   print("Hello World!")
   

İş tanımlama

Şimdi not defterini çalıştıran bir iş tanımlayın.

1. Dağıtımlar paneline geçmek için paketin dağıtım simgesine tıklayın.

   

2. Kaynakları paketle bölümünde Ekle'ye ve ardından Yeni iş tanımı'na tıklayın.

   

3. Mevcut pakete iş ekle iletişim kutusunun İş adı alanına run-notebook yazın. Ekle ve dağıt'a tıklayın.

4. Geliştirme hedef çalışma alanında oluşturulacak iş kaynağı hakkında bilgi içeren Geliştirmeye Dağıt onay iletişim kutusu görüntülenir. Dağıt’a tıklayın.

5. Dağıtımlar simgesinin üzerindeki klasör simgesine tıklayarak paketin dosyalarına geri dönün. İş için temel YAML ve bazı ek açıklamalı örnek iş görevi YAML ile bir iş kaynağı run-notebook.job.yml oluşturuldu.

6. İş tanımına bir not defteri görevi ekleyin. run-notebook.job.yml dosyasındaki örnek YAML'ı aşağıdakilerle değiştirin.

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

   

YAML'de iş tanımlama hakkında ayrıntılı bilgi için bkz. iş. Desteklenen diğer iş görev türleri için YAML söz dizimi için bkz. Databricks Varlık Paketlerinde işlere görev ekleme.

Paketi dağıtma

Ardından paketi dağıtın ve not defteri görevini içeren helloworld işi çalıştırın.

1. Hedefler altındaki paketin Dağıtımlar bölmesinde, hedef çalışma alanı seçili değilse dev için açılır menüyü tıklayın. Hedef çalışma alanları, paketin targetsdatabricks.ymleşlemesinde tanımlanır. Bkz. Databricks Varlık Paketi dağıtım modları.

   

2. Dağıt düğmesine tıklayın. Paket doğrulanır ve doğrulamanın ayrıntıları bir iletişim kutusunda görünür.

3. Geliştirme için dağıtma onayı iletişim kutusundaki dağıtım ayrıntılarını gözden geçirin, ardından Dağıt'a tıklayın.

   

   Önemli

   Paketleri dağıtma ve paket kaynaklarını çalıştırma, kodu geçerli kullanıcı olarak yürütür. Komutları çalıştıran yapılandırma ayarlarını içerebilen YAML de dahil olmak üzere paketteki koda güvendiğinizden emin olun.

Dağıtımın durumu Proje çıkış penceresine yazdırılır.

İşi başlat

Dağıtılan paket kaynakları, Paket kaynakları altında listelenir. İş kaynağını çalıştırmak için oynatma simgesine tıklayın.

Paket çalıştırmasını görmek için sol gezinti çubuğundan İş çalıştırmaları'na gidin. Paket işi çalıştırmasının adı önek olarak eklenir, örneğin [dev someone] run-notebook.

Sonraki Adımlar

• Pakete var olan bir kaynağı ekleme
• İşbirliği yapma, gözden geçirme ve üretime dağıtma