Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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.
Not
Ekim 2024'ten başlayarak Not Defteri git tümleştirmesi, yeni çalışma alanıyla eşitlenirken ekli Ortamın eşleme ilişkisinin kalıcı olmasını destekler. Bu, not defterini ve ekli ortamı git deposuna birlikte işleyip başka bir çalışma alanıyla eşitlediğinizde, yeni oluşturulan not defteriyle ortamın birbirine bağlanacağı anlamına gelir. Bu yükseltme, git'te sürümü sunulan mevcut Not Defterlerini ve bağımlı Ortamları etkiler; not defteri meta veri içeriğindeki ekli ortamın Fiziksel kimliği mantıksal kimlikle değiştirilir, değişiklik fark görünümüne yansıtılı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.
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:
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.
Not
- Şu anda Not Defteri kaynaklarındaki dosyalar depoya işlenmez. Bu dosyaların işlenmesi, gelecek bir sürümde desteklenmektedir.
- Aynı çalışma alanında not defterlerini ve bağımlı ortamlarını yönetmenizi ve hem not defterini hem de ortam öğelerini sürüm denetimi için git'i kullanmanızı öneririz. Doku Git sistemi, not defterini ve ekli ortamı yeni çalışma alanlarıyla eşitlerken eşleme ilişkisini işler.
- 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.
Not
- Şimdi dağıtım işlem hattının yeni tasarımını kullanıyorsunuz, 'Yeni Dağıtım işlem hattı' kapatılarak eski kullanıcı arabirimine erişilebilir.
- Ekim ayından başlayarak, Doku not defteri bir sonraki aşamaya dağıtım yaparken varsayılan lakehouse'u ve ekli ortamı aynı çalışma alanına bağlayan otomatik bağlama özelliğini destekler. Değişiklik, dağıtım işlem hattındaki mevcut not defterlerini etkiler.
- Varsayılan lakehouse ve ekli ortam (tüm bağımlı öğeler aynı çalışma alanında olduğunda) hedef çalışma alanında yeni oluşturulan öğelerle değiştirilir; sonraki dağıtım turunda not defteri meta veri değişikliği fark görünümünde vurgulanır.
- Otomatik olarak bağlanan lakehouse'un geçersiz kılınabilmesi için varsayılan lakehouse için dağıtım kuralları ayarlayabilirsiniz.
- Bilinen sorun: Not defterindeki donmuş hücre durumu dağıtım sırasında kaybolur. Şu anda ilgili görevler üzerinde çalışıyoruz.
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.
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.)
Çalışma alanlarını dağıtım hedeflerinize göre farklı aşamalara atayın.
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. Önceki aşama ile geçerli aşama arasındaki öğe sayısının değiştiğini gösteren vurgulanan rozet.
Not defterlerinizi Geliştirme, Test ve Üretim aşamalarında dağıtmak için Dağıt'ı seçin.
(İ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.
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 vardır: Source lakehouse, N/A (varsayılan göl evi yok) ve diğer lakehouse ile aynıdır.
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.
Not
Dağıtım kurallarında varsayılan lakehouse ayarlanırken Lakehouse kimliğine sahip olmalıdır. Lakehouse kimliğini öğe URL'si bağlantısından alabilirsiniz. Dağıtım kurallarının önceliği otomatik bağlamadan daha yüksektir; dağıtım kuralı yapılandırıldığında otomatik olarak bağlanan lakehouse'un üzerine yazılır.
Dağıtım geçmişinden dağıtım durumunu izleyin.
