Databricks not defteri arabirimi ve denetimleri

Not defteri araç çubuğunda, not defterini yönetmek ve düzenlemek için kullanabileceğiniz menüler ve simgeler bulunur.

Not defteri adının yanında, not defterinin varsayılan dilini değiştirmenize olanak sağlayan düğmeler bulunur ve not defteri bir Databricks Git klasörüne eklenmişse Git iletişim kutusunu açın.

Not defterinin önceki sürümlerini görüntülemek için "Son düzenleme..." iletisini seçin.

Güncelleştirilmiş hücre tasarımı

Önemli

Bu özellik Genel Önizlemededir.

Güncelleştirilmiş bir hücre tasarımı kullanılabilir. Bu sayfa, hücre tasarımının her iki sürümünün de nasıl kullanılacağı hakkında bilgi içerir. Yeni kullanıcı arabirimine yönlendirme ve sık sorulan soruların yanıtları için bkz . Yeni hücre kullanıcı arabirimine yönlendirme.

Yeni hücre tasarımını etkinleştirmek veya devre dışı bırakmak için çalışma alanında düzenleyici ayarları sayfasını açın. Kenar çubuğunda Geliştirici'ye tıklayın. Deneysel özellikler'in altında Yeni hücre kullanıcı arabirimi'ni açın.

Not defteri hücreleri

Not defterleri iki hücre türünden oluşan bir koleksiyon içerir: kod hücreleri ve Markdown hücreleri. Kod hücreleri çalıştırılabilir kod içerir. Markdown hücreleri, hücre yürütülürken metin ve grafikler halinde işlenen markdown kodu içerir ve kodunuzu belgeleyip göstermek için kullanılabilir. Çalışmanızı yapılandırmak için not defterinize hücre ekleyebilir veya kaldırabilirsiniz.

Tek bir hücreyi, bir hücre grubunu veya not defterinin tamamını aynı anda çalıştırabilirsiniz. Not defteri hücresi en fazla 10 MB içerebilir. Not defteri hücre çıkışı 20 MB ile sınırlıdır.

Not defteri araç çubuğu simgeleri ve düğmeleri

Araç çubuğunun sağındaki simgeler ve düğmeler aşağıdaki tabloda açıklanmıştır:

Simge	Açıklama
	Tüm hücreleri çalıştırın veya yürütmeyi durdurun. Bu düğmenin adı, not defterinin durumuna bağlı olarak değişir.
	İşlem seçiciyi açın. Not defteri bir kümeye veya SQL ambara bağlandığında, bu düğme işlem kaynağının adını gösterir.
	İş zamanlayıcıyı açın.
	Delta Live Tables'i açın. Bu düğme yalnızca not defteri Bir Delta Live Tables işlem hattının parçasıysa görünür.
	İzinler iletişim kutusunu açın.

Sağ kenar çubuğu eylemleri

Not defterinin sağ kenar çubuğunda, aşağıdaki tabloda açıklandığı gibi çeşitli eylemler kullanılabilir:

Simge	Açıklama
	Not defteri açıklamalarını açın.
	MLflow not defteri denemesini açın.
	Not defteri sürüm geçmişini açın.
	Değişken gezginini açın. (Databricks Runtime 12.2 LTS ve üzeri ile Python değişkenleri için kullanılabilir.)
	Python ortam panelini açın. Bu panel, not defteri kapsamlı kitaplıklar, küme kitaplıkları ve Databricks Runtime'a dahil edilen kitaplıklar dahil olmak üzere not defteri için kullanılabilen tüm Python kitaplıklarını gösterir. Yalnızca not defteri bir kümeye eklendiğinde kullanılabilir.

Verilere göz atma

Önemli

Bu özellik Genel Önizlemededir.

Not defterinde kullanılabilen tabloları ve birimleri keşfetmek için, not defterinin sol tarafına tıklayarak şema tarayıcısını açın. Daha fazla ayrıntı için bkz . Verilere göz atma.

Hücre eylemleri menüsü

Hücre eylemleri menüsü, hücreleri kesmenize ve kopyalamanıza, hücreleri not defterinde taşımanıza ve kodu veya sonuçları gizlemenize olanak tanır. Menünün özgün kullanıcı arabiriminde ve yeni kullanıcı arabiriminde farklı bir görünümü vardır. Bu bölüm her iki sürüm için de yönergeler içerir.

Çalışma alanınızda Databricks Yardımcısı etkinleştirildiyse, kodunuzla ilgili yardım veya öneriler almak için bunu bir kod hücresinde kullanabilirsiniz. Bir hücrede Databricks Yardımcısı metin kutusunu açmak için, hücrenin sağ üst köşesindeki Databricks Yardımcısı simgesine tıklayın.

Kod ile markdown arasındaki bir hücreyi kolayca değiştirebilir veya hücrenin sağ üst köşesindeki hücre dili düğmesini kullanarak kod hücresinin dilini değiştirebilirsiniz.

Hücre eylemleri menüsü (özgün kullanıcı arabirimi)

Bu menüden kod hücrelerini de çalıştırabilirsiniz:

Hücre eylemi menüsü, bir hücreyi gizlemenize veya bir hücreyi silmenize olanak sağlayan düğmeler de içerir.

Markdown hücreleri için hücreyi panoya ekleme seçeneği de vardır. Daha fazla bilgi için bkz . Not defterlerindeki panolar.

Yeni kullanıcı arabirimindeki hücrelerle çalışma

Aşağıdaki ekran görüntüsünde not defteri hücresinin sağ üst kısmında görünen simgeler açıklanmaktadır:

Dil seçici: Hücrenin dilini seçin.

Databricks Yardımcısı: Hücredeki kod önerileri için Databricks Yardımcısı'nı etkinleştirin veya devre dışı bırakın.

Hücre odağı: Düzenlemeyi kolaylaştırmak için hücreyi büyütün.

Hücre eylemleri menüsünü görüntüle: Hücre eylemleri menüsünü açın. Bu menüdeki seçenekler kod ve Markdown hücreleri için biraz farklıdır.

Yeni kullanıcı arabiriminde kod hücrelerini çalıştırmak için, kod hücresinin sol üst kısmındaki aşağı oka tıklayın.

Bir hücre çalıştırıldıktan sonra, hücre çalıştırma menüsünün sağ tarafında, hücrenin en son çalıştırıldığı zamanı ve çalıştırmanın süresini gösteren bir bildirim görüntülenir. Diğer ayrıntılar için imlecinizi bildirimin üzerine getirin.

Panoya bir Markdown hücresi veya tablo sonuçları içeren bir hücre eklemek için, hücre eylemleri menüsünde Panoya ekle'yi seçin. Daha fazla bilgi için bkz . Not defterlerindeki panolar.

Hücreyi silmek için hücrenin sağındaki çöp kutusu simgesine tıklayın. Bu simge yalnızca imlecinizi hücrenin üzerine getirdiğinizde görünür.

Hücredeki koda açıklama eklemek için kodu vurgulayın. Hücrenin sağ tarafında bir açıklama simgesi görüntülenir. Açıklama kutusunu açmak için simgeye tıklayın.

Hücreyi yukarı veya aşağı taşımak için, hücrenin sol üst köşesinin dışına tıklayıp basılı tutun ve hücreyi yeni konuma sürükleyin. Hücre eylemleri menüsünden Yukarı taşı veya Aşağı taşı'yı da seçebilirsiniz.

Hücre oluşturma

Not defterlerinde iki tür hücre vardır: kod ve Markdown. Markdown hücrelerinin içeriği HTML olarak işlenir. Örneğin, bu kod parçacığı birinci düzey başlık için işaretleme içerir:

%md ### Libraries
Import the necessary libraries.

gösterildiği gibi işlenir:

Hücre oluşturma (özgün kullanıcı arabirimi)

Özgün kullanıcı arabiriminde yeni bir hücre oluşturmak için, üst veya alttaki bir hücrenin üzerine gelin ve simgeye tıklayın. Not defteri hücre menüsünü de kullanabilirsiniz: Üzerine Hücre Ekle veya Altına Hücre Ekle'ye tıklayıp seçin.

Kod hücresi için hücreye kod yazması gerekir. Markdown hücresi oluşturmak için, hücrenin dil düğmesinden Markdown'ı seçin veya hücrenin en üstüne yazın%md.

Hücre oluşturma (yeni kullanıcı arabirimi)

Yeni kullanıcı arabiriminde yeni bir hücre oluşturmak için, üst veya alttaki bir hücrenin üzerine gelin. Sırasıyla bir kod veya Markdown hücresi oluşturmak için Kod veya Metin'e tıklayın.

Hücreleri kesme, kopyalama ve yapıştırma

Hücreleri kesmek ve kopyalamak için çeşitli seçenekler vardır. Safari tarayıcısını kullanıyorsanız yalnızca klavye kısayolları kullanılabilir.

• Özgün kullanıcı arabirimindeki veya yeni kullanıcı arabirimindekihücre eylemleri menüsünden Hücreyi kes veya Hücreyi kopyala'yı seçin.
• Klavye kısayollarını kullanın: Command-X veya Ctrl-X kesmek ve veya Ctrl-CCommand-C kopyalamak için.
• Not defterinin üst kısmındaki Düzenle menüsünü kullanın. Kes veya Kopyala'yı seçin.

Hücreleri kestikten veya kopyaladıktan sonra, bu hücreleri not defterinin başka bir yerine, farklı bir not defterine veya farklı bir tarayıcı sekmesindeki veya penceresindeki bir not defterine yapıştırabilirsiniz. Hücreleri yapıştırmak için klavye kısayolunu Command-V veya Ctrl-Vkullanın. Hücreler geçerli hücrenin altına yapıştırılır.

Kesme veya yapıştırma eylemlerini geri almak için klavye kısayolunu Command-Z veya Ctrl-Z kesme hücrelerini düzenleme > veya Yapıştırma hücrelerini düzenleme > menü seçeneklerini kullanabilirsiniz.

Bitişik hücreleri seçmek için, bir Markdown hücresine tıklayın ve yukarı veya Aşağı Kaydır'ı + kullanarak üstündeki veya altındaki hücreleri seçin. Seçili hücreleri grup olarak kopyalamak, kesmek, yapıştırmak veya silmek için düzenleme menüsünü kullanın. Tüm hücreleri seçmek için Düzenle Tüm hücreleri seç'i > seçin veya Cmd+A komut modu kısayolunu kullanın.

Not defteri içindekiler tablosu

Otomatik olarak oluşturulan içindekiler tablosunu görüntülemek için not defterinin sol üst köşesindeki simgeye (sol kenar çubuğu ile en üstteki hücre arasında) tıklayın. İçindekiler tablosu, not defterinde kullanılan Markdown başlıklarından oluşturulur. Yeni kullanıcı arabirimini kullanıyorsanız, içindekiler tablosunda başlıkları olan hücreler de görünür.

Hücre görüntüleme seçenekleri

Not defterleri için üç görüntüleme seçeneği vardır. Görüntüleme seçeneğini değiştirmek için Görünüm menüsünü kullanın.

• Standart görünüm: sonuçlar kod hücrelerinin hemen ardından görüntülenir.
• Yalnızca sonuçlar: yalnızca sonuçlar görüntülenir.
• Yan yana: kod ve sonuç hücreleri yan yana görüntülenir.

Yeni kullanıcı arabiriminde, eylemler hücre cilt payı içindeki simgelerden (hücrenin sağındaki ve solundaki alan) kullanılabilir. Örneğin, bir hücreyi yukarı veya aşağı taşımak için sol cilt payı içindeki kavrama noktaları kullanın. Bir hücreyi silmek için sağ cilt payı içindeki çöp kutusu simgesini kullanın.

Daha kolay düzenleme yapmak için odak modu simgesine tıklayarak hücreyi tam genişlikte görüntüleyin. Odak modundan çıkmak için öğesine tıklayın . Ayrıca, Ortalanmış Düzeni Görüntüle'yi > kapatarak hücrenin görüntülenen genişliğini de genişletebilirsiniz.

Not defterindeki tüm hücreleri endüstri standardı satır uzunluklarına ve aralıklarına göre otomatik olarak biçimlendirmek için, Not defterini biçimlendirmeyi düzenle'yi > seçin.

Satır ve komut numaraları

Satır numaralarını veya komut numaralarını göstermek veya gizlemek için Görünüm menüsünden Satır numaraları'nı veya Komut numaraları'nı seçin. Satır numaraları için Control+L klavye kısayolunu da kullanabilirsiniz.

Satır veya komut numaralarını etkinleştirirseniz, Databricks tercihinizi kaydeder ve bunları bu tarayıcı için diğer tüm not defterlerinizde gösterir.

Satır ve komut numaraları (özgün kullanıcı arabirimi)

Hücrelerin üzerindeki komut numaraları bu komuta bağlanır. Bir hücrenin komut numarasına tıklarsanız, URL'niz bu komuta bağlanacak şekilde güncelleştirilir. Not defterinizdeki belirli bir komutun URL bağlantısını almak için komut numarasına sağ tıklayın ve Bağlantı Adresini Kopyala'yı seçin.

Satır ve komut numaraları (yeni kullanıcı arabirimi)

Yeni kullanıcı arabiriminde satır numaraları varsayılan olarak kapalıdır. Bunları açmak için Satır numaralarını görüntüle'yi > seçin. Bir hücre hata durumundayken, seçimden bağımsız olarak satır numaraları görüntülenir.

Komut numaralarını değiştirmek için Komut numaralarını görüntüle'yi > seçin.

Yeni kullanıcı arabirimi, hücre komut numarası bağlantılarını içermez. Not defterinizdeki belirli bir komutun URL bağlantısını almak için, odak modunu açmak için tıklayın ve tarayıcı adres çubuğundan URL'yi kopyalayın. Odak modundan çıkmak için öğesine tıklayın .

Hücre başlığı ekleme

Özgün kullanıcı arabirimini kullanarak bir hücreye başlık eklemek için, hücre eylemleri menüsünden Başlığı Göster'i seçin.

Yeni kullanıcı arabirimini kullanarak bir hücreye başlık eklemek için aşağıdakilerden birini yapın:

• Hücrenin üst kısmında gösterilen hücre numarasını tıklatın ve başlığı yazın.
• Hücre eylemleri menüsünden Başlık ekle'yi seçin.

Yeni kullanıcı arabirimiyle, not defterinin içindekiler tablosunda başlıkları olan hücreler görüntülenir.

Not defterlerini koyu modda görüntüleme

Not defterlerini koyu modda görüntülemeyi seçebilirsiniz. Koyu modu açmak veya kapatmak için Temayı Görüntüle'yi > ve açık tema veya Koyu tema'yıseçin.

Hücre içeriğini gizleme ve gösterme

Hücre içeriği, hücre kodundan ve hücre çalıştırılarak oluşturulan sonuçlardan oluşur. Hücrenin sağ üst köşesindeki hücre eylemleri menüsünü kullanarak hücre kodunu ve sonucunu gizleyebilir ve gösterebilirsiniz.

İlgili işlevler için bkz . Daraltılabilir başlıklar.

Hücre içeriğini gizleme ve gösterme (özgün kullanıcı arabirimi)

Hücre kodunu veya sonuçları gizlemek için kodu gizle veya Sonucu Gizle'ye tıklayın ve seçin. Ayrıca, bir hücrenin yalnızca ilk satırını görüntülemeyi seçebilirsiniz .

Gizli hücre kodunu veya sonuçlarını göstermek için Bağlantıları göster'e tıklayın:

Hücre içeriğini gizleme ve gösterme (yeni kullanıcı arabirimi)

Hücre kodunu veya sonuçlarını gizlemek için hücrenin sağ üst kısmındaki kebap menüsüne tıklayın ve Kodu gizle veya Sonucu gizle'yi seçin. Hücrenin yalnızca ilk satırını görüntülemek için Hücreyi daralt'ı da seçebilirsiniz. Daraltılmış bir hücreyi genişletmek için Hücreyi genişlet'i seçin.

Gizli hücre kodunu veya sonuçlarını göstermek için göster simgesine tıklayın: .

Daraltılabilir başlıklar

Markdown başlıkları içeren hücrelerden sonra görüntülenen hücreler başlık hücresine daraltılabilir. Not defteri genelinde Markdown başlıkları içeren hücrelerden sonra hücreleri genişletmek veya daraltmak için Görünüm menüsünden Tüm başlıkları daralt'ı seçin. Bu bölümün geri kalanında hücrelerin bir alt kümesini genişletme veya daraltma işlemleri açıklanmaktadır.

İlgili işlevler için bkz . Hücre içeriğini gizleme ve gösterme.

Başlıkları genişletme ve daraltma (özgün kullanıcı arabirimi)

Görüntüde, aşağıdaki iki hücrenin daraltıldığı düzey iki başlık MLflow kurulumu gösterilmektedir.

Başlıkları genişletmek ve daraltmak için ve -öğesine + tıklayın.

Başlıkları genişletme ve daraltma (yeni kullanıcı arabirimi)

Görüntüde, aşağıdaki iki hücrenin daraltıldığı düzey iki başlık MLflow kurulumu gösterilmektedir.

Başlıkları genişletmek ve daraltmak için imlecinizi Markdown hücresinin üzerine getirin. Hücrenin solunda görünen oka tıklayın.

Not defterleri için işlem kaynakları

Bu bölüm, not defteri işlem kaynaklarına yönelik seçenekleri kapsar. Bir databricks kümesinde not defteri çalıştırabilirsiniz veya SQL komutları için SQL analizi için iyileştirilmiş bir işlem türü olan SQL ambarı kullanma seçeneğiniz de vardır.

Kümeye not defteri ekleme

Bir not defterini kümeye eklemek için KÜME düzeyiNE EKLEYEBILIRSINIZ iznine sahip olmanız gerekir.

Önemli

Not defteri bir kümeye bağlı olduğu sürece, not defterinde CAN RUN iznine sahip olan tüm kullanıcıların kümeye erişim izni örtükdür.

Bir kümeye not defteri eklemek için, not defteri araç çubuğunda işlem seçiciye tıklayın ve açılan menüden bir küme seçin.

Menüde, yakın zamanda kullandığınız veya çalışmakta olan kümeler gösterilir.

Kullanılabilir tüm kümeler arasından seçim yapmak için Diğer...'e tıklayın. Açılan menüyü görüntülemek için küme adına tıklayın ve var olan bir kümeyi seçin.

Açılan menüden Yeni kaynak oluştur... öğesini seçerek de yeni bir küme oluşturabilirsiniz.

Önemli

Ekli not defterinde aşağıdaki Apache Spark değişkenleri tanımlanmıştır.

Sınıf	Değişken Adı
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession (Spark 2.x)	spark

, SparkContextveya SQLContextoluşturmayınSparkSession. Bunu yapmak tutarsız davranışlara yol açar.

SQL ambarı ile not defteri kullanma

Not defteri bir SQL ambara eklendiğinde, SQL ve Markdown hücrelerini çalıştırabilirsiniz. Başka bir dilde (Python veya R gibi) bir hücre çalıştırmak hataya neden olur. SQL ambarında yürütülen SQL hücreleri, SQL ambarı sorgu geçmişinde görünür. Sorguyu çalıştıran kullanıcı, çıktının en altındaki geçen süreye tıklayarak not defterinden sorgu profilini görüntüleyebilir.

Not defterini çalıştırmak için Pro veya Sunucusuz SQL ambarı gerekir. Çalışma alanına ve SQL ambarı'na erişiminiz olmalıdır.

Bir not defteri SQL ambara eklendiğinde pencere öğeleri farklı çalışır. Ayrıntılar için bkz . SQL ambarı üzerinde Databricks pencere öğelerini kullanma.

Sql ambarlarına not defteri eklemek için aşağıdakileri yapın:

1. Not defteri araç çubuğunda işlem seçiciye tıklayın. Açılan menüde çalışmakta olan veya yakın zamanda kullandığınız işlem kaynakları gösterilir. SQL ambarları ile işaretlenir.

2. Menüden bir SQL ambarı seçin.

   Kullanılabilir tüm SQL ambarlarını görmek için açılan menüden Diğer... öğesini seçin. Not defteri için kullanılabilir işlem kaynaklarını gösteren bir iletişim kutusu görüntülenir. SQL Ambarı'nı seçin, kullanmak istediğiniz ambarı seçin ve Ekle'ye tıklayın.

   

Ayrıca iş akışı veya zamanlanmış iş oluşturduğunuzda SQL not defteri için işlem kaynağı olarak bir SQL ambarı seçebilirsiniz.

SQL ambarlarının sınırlamaları şunlardır:

• Bir SQL ambarına eklendiğinde, yürütme bağlamları 8 saatlik boşta kalma zaman aşımına sahiptir.
• Döndürülen sonuçların boyut üst sınırı 10.000 satır veya 2 MB'tır (hangisi daha küçükse).

Not defterini ayırma

Bir not defterini işlem kaynağından ayırmak için, not defteri araç çubuğunda işlem seçiciye tıklayın ve yan menüyü görüntülemek için listedeki ekli kümenin veya SQL ambarı'nın üzerine gelin. Yan menüden Ayır'ı seçin.

Ayrıca, küme ayrıntıları sayfasındaki Not Defterleri sekmesini kullanarak not defterlerini bir kümeden ayırabilirsiniz.

Not defterini ayırdığınızda yürütme bağlamı kaldırılır ve tüm hesaplanan değişken değerleri not defterinden temizlenir.

İpucu

Azure Databricks, kullanılmayan not defterlerini kümelerden ayırmanızı önerir. Bu, sürücüde bellek alanı boşaltıyor.

Web terminali ve Databricks CLI kullanma

Web terminalini not defterinde açmak için sağ kenar çubuğunun alt kısmına tıklayın .

Web terminalinde Databricks CLI kullanma

Databricks Runtime 15.0'dan başlayarak, not defterindeki web terminalinden Databricks CLI'yi kullanabilirsiniz.

Gereksinimler

• Not defterinin Tek kullanıcılı veya Yalıtımsız paylaşılan erişim modunda bir kümeye eklenmesi gerekir.
• CLI, Özel Bağlantı için etkinleştirilen çalışma alanlarında kullanılamaz.

Yüklü CLI her zaman en son sürümdür. Kimlik doğrulaması geçerli kullanıcıyı temel alır.

Cli'yi not defteri hücresinden kullanamazsınız. Not defterindeki gibi %sh databricks ... komutlar Databricks Runtime 15.0 veya üzeri ile çalışmaz.