Aracılığıyla paylaş


Databricks Uygulamalarını kullanmaya başlama

Bu makale, Azure Databricks en iyi yöntemlerini izleyen bir şablon kullanarak Azure Databricks çalışma alanınızda basit bir uygulama oluşturmak için adım adım bir örnek kullanarak Databricks Uygulamaları'nı kullanmaya başlamanıza yardımcı olur.

Bu örnek size şunu gösterir:

  • Şablondan uygulama oluşturma
  • Uygulamayı dağıtıldıktan sonra görüntüleme
  • Daha fazla geliştirme için uygulama şablonunu bilgisayarınıza kopyalama
  • Uygulamayı yerel olarak çalıştırma
  • Uygulamayı çalışma alanınıza yeniden dağıtma

Bu makalenin sonunda, uygulamanızda yerel olarak yineleme yapabilecek ve güncelleştirmeleri Databricks'e dağıtabileceksiniz.

Önkoşullar

Bu öğreticiyi tamamlamadan önce Azure Databricks çalışma alanınızın ve yerel geliştirme ortamınızın doğru yapılandırıldığından emin olun. Bkz. Databricks Apps çalışma alanınızı ve geliştirme ortamınızı ayarlama.

1. Adım: Bağımlılıkları yükleme

Bir terminal açın ve aşağıdaki komutları çalıştırarak:

  • Örnek uygulamanın gerektirdiği Python kitaplıklarını yükleyin.
  • Uygulamanızın kaynak ve yapılandırma dosyaları için yerel bir dizin oluşturun.
pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world , uygulama dosyalarınızın yerel dizinidir.

2. Adım: Uygulamayı oluşturma

  1. Databricks çalışma alanınızda sol kenar çubuğunda + Yeni>Uygulama'ya tıklayın.

  2. Gradio Hello dünya şablonunu seçin.

    Merhaba Dünya şablonunu seçin

  3. Uygulamaya gradio-hello-world adını verin ve Yükle'ye tıklayın.

Bu, seçilen şablonu temel alan yeni bir uygulama oluşturur ve bunu çalışma alanınıza dağıtır.

3. Adım: Uygulamayı görüntüleme

Bir uygulama oluşturduktan sonra otomatik olarak başlatılır ve önizlemesini görüntülemek için kullanabileceğiniz bir URL görüntülenir. Genel Bakış sayfasında uygulama URL'sini ve dağıtım durumunu görüntüleyin:

Uygulama dağıtımından sonra uygulama ayrıntıları sayfasını görüntüleme

Uygulamayı görüntülemek için URL'ye tıklayın:

Merhaba dünya uygulamasının çıkışını yerel olarak görüntüleyin

Azure Databricks, uygulama adınızı ve çalışma alanı kimliğinizi temel alarak uygulama URL'sini otomatik olarak oluşturur. Uygulamayı oluşturduktan sonra URL'yi değiştiremezsiniz. Farklı bir URL'ye ihtiyacınız varsa, farklı bir ada sahip yeni bir uygulama oluşturun. Daha fazla bilgi için bkz. Uygulama URL'si.

4. Adım: Uygulamayı bilgisayarınıza kopyalama

Uygulamayı oluşturduktan sonra, kaynak kodu özelleştirmek için yerel makinenize indirebilirsiniz.

  1. Dosyaları eşitle altındaki komutları kopyalayın:

    Uygulama oluşturulduktan sonra uygulama ayrıntıları sayfasını görüntüleme

  2. Terminalde, oluşturduğunuz yerel dizine gradio-hello-world gidin ve kopyalanan komutları çalıştırın:

    databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app .
    
    ...
    Export complete
    
    gradio-hello-world % databricks sync --watch . /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app
    
    ...
    Initial Sync Complete
    

    İlk komut, çalışma alanınızdaki üç dosyayı yerel dizininize aktarır: app.py, app.yamlve requirements.txt. İkinci komut, yerel dosya değişikliklerini izleyen ve bunları otomatik olarak çalışma alanınıza yükleyen bir eşitleme işlemi başlatır.

    • app.py uygulamanın işlevselliğini ve kullanıcı arabirimini uygulayan kodu içerir.
    • app.yaml giriş noktası ve izinleri dahil olmak üzere uygulamanın yapılandırmasını tanımlar.
    • requirements.txt , uygulamanın gerektirdiği Python paketlerini listeler.

5. Adım: Uygulamayı yerel olarak değiştirme ve test edin

  1. İsteğe bağlı olarak, uygulamanızı yerel olarak özelleştirin ve geliştirin. Örneğin, verileri etkileşimli hale getirmek, tema veya stil seçenekleri eklemek veya veri yüklemelerine izin vermek için değiştirebilirsiniz app.py .

  2. Uygulamanızı test etmek için komutunu çalıştırın python app.py:

    python app.py
    
    Running on local URL:  http://127.0.0.1:7860
    ...
    
  3. Uygulamayı görüntülemek için tarayıcı penceresinde adresine http://127.0.0.1:7860 gidin.

  4. İsteğe bağlı olarak, uygulamayı çalıştırmak ve hatalarını ayıklamak için databricks apps run-local komutunu kullanın:

    databricks apps run-local --prepare-environment --debug
    

    Bu komut tüm bağımlılıkları yükler ve sanal ortamı hazırlar, ardından uygulamayı ve hata ayıklayıcıyı 5678 numaralı bağlantı noktasında başlatır. Uygulamayı görüntülemek için adresine http://localhost:8001 gidin.

    Visual Studio Code'da kesme noktaları ayarlamak için Python hata ayıklayıcı uzantısını yükleyin, ardından Çalıştır>Hata Ayıklamayı Başlat>Uzaktan Bağlan'a gidin.

6. Adım: Uygulamayı çalışma alanınıza yeniden dağıtma

Uygulamayı yeniden dağıtmak için, uygulamaya genel bakış sayfasındaki Databricks Uygulamalarına Dağıt altındaki komutu kopyalayın:

Uygulamayı dağıtmak için komutunu kopyalama

Komutunu yerel dizinden gradio-hello-world çalıştırın.

Komut şu şekilde başarılı olur:

{
  "create_time": "2026-02-03T23:25:38Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
  },
  "deployment_id": "01f10157a60a113e980014bebd5f4a03",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2026-02-03T23:25:41Z"
}

Dağıtım durumunu görüntülemek için uygulamanın Genel Bakış sayfasına gidin.

Sonraki adımlar

artık ilk uygulamanızı dağıtıp özelleştirdiğinize göre şunları yapabilirsiniz:

  • Uygulamanıza kimlerin erişebileceğini ve bunları düzenleyebileceğini yönetmek için yetkilendirmeyi yapılandırın.
  • Uygulamanızı Azure Databricks gizli dizileri veya Databricks SQL gibi Azure Databricks platform özellikleriyle tümleştirin.
  • Uygulamanızı çalışma alanınızdaki veya kuruluşunuzdaki diğer kullanıcılarla paylaşın.
  • Farklı çerçeveler ve özelliklerle denemeler yapmak için daha fazla uygulama şablonu keşfedin.