Aracılığıyla paylaş


Microsoft Fabric not defterlerini kullanma

Microsoft Fabric not defteri, Apache Spark işleri ve makine öğrenmesi denemeleri geliştirmeye yönelik birincil bir kod öğesidir. Veri bilimcileri ve veri mühendisleri tarafından zengin görselleştirmelerden ve Markdown metinlerinden yararlanan kod yazmak için kullanılan web tabanlı etkileşimli bir yüzeydir. Veri mühendisleri veri alımı, veri hazırlama ve veri dönüştürme için kod yazar. Veri bilimciler ayrıca denemeler ve modeller oluşturma, model izleme ve dağıtım gibi makine öğrenmesi çözümleri oluşturmak için not defterlerini kullanır.

Doku not defteriyle şunları yapabilirsiniz:

  • Sıfır kurulum eforuyla çalışmaya başlayın.
  • Sezgisel düşük kod deneyimiyle verileri kolayca keşfedin ve işleyin.
  • Yerleşik kurumsal güvenlik özellikleriyle verilerin güvenliğini sağlayın.
  • Güçlü Spark özelliklerini kullanarak ham biçimler (CSV, txt, JSON vb.), işlenen dosya biçimleri (parquet, Delta Lake vb.) genelinde verileri analiz edin.
  • Gelişmiş yazma özellikleri ve yerleşik veri görselleştirmesi ile üretken olun.

Bu makalede, veri bilimi ve veri mühendisliği deneyimlerinde not defterlerinin nasıl kullanılacağı açıklanmaktadır.

Not defterini çalıştırmanın güvenlik bağlamı

Bir not defterinin yürütülmesi, farklı senaryoları karşılamak için tam esneklikle Doku'da üç farklı yöntemle tetiklenebilir:

  • Etkileşimli çalıştırma: Kullanıcı, farklı UX girişleri aracılığıyla veya REST API'yi çağırarak yürütmeyi el ile tetikler. Yürütme, geçerli kullanıcının güvenlik bağlamı altında çalışıyor olabilir.
  • İşlem hattı olarak çalıştır etkinliği: Yürütme, Doku Data Factory işlem hattından tetikleniyor. Ayrıntılı adımları Not Defteri Etkinliği'nde bulabilirsiniz. Yürütme işlem hattı sahibinin güvenlik bağlamı altında çalışıyor olabilir.
  • Zamanlayıcı: Yürütme bir zamanlayıcı planından tetikleniyor. Yürütme, zamanlayıcı planını ayarlayan/güncelleştiren kullanıcının güvenlik bağlamı altında çalışıyor olabilir.

Bu yürütme seçeneklerinin farklı güvenlik bağlamı ile esnekliği farklı senaryoları ve gereksinimleri karşılamanıza olanak tanır, ancak not defterinizi tasarlayıp geliştirirken güvenlik bağlamının farkında olmanız gerekir; aksi takdirde beklenmeyen davranışlara ve hatta bazı güvenlik sorunlarına neden olabilir.

İlk kez bir not defteri oluşturulduğunda, kodu gözden geçirmeden çalıştırma riskini anımsatan bir uyarı iletisi gösterilir.

Not defterini çalıştırma uyarılarını gösteren ekran görüntüsü.

Güvenlik sorunlarından kaçınmanıza yardımcı olacak bazı en iyi yöntemler şunlardır:

  • Not defterini el ile çalıştırmadan önce Not Defteri ayarını açın ve değişiklik güncelleştirmesi için Hakkında panelinin altındaki Ayrıntı bölümüne bakın ve en son değişiklikle ilgili sorun olmadığınız konusunda emin olun.
  • İşlem hattına not defteri etkinliği eklemeden önce Not Defteri ayarını açın ve değişiklik güncelleştirmesi için Hakkında panelinin altındaki Ayrıntı bölümünü işaretleyin, en son değişikliği tamamladığınızdan emin olun. En son değişiklik hakkında emin değilseniz, işlem hattına eklemeden önce değişikliği gözden geçirmek için Not Defteri'ni açmanız daha iyi olur.
  • Zamanlayıcı planını güncelleştirmeden önce Not Defteri ayarını açın ve değişiklik güncelleştirmesi için Hakkında panelinin altındaki Ayrıntı bölümünü kontrol edin, en son değişikliği tamamladığınızdan emin olun. En son değişiklik hakkında emin değilseniz, zamanlayıcı planını güncelleştirmeden önce değişikliği gözden geçirmek için Not Defteri'ni açmanız daha iyi olur.
  • Güvenlik sorununu önlemek için çalışma alanını farklı bir aşamaya (geliştirme, test, üretim) ayırın ve farklı aşamanın erişimini denetleyin. Yalnızca güvendiğiniz kullanıcıyı üretim aşamasına ekleyin.

Not defterleri oluşturma

Yeni bir not defteri oluşturabilir veya var olan bir not defterini içeri aktarabilirsiniz.

Yeni not defteri oluşturma

Diğer standart Doku öğesi oluşturma işlemleri gibi, Doku Veri Madenciliği giriş sayfasından, Yeni çalışma alanı seçeneğinden veya Hub Oluştur'dan kolayca yeni bir not defteri oluşturabilirsiniz.

Mevcut not defterlerini içeri aktarma

Mevcut bir veya daha fazla not defterini yerel bilgisayarınızdan Veri Madenciliği veya Veri Bilimi giriş sayfasından Doku çalışma alanına aktarabilirsiniz. Doku not defterleri standart Jupyter Notebook .ipynb dosyalarını ve .py, .scala ve .sql gibi kaynak dosyaları tanır ve buna göre yeni not defteri öğeleri oluşturur.

Yeni menüsünde not defteri seçeneklerinin bulunacağı yeri gösteren ekran görüntüsü.

Not defterini dışarı aktarma

Not defterinizi diğer standart biçimlere aktarabilirsiniz. Synapse not defteri şu şekilde dışarı aktarılabilir:

  • Jupyter not defterleri için kullanılan standart not defteri dosyası (.ipynb).
  • Doğrudan tarayıcıdan açilebilen bir HTML dosyası (.html).
  • Python dosyası (.py).
  • Latex dosyası (.tex).

Not defterinin dışarı aktarıldığı yeri gösteren ekran görüntüsü.

Not defterini kaydetme

Doku'da, siz açıp düzenledikten sonra not defteri varsayılan olarak otomatik olarak kaydedilir; kod değişikliklerini kaybetme konusunda endişelenmenize gerek yoktur. Geçerli çalışma alanında veya başka bir çalışma alanında başka bir kopyayı kopyalamak için Kopyasını kaydet'i de kullanabilirsiniz.

Kopyanın kaydedileceği yeri gösteren ekran görüntüsü.

Not defterini el ile kaydetmeyi tercih ederseniz, not defteri öğenizin yerel bir dalı olması için El ile kaydetme seçeneğine geçebilir ve ardından değişikliklerinizi kaydetmek için Kaydet veya CTRL+sn tuşlarını kullanabilirsiniz.

El ile kaydetmenin değiştirileceği yeri gösteren ekran görüntüsü.

Ayrıca Düzenle -Kaydetme seçenekleri ->>El ile'yi seçerek el ile kaydetme moduna da geçebilirsiniz. Not defterinizin yerel bir dalını açmak ve el ile kaydetmek için Kaydet'i seçin veya Ctrl+s klavye kısayolunu kullanın.

Göl evleri ve not defterlerini bağlama

Doku not defterleri artık göl evleri ile yakın etkileşimleri destekliyor; Lakehouse gezgininden kolayca yeni veya mevcut bir göl evi ekleyebilirsiniz.

Lakehouse gezgininde farklı lakehouse'lara gidebilir ve bir lakehouse'ı sabitleyerek varsayılan olarak ayarlayabilirsiniz. Varsayılanınız daha sonra çalışma zamanı çalışma dizinine bağlanır ve yerel bir yol kullanarak varsayılan lakehouse'ı okuyabilir veya yazabilirsiniz.

Varsayılan göl evi sabitleme yerini gösteren ekran görüntüsü.

Not

Yeni bir göl evi sabitledikten veya varsayılan göl evi yeniden adlandırdıktan sonra oturumu yeniden başlatmanız gerekir.

Göl evi ekleme veya kaldırma

Göl evi adının yanındaki X simgesi seçildiğinde not defteri sekmesinden kaldırılır, ancak lakehouse öğesi çalışma alanında hala var olur.

Mevcut bir tane ekleyerek veya yeni bir göl evi oluşturarak not defterine daha fazla göl evi eklemek için Göl evi ekle'yi seçin.

Lakehouse dosyasını keşfetme

Göl görünümünün Tablolar ve Dosyalar bölümünün altındaki alt klasör ve dosyalar, lakehouse listesi ile not defteri içeriği arasındaki bir içerik alanında görünür. İçerik alanını yenilemek için Tablolar ve Dosyalar bölümünde farklı klasörler seçin.

Klasör ve dosya işlemleri

Sağ tıklamayla bir dosya (.csv, .parquet, .txt, .jpg, .png vb.) seçerseniz, Spark veya Pandas API'sini kullanarak verileri yükleyebilirsiniz. Odak hücresinin altına yeni bir kod hücresi oluşturulur ve eklenir.

Seçme dosyasından veya klasöründen farklı bir biçime sahip yolu kolayca kopyalayabilir ve kodunuzda buna karşılık gelen yolu kullanabilirsiniz.

Lakehouse'daki dosyaların bağlam menüsünü gösteren ekran görüntüsü.

Not defteri kaynakları

Not defteri kaynak gezgini, klasörlerinizi ve dosyalarınızı yönetmenize yardımcı olmak için Unix benzeri bir dosya sistemi sağlar. Kod modülleri, anlam modelleri ve görüntüler gibi küçük boyutlu dosyaları depolayabileceğiniz yazılabilir bir dosya sistemi alanı sunar. Yerel dosya sisteminizle çalışıyor gibi not defterindeki kodla bunlara kolayca erişebilirsiniz.

Not defteri kaynaklarının animasyonlu GIF'i.

Bu yerleşik klasör, her not defteri örneği için sistem tarafından önceden tanımlanmış bir klasördür. Geçerli not defterinin bağımlılıklarını depolamak için 500 MB'a kadar depolama alanı korur. Not defteri kaynaklarının temel özellikleri şunlardır:

  • Kullanıcı arabiriminde oluşturma/silme, karşıya yükleme/indirme, sürükleme/bırakma, yeniden adlandırma, yineleme ve arama gibi yaygın işlemleri kullanabilirsiniz.
  • Hızlı araştırma için gibi builtin/YourData.txt göreli yolları kullanabilirsiniz. yöntemi, mssparkutils.nbResPath tam yolu oluşturmanıza yardımcı olur.
  • Doğrulanmış verilerinizi Lakehouse'a yaz seçeneğiyle kolayca bir lakehouse'a taşıyabilirsiniz. Doku, hızlı bir şekilde başlamanıza yardımcı olmak için yaygın dosya türlerine yönelik zengin kod parçacıkları eklemiştir.
  • Bu kaynaklar, aracılığıyla mssparkutils.notebook.run()Başvuru not defteri çalıştırma durumunda da kullanılabilir.

Not

  • Doku şu anda .py, .whl, .jar, .txt, .json, .yml, .xml, .csv, .html, .png, .jpg ve .xlsx dosyaları gibi belirli dosya türlerinin kullanıcı arabirimi aracılığıyla karşıya yüklenmesini destekler. Kod aracılığıyla listede bulunmayan dosya türlerini içeren yerleşik klasöre yazabilirsiniz, ancak Doku not defterleri desteklenmeyen dosya türlerinde kod parçacıkları oluşturulmasını desteklemez.
  • Her dosya boyutunun 50 MB'tan az olması gerekir ve yerleşik klasör toplamda en fazla 100 dosya/klasör örneğine izin verir.
  • kullanırken mssparkutils.notebook.run()komutunu kullanarak mssparkutils.nbResPath hedef not defteri kaynağına erişin. "Yerleşik/" göreli yolu her zaman kök not defterinin yerleşik klasörüne işaret eder.

Not defterinde işbirliği yapma

Doku not defteri, aynı not defterini düzenleyen birden çok kullanıcıyı destekleyen işbirliğine dayalı bir öğedir.

Not defterini açtığınızda, varsayılan olarak birlikte düzenleme moduna girersiniz ve her not defteri düzenlemesi otomatik olarak kaydedilir. İş arkadaşlarınız aynı not defterini aynı anda açarsa profillerini, çalıştırma çıkışını, imleç göstergesini, seçim göstergesini ve düzenleme izlemesini görürsünüz. İşbirliği özelliklerini kullanarak programlamayı eşleştirme, uzaktan hata ayıklama ve özel ders senaryolarını kolayca gerçekleştirebilirsiniz.

Başka bir kullanıcı düzenlemesi içeren bir kod hücresi gösteren ekran görüntüsü.

Not defterini paylaşma

Not defteri paylaşmak, ekip üyeleriyle işbirliği yapmak için kullanışlı bir yoldur. Yetkili çalışma alanı rolleri not defterlerini varsayılan olarak görüntüleyebilir veya düzenleyebilir/çalıştırabilir. Belirtilen izinlere sahip bir not defterini paylaşabilirsiniz.

  1. Not defteri araç çubuğunda Paylaş'ı seçin.

    Paylaş'ın seçileceği yeri gösteren ekran görüntüsü.

  2. Bu not defterini görüntüleyebilen ilgili kişi kategorisini seçin. Alıcılar için Paylaş, Düzenle veya Çalıştır izinlerini seçebilirsiniz.

    İzinlerin seçileceği yeri gösteren ekran görüntüsü.

  3. Uygula'yı seçtikten sonra, not defterini doğrudan gönderebilir veya bağlantıyı başkalarına kopyalayabilirsiniz. Alıcılar daha sonra not defterini izin düzeyine göre verilen ilgili görünümle açabilir.

    Bağlantının oluşturulacağı ve gönderileceği yeri gösteren ekran görüntüsü.

  4. Not defteri izinlerinizi daha fazla yönetmek için Çalışma alanı öğe listesi>Diğer seçenekler'i ve ardından İzinleri yönet'i seçin. Bu ekrandan, mevcut not defteri erişimini ve izinlerini güncelleştirebilirsiniz.

    Çalışma alanında izinlerin nerede yönetileceğini gösteren ekran görüntüsü.

Kod hücresinde açıklama ekleme

Açıklama ekleme, işbirliğine dayalı senaryolar için kullanışlı bir diğer özelliktir. Doku şu anda hücre düzeyinde açıklamalar eklemeyi desteklemektedir.

  1. Not defteri araç çubuğundaki Açıklamalar düğmesini veya hücre açıklaması göstergesini seçerek Açıklamalar bölmesini açın.

    Açıklama'nın seçileceği yeri gösteren ekran görüntüsü.

  2. Kod hücresindeki kodu seçin, Açıklamalar bölmesinde Yeni'yi seçin, açıklama ekleyin ve ardından kaydetmek için Açıklama gönder'i seçin.

    Yeni'nin seçileceği yeri gösteren ekran görüntüsü.

  3. Gerekirse açıklamanızın yanındaki Diğer seçeneğini belirleyerek Açıklamayı düzenle, İş parçacığını çözümle ve İş parçacığını sil seçeneklerini bulun.

Açıklamadaki diğer kişileri etiketleme

"Etiketleme", bir açıklama yazışmasında bir kullanıcıdan bahsetmeyi ve bilgilendirmeyi, ayrıntılar üzerinde işbirliğini verimli bir şekilde geliştirmeyi ifade eder.

  1. Hücredeki kodun bir bölümünü ve yeni bir açıklama yazışması seçin.

  2. Belirli bir bölümle ilgili tartışma için birinden bahsetmek istiyorsanız, kullanıcı adını girin ve öneri listesinde doğru olanı seçin.

  3. İçgörülerinizi paylaşın ve Gönderin .

  4. Bir E-posta bildirimi tetiklenir ve kullanıcı bu hücreyi hızla bulmak için Açıklamaları Aç bağlantısına tıklar.

  5. Ayrıca, erişimi olmayan birini etiketlerken kullanıcıların izinlerini yetkilendirilin ve yapılandırın ve kod varlıklarınızın iyi yönetildiğinden emin olun.

Açıklamadaki diğer kişileri etiketlemeye ait animasyonlu GIF.

Not

Açıklama öğesi için, açıklamayı bir saat içinde güncelleştirirseniz etiketli kullanıcı artık e-posta bildirimi almaz. Ancak yeni etiketli kullanıcıya E-posta bildirimi gönderir.

Not defteri modunu değiştirme

Doku not defterleri, aralarında kolayca geçiş yapabileceğiniz iki modu destekler: Düzenleme modu ve Görüntüleme modu.

Mod değiştirme yerini gösteren ekran görüntüsü.

  • Düzenleme modu: Hücreleri düzenleyebilir, çalıştırabilir ve not defterinde başkalarıyla işbirliği yapabilirsiniz.
  • Görüntüleme modu: Yalnızca not defterinin hücre içeriğini, çıkışını ve açıklamalarını görüntüleyebilirsiniz. Not defterinde değişiklik yapılan tüm işlemler devre dışı bırakılır.