Databricks not defteri biçimini yönetme

Varsayılan olarak, Databricks'teki not defterleri .ipynb (IPython veya Jupyter) biçiminde oluşturulur. Bunun yerine kaynak biçimini kullanmayı da seçebilirsiniz.

Not defterlerini çeşitli biçimlerde içeri ve dışarı aktarmaya devam edebilirsiniz. Bkz. Databricks not defterlerini içeri ve dışarı aktarma.

Not Defteri biçimleri

Databricks, not defterlerinin oluşturulmasını ve düzenlenmesini iki biçimde destekler: IPYNB (varsayılan) ve kaynak.

Git klasörleri kullanarak not defterleri de dahil olmak üzere kaynak dosyaları yönetebilirsiniz. Git klasörlerinde yalnızca belirli Databricks varlık türleri desteklenir. Biçim, aşağıdaki tabloda açıklandığı gibi not defterlerinin uzak depolara nasıl işlendiğini etkiler.

Not defteri kaynak biçimi Açıklama
kaynak .py, .scala, .r ve .sqlgibi kod diline işaret eden bir sonek ile yalnızca kaynak kodu yakalayan temel biçim.
IPYNB (Jupyter) Kaynak kodu, not defteri ortamını, görselleştirme tanımlarını, not defteri pencere öğelerini ve isteğe bağlı çıkışları yakalayan zengin bir biçim. IPYNB not defteri Databricks not defterleri tarafından desteklenen herhangi bir dilde kod içerebilir (py.ipynb bölümüne rağmen). IPYNB biçimini kullanarak, isteğe bağlı olarak not defteriyle birlikte not defterinin çıkışını da sürüm denetimi yapabilirsiniz.

IPYNB biçimi, uzak Git depolarında Databricks not defterleri için daha iyi bir görüntüleme deneyimini de destekler. GitHub veya GitLab kullanıyorsanız, pull requestlerde not defterlerinizdeki değişikliklerin gelişmiş diflerini sağlayan özellikleri etkinleştirerek, bir not defterindeki değişiklikleri görüntülemeyi ve kod incelemeyi kolaylaştırabilirsiniz.

IPYNB not defterlerinin zengin farkları için GitHub desteği hakkında daha fazla bilgi edinmek için bkz. Feature Preview: Rich Jupyter Notebook Diffs. IPYNB not defteri farkları için GitLab desteği hakkında daha fazla bilgi edinmek için bkz. Jupyter Notebook files.

Kaynak biçimli not defterlerini normal Python, Scala ve SQL dosyalarından ayırt etmek için Azure Databricks Python, Scala ve SQL not defterlerinin en üstüne "Databricks notebook source" açıklamasını ekler. Bu açıklama, Azure Databricks dosyayı betik dosyası yerine not defteri olarak doğru ayrıştırmasını sağlar.

Varsayılan not defteri biçimi ayarını değiştirme

IPYNB not defterleri, Azure Databricks yeni bir not defteri oluştururken varsayılan biçimdir.

Varsayılanı Azure Databricks kaynak biçimine değiştirmek için, Azure Databricks çalışma alanınızda oturum açın, sayfanın sağ üst kısmındaki profilinize tıklayın, ardından Settings öğesine tıklayın ve Developer adresine gidin. Düzenleyicisi ayarları başlığı altında varsayılan not defteri biçimini değiştirin.

Profil geliştirici ayarlarında varsayılan not defteri biçimini değiştirme

Not defteri biçimini dönüştürme

Azure Databricks kullanıcı arabirimi aracılığıyla mevcut bir not defterini başka bir biçime dönüştürebilirsiniz.

Var olan bir not defterini başka bir biçime dönüştürmek için:

  1. Not defterini çalışma alanınızda açın.

  2. Çalışma alanı menüsünden Dosya'yı seçin, Not defteri biçimi'ni seçin ve istediğiniz biçimi seçin. Jupyter (.ipynb) (Önerilen) veya Kaynak (.scala, .py, .sql, .r)seçebilirsiniz. Not defterinin geçerli biçimi gri renktedir ve yanında onay işareti vardır.

    Not defteri biçimi seçeneğini gösteren genişletilmiş çalışma alanı dosya menüsü.

Azure Databricks'da desteklenen not defterleri türleri hakkında daha fazla bilgi için bkz. Powerbricks not defterlerini içeri ve dışarı aktarma.

IPYNB not defteri çıkış işlemelerini yönetme

Çıktılar, tablo görüntülemeleri ve görselleştirmeler de dahil olmak üzere Databricks platformunda bir not defteri çalıştırmanın sonuçlarıdır. Kaynak denetimli klasörlerdeki IPYNB not defterleri için, not defteri çıktılarının uzak depoya nasıl işlendiğini yönetebilirsiniz.

.ipynb not defteri çıkışını işlemeyi onayla

Çıktılar yalnızca çalışma alanı yöneticisi bu özelliği etkinleştirmişse kaydedilebilir. Varsayılan olarak, Git klasörlerinin yönetim ayarı defter çıktısının kaydedilmesine izin .ipynb vermez. Çalışma alanı için yönetici ayrıcalıklarınız varsa bu ayarı değiştirebilirsiniz:

  1. Azure Databricks çalışma alanının üst çubuğunda kullanıcı adınıza tıklayın ve Ayarlar'ı seçin.

  2. Workspace admin altında, Development'e tıklayın.

  3. Repos bölümünde, Depoların IPYNB çıktısını dışa aktarmasına izin ver ayarını İzin ver: IPYNB çıktıları açılabilir olarak ayarlayın.

    Yönetim konsolu: Git klasörlerinin IPYNB çıkışlarını dışarı aktarmasına izin verin.

Önemli

Çıktılar dahil edildiğinde, görselleştirme ve gösterge paneli yapılandırmaları oluşturduğunuz .ipynb not defterlerine eklenir.

IPYNB not defteri çıkış yapıt işlemelerini denetleme

.databricks/commit_outputs Depodaki yapılandırma dosyası, hangi .ipynb notebook çıktılarının commit edildiğini kontrol eder. Bir çalışma alanı yöneticisi çıktı commit işlemlerine izin verdikten sonra, Git diyalogundan bu dosyayı oluşturabilirsiniz:

  1. .databricks/commit_outputs, .ipynb defter içeren ancak dosya içermeyen bir Git klasörü için açın.

  2. Diyalogun üstündeki bilgi uyarısında, commit_outputs yapılandırma dosyası oluştur seçeneğine tıklayın.

    Notebook taahhüt kullanıcı arabirimi: commit_outputs dosyasını oluştur düğmesi.

Ayrıca Dosya menüsünü kullanarak belirli bir IPYNB not defteri için çıktıları dahil edebilir veya hariç tutabilirsiniz. Yapılandırma dosyası yoksa, Azure Databricks seçiminizi yaptığınızda onu oluşturur. Git diyalogunda uyarıyı kapattıysanız bu seçeneği kullanın.

  1. Dosya menüsünde Defter çıktılarını işleme al seçeneğini belirleyin. Menü öğesi yalnızca bir çalışma alanı yöneticisi çıktı commit'lerine izin verdikten sonra bir Git klasöründeki IPYNB defterleri için kullanılabilir.

    Not Defteri düzenleyicisi: Not Defterleri çıktı durumu ve kontrolü kaydet.

  2. Commit çıktıları yapılandırma diyalogunda, Çıktıları Dahil veya Çıktıları Hariç Et seçeneğini seçin ve ardından Değiştir tuşuna tıklayın.

    Not defterlerinin çıktılarının işlenmesi iletişim kutusu. .