Databricks not defterlerinde temel düzenleme

Databricks not defteri, etkileşimli veri analizi için kod yazmanızı ve sonuçları görüntülemenizi sağlayan web tabanlı bir kod düzenleyicisidir. Bu sayfa, araç çubuğunda gezinme ve çeşitli hücre eylemleri gerçekleştirme de dahil olmak üzere Databricks'te not defterlerini kullanmanın temellerini kapsar.

Not defteri oluşturma

Yeni not defteri oluşturmak için, çalışma alanı kenar çubuğunda yeni düğmesine tıklayın veya herhangi bir klasörde not defteri oluşturma.

Not defterini açma

Not defterini açmak için çalışma alanı Arama işlevini kullanın veya çalışma alanı tarayıcısını kullanarak not defteri gidin ve not defterinin adına veya simgesine tıklayın.

Notebook 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, metin ve grafik şeklinde işlenen Markdown kodunu içerir. Kodunuzu belgele veya göstermek için Markdown'ı kullanın. Çalışmanızı yapılandırmak için not defterinize her iki türde hücre ekleyebilir veya kaldırabilirsiniz.

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

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

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 defteri varsayılan dilini değiştirmeye 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..." menülerin sağındaki mesaj.

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

İkon	Açıklama
	Tüm hücreleri çalıştır veya yürütmeyi durdur. Bu düğmenin adı, not defterinin durumuna bağlı olarak değişir.
	bilgisayar seçiciaçı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ı açın.
	DLT'i açın. Bu düğme yalnızca not defteri bir DLT işlem hattının parçasıysa görünür.
	izinler 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:

İkon	Açıklama
	Not defteri yorumlarını açın.
	MLflow not defteri denemesiniaçın.
	not defteri sürüm geçmişiniaçın.
	değişken gezgininiaçı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 kapsamındaki kitaplıklar, küme kitaplıkları ve Databricks Runtime'a dahil edilen kitaplıklar da dahil olmak üzere not defterinde kullanılabilen tüm Python kitaplıklarını gösterir. Yalnızca not defteri bir kümeye eklendiğinde kullanılabilir.

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 görünür.

Yeni hücre oluşturmak için, üst veya alttaki bir hücrenin üzerine gelin. Sırasıyla Kod veya Metin'ne tıklayarak bir kod veya Markdown hücresi oluşturun.

Hücre işlemleri

Hücre eylemleri menüsü, hücreleri çalıştırmanıza, kesmenize ve kopyalamanıza, hücreleri not defterinde taşımanıza ve kodu veya sonuçları gizlemenize olanak tanır.

Bir hücre çalıştır

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 süresini gösteren bir bildirim görüntülenir. Diğer ayrıntılar için imlecinizi bildirimin üzerine getirin.

Ayrıntılı çalıştırma bilgilerini varsayılan olarak göstermek için sağ üstteki profil resminize tıklayın. Ardından Ayarlar>Geliştirici>Ayrıntılı komut çalıştırma bilgilerini göster'e tıklayın.

Tablosal bir sonuç çıktınız varsa, kullanıcı arabiriminin "Son yenilendi" bölümünün üzerine gelerek de bu bilgilere erişebilirsiniz.

Seçili hücreleri çalıştırma

Tek bir hücreyi veya hücre koleksiyonunu çalıştırabilirsiniz. Tek bir hücre seçmek için hücrenin içinde herhangi bir yere tıklayın. Birden çok hücre seçmek için MacOS'ta Command tuşunu veya Windows'daki Ctrl tuşunu basılı tutun ve ekran görüntüsünde gösterildiği gibi metin alanının dışındaki hücreye tıklayın.

Seçili hücreleri çalıştırmak için, Çalıştır>ve hata ayıkla>Seçili hücreleri çalıştır veya MacOS'ta Command + Enter klavye kısayolunu veya Windows için Crtl + Enter kullanın. Bu komutun davranışı, not defterinin bağlı olduğu işlem kaynağına bağlıdır.

• Databricks Runtime 13.3 LTS veya üzerini çalıştıran bir işlem kaynağında, seçili hücreler ayrı ayrı yürütülür. Bir hücrede hata oluşursa, yürütme sonraki hücrelerle devam eder.
• Databricks Runtime 14.0 veya üzerini çalıştıran bir işlem kaynağında ya da bir SQL ambarında seçili hücreler toplu şekilde yürütülür. Herhangi bir hata yürütmeyi durdurur ve tek tek hücrelerin yürütülmesini iptal edemezsiniz. Tüm hücrelerin yürütülmesini durdurmak için Kesme düğmesini kullanabilirsiniz.

Seçili metni çalıştırma

Not defteri hücresinde kodu veya SQL deyimlerini vurgulayabilir ve yalnızca vurgulanan kodu çalıştırabilirsiniz. Bu, kod ve sorgularda hızlı bir şekilde yineleme yapmak istediğinizde kullanışlıdır.

1. Seçmek istediğiniz satırların üzerine tıklayın.

2. Çalıştır > Seçili metni çalıştır'ı seçin veya Ctrl+Shift+Enterklavye kısayolunu kullanın. Hiçbir metin vurgulanmamışsa, Seçili Metni Çalıştır geçerli satırı yürütür.

   Seçili satırları çalıştırma

bir hücrede karma dil kullanıyorsanız, seçime satırını eklemeniz gerekir.

Seçilen metni çalıştır vurgulanan seçimdeki daraltılmış kod varsa onu da yürütür.

%run, %pipve %sh gibi özel hücre komutları desteklenir.

Seçili metni çalıştır birden fazla çıkış sekmesi olan hücrelerde (veri profili veya görselleştirme tanımladığınız hücreler) kullanamazsınız.

Hücre simgeleri

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ştir veya devre dışı bırak.

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.

Bir hücreyi sil.

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ücreyi taşı

Hücreyi yukarı veya aşağı taşımak için sürükleme tutamacı simgesine tıklayın ve basılı tutun taşıyın.

Hücre eylemleri menüsünden Yukarı Taşı veya Aşağı Taşı seçeneklerini de seçebilirsiniz.

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

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

• Hücre eylemleri menüsünden Hücreyi kes veya Hücreyi kopyalaöğesini seçin.
• Klavye kısayollarını kullanın: kesmek için Command-X veya Ctrl-X ve kopyalamak için Command-C veya Ctrl-C.
• Not defterinin üst kısmındaki Düzenle menüsünü kullanın. Kes veya Kopyalaseç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ı sekmesinde veya penceresindeki bir not defterine yapıştırabilirsiniz. Hücreleri yapıştırmak için Command-V veya Ctrl-Vklavye kısayolunu kullanın. Hücreler geçerli hücrenin aşağısına yapıştırılır.

Kesme veya yapıştırma eylemlerini geri almak için, veya klavye kısayolunu ya da Kesilen hücreleri düzenleme Geri Al menü seçeneklerini kullanabilir veya Hücreleri yapıştırmayıdüzenleme geri al seçeneğini kullanabilirsiniz.

Bitişik hücreleri seçmek için, Markdown hücresine tıklayın ve Shift + Yukarı veya Shift Aşağı 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çin'i seçin veya Cmd+Akomut modu kısayolunu kullanın.

Kod açıklamaları ekleme

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.

Panoya bir hücre ekleyin

Bir Markdown hücresini veya tablolu sonuçlar içeren bir hücreyi panoya eklemek için, hücre eylemleri menüsünden "Panoya ekle" 'yi seçin. Daha fazla bilgi için bakınız not defterlerindeki panolar.

Bir hücreye bağlantı

Not defterinizdeki belirli bir komutun URL bağlantısını almak için odak modunu açın ve tarayıcı adres çubuğundan URL'yi kopyalayın. Odak modundan çıkmak için, tıklayın.

Databricks Yardımcısı'nı açma

Bir hücrede Databricks Yardımcısı metin kutusunu açmak için, hücrenin sağ üst köşesindeki Databricks Yardımcısı simgesi tıklayın.

Kodunuzla ilgili yardım veya öneriler almak için bunu bir kod hücresinde kullanabilirsiniz. Databricks Yardımcısı çalışma alanınızda etkinleştirilmelidir.