Databricks Uygulamalarını kullanmaya başlama

Bu sayfa, Azure Databricks en iyi yöntemleri 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.

İpucu

Çalışma alanı eşitlemesi yerine git deposundan dağıtım yapmak istiyorsanız, şablonu atlayın ve oluşturma sırasında yapılandırılmış bir Git deposuyla özel bir uygulama oluşturun . Ardından dağıtmak için Git deposundan dağıtım yapma bölümüne bakın.

Ö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 Uygulama simgesine tıklayın. Uygulama değiştirici ve Databricks Uygulamaları'nı seçin.

  2. + Uygulama oluştur'a tıklayın.

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

    Merhaba Dünya şablonunu seçin

  4. Uygulamaya gradio-hello-world adını verin ve Uygulama oluştur'a 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 URL'sini uygulama adınıza ve çalışma alanı kimliğinize göre 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. IDE'nizde Düzenle 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ını ayarlamak için Python hata ayıklayıcı uzantısını yükleyin, ardından Run>Başlat Hata Ayıklama>Remote Attach seçeneğine 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.

7. Adım (İsteğe bağlı): Git deposundan dağıtma

Önceki adımlarda uygulamanızı dağıtmak için çalışma alanı eşitlemesi kullanılır. Daha ölçeklenebilir bir iş akışı için uygulama kodunuzu bir Git deposuna gönderin ve oradan dağıtın. Bu, sürüm denetimini kullanmanıza, ekip arkadaşlarınızla işbirliği yapmanıza ve isteğe bağlı olarak her gönderimde otomatik dağıtım yapmanıza olanak tanır.

  1. Dizininizde gradio-hello-world bir Git deposu başlatın ve Git sağlayıcınıza gönderin (örneğin, GitHub):

    git init
git add .
git commit -m "Initial app code"
git remote add origin https://github.com/your-org/gradio-hello-world
git push -u origin main

  2. Uygulamanızda Git deposunu yapılandırın:

    databricks apps create-update gradio-hello-world \
   --json '{"update_mask": "git_repository", "git_repository": {"url": "https://github.com/your-org/gradio-hello-world", "provider": "gitHub"}}'

  3. Özel depolar için, uygulamanın hizmet sorumlusu için bir Git kimlik bilgisi ekleyin. Git deposundan dağıtma başlığı altında CLI yönergelerine bakın.

  4. Git'ten dağıtma:

    databricks apps deploy gradio-hello-world \
   --json '{"git_source": {"branch": "main"}}'

Git dağıtımını yapılandırdıktan sonra deponuza göndererek ve dağıtma komutunu yeniden çalıştırarak yeniden dağıtabilirsiniz. Her gönderimde otomatik olarak yeniden dağıtmak için otomatik Git dağıtımlarını etkinleştirin. Bkz . Otomatik Git dağıtımlarını etkinleştirme(Beta).

Ek kaynaklar

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

  • Last updated on