Not defteri kaynak denetimi ve dağıtımı

  • Makale

Bu makalede, Microsoft Fabric'teki not defterleri için Git tümleştirme ve dağıtım işlem hatlarının nasıl çalıştığı açıklanmaktadır. Deponuza bağlantı ayarlamayı, not defterlerinizi yönetmeyi ve bunları farklı ortamlara dağıtmayı öğrenin.

Not Defteri Git tümleştirmesi

Doku not defterleri, Azure DevOps ile kaynak denetimi için Git tümleştirmesi sunar. Git tümleştirmesi ile not defterinizi yedekleyebilir ve sürüm oluşturabilir, gerektiğinde önceki aşamalara geri dönebilir, Git dallarını kullanarak işbirliği yapabilir veya tek başına çalışabilir ve not defteri içerik yaşam döngünüzü tamamen Doku içinde yönetebilirsiniz.

Önemli

Bu özellik önizleme aşamasındadır.

Bağlantı kurma

Çalışma alanı ayarlarınızdan, değişiklikleri işlemek ve eşitlemek için deponuza kolayca bağlantı kurabilirsiniz. Bağlantıyı ayarlamak için bkz . Git tümleştirmesini kullanmaya başlama. Bağlandıktan sonra, not defterleri de dahil olmak üzere öğeleriniz Kaynak denetim masasında görünür.

Screenshot of workspace source control panel.

Not defteri örneklerini Git deposuna başarıyla kaydettikten sonra depoda not defteri klasör yapısını görürsünüz.

Artık çekme isteği oluşturma gibi gelecekteki işlemleri yürütebilirsiniz.

Git'te not defteri gösterimi

Aşağıdaki görüntü, depodaki her not defteri öğesinin dosya yapısına bir örnektir:

Screenshot of notebook Git repo file structure.

Not defteri öğesini Git deposuna kaydettiğinizde, not defteri kodu standart bir .ipynb dosyası yerine kaynak kod biçimine dönüştürülür. Örneğin, PySpark not defteri notebook-content.py dosyasına dönüştürülür. Bu yaklaşım, yerleşik fark özelliklerini kullanarak daha kolay kod incelemeleri yapılmasını sağlar.

Öğe içerik kaynağı dosyasında meta veriler (varsayılan lakehouse ve ekli ortam dahil), markdown hücreleri ve kod hücreleri korunur ve ayırt edilir. Bu yaklaşım, bir Doku çalışma alanına geri eşitlerken hassas bir kurtarmayı destekler.

Git ile eşitlenirken not defteri hücre çıkışı eklenmez.

Screenshot of notebook Git repo content format.

Dekont

  • Şu anda Not Defteri kaynaklarındaki dosyalar depoya işlenmez. Bu dosyaların işlenmesi, gelecek bir sürümde desteklenmektedir.
  • Depodan Doku çalışma alanına eşitlediğinizde, ekli ortam not defterinde kalır. Şu anda çalışma alanları arası başvuru ortamları desteklenmez. Not defterini çalıştırmak için içinde yeni bir ortama veya çalışma alanı varsayılan ayarlarına el ile eklemeniz gerekir.
  • Depodan Fabric çalışma alanına eşitlediğinizde varsayılan lakehouse kimliği not defterinde kalır. Varsayılan lakehouse ile bir not defteri işlerseniz, yeni oluşturulan bir lakehouse öğesine el ile başvurmanız gerekir. Daha fazla bilgi için bkz . Lakehouse Git tümleştirmesi.

Dağıtım işlem hatlarında not defteri

Not defteri kodunuzu geliştirme, test ve üretim gibi farklı ortamlara dağıtmak için Dağıtım işlem hattını da kullanabilirsiniz. Bu özellik geliştirme sürecinizi kolaylaştırmanıza, kalite ve tutarlılık sağlamanıza ve düşük kodlu basit işlemlerle el ile hataları azaltmanıza olanak sağlayabilir. Dağıtım kurallarını, not defterinizin varsayılan lakehouse'unu değiştirme gibi, dağıtıldıklarında not defterlerinizin davranışını özelleştirmek için de kullanabilirsiniz.

Önemli

Bu özellik önizleme aşamasındadır.

Dağıtım işlem hattını kullanarak not defteri dağıtımınızı tamamlamak için aşağıdaki adımları kullanın.

  1. Yeni bir dağıtım işlem hattı oluşturun veya mevcut bir dağıtım işlem hattını açın. (Daha fazla bilgi için bkz. Dağıtım işlem hatlarını kullanmaya başlayın.)

  2. Çalışma alanlarını dağıtım hedeflerinize göre farklı aşamalara atayın.

  3. Aşağıdaki örnekte gösterildiği gibi, farklı aşamalar arasındaki not defterleri dahil olmak üzere öğeleri seçin, görüntüleyin ve karşılaştırın.

    Screenshot of notebook in deployment pipeline.

  4. Not defterlerinizi Geliştirme, Test ve Üretim aşamalarında dağıtmak için Dağıt'ı seçin.

  5. (İsteğe bağlı.) Dağıtım işlemi için dağıtım kuralları oluşturmak üzere Dağıtım kuralları'na seçebilirsiniz. Dağıtım kuralları girdisi, bir dağıtım işlemi için hedef aşamadadır.

    Screenshot of deployment rules entry.

    Doku, dağıtım kurallarıyla dağıtım yaparken her not defteri örneği için varsayılan lakehouse parametresini parametreleştirmeyi destekler. Hedef varsayılan göl evi belirtmek için üç seçenek mevcuttur: Source lakehouse, N/A ve diğer lakehouse ile aynıdır.

    Screenshot of set default lakehouse.

    Bu kuralı ayarlayarak güvenli veri yalıtımı elde edebilirsiniz. Not defterinizin varsayılan lakehouse'u, dağıtım sırasında hedef olarak belirttiğiniz ile değiştirilir.

    Dekont

    Hedef ortamdaki diğer göl evlerini benimsemeyi seçtiğinizde, Lakehouse kimliği bir zorunluluktır. Göl evi URL bağlantısından bir göl evi kimliğini bulabilirsiniz.

  6. Dağıtım geçmişinden dağıtım durumunu izleyin.

İlgili içerik