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

Bu makalede, Microsoft Fabric'te not defterleriyle Git tümleştirme ve dağıtım işlem hatlarının nasıl kullanılacağı açıklanmaktadır. Bir depoya bağlanmayı, not defteri kaynak kodunu yönetmeyi ve not defterlerini ortamlar arasında dağıtmayı öğrenirsiniz.

Başlamadan önce

• Not defteri kaynak denetimi adımlarını tamamlamadan önce çalışma alanınızı Git'e bağlayın. Kurulum yönergeleri için bkz. Git tümleştirmesini kullanmaya başlama.
• Geliştirme aşamasında değil, hedef aşamada (örneğin Test veya Üretim) not defteri dağıtım kuralları oluşturun.
• Dağıtım kuralları oluşturmak için öğenin sahibi olmanız gerekir.

Notebook Git entegrasyonu

Not defterleri, kaynak denetimi için Azure DevOps ile Git entegrasyonunu destekler. Not defteri değişikliklerini sürümleyebilir, dalları kullanarak işbirliği yapabilir ve not defteri yaşam döngüsü güncelleştirmelerini doğrudan Doku'da yönetebilirsiniz.

Bir not defterini ekli bağımlılıklarıyla (örneğin, çalışma ortamları) birlikte kaydettiğinizde, başka bir çalışma alanıyla eşitleme bu bağımlılıkları korur. Fabric, not defterini yeni çalışma alanındaki ilgili kaynaklara otomatik olarak bağlar.

Fabric, belirtilen davranışı desteklemek için iliştirilmiş kaynakların mantıksal tanımlayıcılarını not defteri meta verilerinde depolar. Sonuç olarak Git farkları, fiziksel kimliklerden mantıksal kimliklere meta veri güncelleştirmelerini gösterebilir.

Not

Mantıksal kimlikler ve otomatik bağlama ile ilgili meta veri güncelleştirmeleri, not defteri kodu değişmediğinde bile Git fark görünümlerinde görünebilir.

Bağlantı kurma

Çalışma alanı ayarlarından, değişiklikleri işlemek ve eşitlemek için deponuza bir bağlantı ayarlayın. Kurulum yönergeleri 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 kaydettikten sonra, depoda not defteri klasör yapısını görebilirsiniz.

Artık Çekme isteği oluşturma gibi Git işlemleri gerçekleştirebilirsiniz.

Git'te not defteri gösterimi

Aşağıdaki metin, Git deposundaki bir not defteri öğesinin dosya yapısını gösterir:

.
├── Notebook_1.Notebook/
│   ├── Resources/ (Optional)
│   │   └── builtin/
│   │       ├── large_dataset.parquet
│   │       └── model_output.parquet
│   ├── .platform
│   ├── fs-settings.json (Optional)
│   ├── notebook-content.py
│   └── notebook-settings.json (Optional)
└── Readme.md

.
├── Notebook_2.Notebook/
│   ├── Resources/ (Optional)
│   │   └── builtin/
│   │       ├── large_dataset.parquet
│   │       └── model_output.parquet
│   ├── .platform
│   ├── fs-settings.json (Optional)
│   ├── notebook-content.sql
│   └── notebook-settings.json (Optional)
└── Readme.md

Bir not defteri öğesini kaydettiğinizde, Fabric bunu standart .ipynb dosya yerine kaynak dosyalar olarak depolar. Örneğin, pyspark not defteri olarak notebook-content.pydepolanır. Bu formatı Git değişikliklerinde gözden geçirmek daha kolaydır.

Kaynak dosya not defteri meta verilerini (varsayılan lakehouse ve ekli ortam dahil), markdown hücrelerini ve kod hücrelerini ayrı bölümler olarak tutar. Fabric, çalışma alanı ile yeniden eşitleme yaptığınızda not defterini yeniden oluşturmak için bu yapıyı kullanır.

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

Aşağıdaki ekran görüntüsünde Git deposundaki kaynak biçimi gösterilmektedir:

Not

Not defterlerini ve bağımlı ortamlarını aynı çalışma alanında tutun ve Git'te hem not defteri hem de ortam öğelerinin sürümünü oluşturun. "Fabric, yeni çalışma alanlarına senkronize ettiğinizde bu ilişkileri eşler."

Depodan bir Fabric çalışma alanına senkronize ettiğinizde, varsayılan lakehouse kimliği not defteri meta verilerinde kalır. Gerekirse, not defterini yeni lakehouse öğesine el ile bağlayın. Daha fazla bilgi için Lakehouse Git tümleştirmesi başlığına bakın.

Dizüstü Bilgisayar Git ayarları

Git ayarları paneli, Git bağlama seçenekleri ve işlemelere hangi Kaynaklar klasör dosyalarının dahil olduğunu yönetme dahil olmak üzere not defterlerinin kaynak denetimiyle nasıl etkileşim kurabileceğinizi denetlemenize olanak tanır.

Not

Git deponuzda Git otomatik bağlanmayı veya kaynakları denetlemek amacıyla notebook-settings.json üzerinde değişiklik yapmayın. Bunun yerine not defteri ayarları sayfasından bu ayarları yönetin.

Git'te Lakehouse Otomatik Bağlama

Lakehouse Otomatik Bağlama, Fabric'in Git'e bağlı her çalışma alanı için doğru varsayılan lakehouse'un çözümlenmesine olanak tanır. Bu, not defterlerini geliştirme, test ve üretim çalışma alanlarında taşıdığınızda el ile yeniden bağlamayı azaltır.

Not defteri ayarlarından bu özelliği etkinleştirin. Siz etkinleştirdikten sonra Fabric, depoda notebook-settings.json dosyasını oluşturur ve bu dosyayı otomatik olarak yönetir. Bu dosyayı el ile düzenlemeyin.

Not

Not Defteri Git tümleştirmesi, çalışma alanları arasında eşitlenirken not defterleri ile ekli lakehouse'lar arasındaki bağlama ilişkisinin kalıcı hale getirmesini destekler. Başka bir çalışma alanıyla bir not defterini eşitlerken, bunun kaynak çalışma alanındaki lakehouse'a mı yoksa yeni çalışma alanındaki lakehouse'a mı bağlanacağını seçebilirsiniz. Git'te zaten sürümlenmiş not defterleri için, not defterinin meta verilerindeki ilişkilendirilmiş lakehouse'un fiziksel kimliği mantıksal kimlikle değiştirilir. Bu değişiklik Git fark görünümünde görünebilir.

Git'te Not Defterleri Kaynakları Klasör Desteği

Not

Ortam Kaynakları klasörü ve dağıtım işlem hatları ve genel API'lerle tümleştirme şu anda desteklenmemektedir.

Yerleşik Kaynaklar klasörü, betiklerin ve yapılandırma dosyalarının not defteriyle birlikte sürümlenebilmesi için Git'e eklenebilir.

Bu özellik varsayılan olarak isteğe bağlıdır ve kapalıdır. Git ayarları bölümündeki Not Defteri ayarlarından etkinleştirin. Etkinleştirdikten sonra Kaynaklar klasöründeki dosyalar işlemelere eklenir. İşlemelerin 50 MB sınırı olduğundan, büyük veya geçici dosya veya klasörleri dışlamak için dosya veya Git kurallarını kullanın .gitignore .

Not

.gitignore Yalnızca yerleşik kaynak kök klasöründekiler etkinleşir.

Git kurallarını yapılandırdıktan ve değişiklikleri işledikten sonra Fabric, kuralları fs-settings.json içinde depoya kaydeder. Fabric, depo yapılandırmasını tutarlı tutmak için bu dosyayı oluşturur ve yönetir. Bu dosyayı doğrudan Git deposunda düzenlemenizi de önermeyiz.

Dağıtım işlem hatlarında Notebook

Geliştirme, Test ve Üretim gibi aşamalarda not defteri değişikliklerini yükseltmek için dağıtım işlem hatlarını kullanın. Güncelleştirmeleri üretime yükseltmeden önce önceki aşamalarda doğrulayın.

Not defteri dağıtımı, bağımlı öğeler aynı çalışma alanında olduğunda varsayılan lakehouse ve ekli ortam için otomatik bağlamayı destekler. Dağıtım sırasında Doku, bu bağımlılıkları hedef çalışma alanında ilgili öğelere yeniden bağlayabilir. Meta veri değişiklikleri fark görünümünde görüntülenebilir.

Belirli bir hedef aşama için varsayılan lakehouse gerekiyorsa, otomatik ilişkilendirmeyi geçersiz kılmak amacıyla bir dağıtım kuralını yapılandırın.

Yeni dağıtım işlem hattı kullanıcı arabirimi şu anda bu makalede kullanılmaktadır. Yeni Dağıtım işlem hattını kapatarak eski kullanıcı arabirimine geçebilirsiniz.

Not

Bilinen sorun: Not defterlerindeki donmuş hücre durumu dağıtım sırasında korunmaz.

Not defterlerini bir dağıtım işlem hattı üzerinden dağıtmak için aşağıdaki adımları kullanın.

1. Bir dağıtım işlem hattı oluşturun veya var olan bir işlem hattını açın. Daha fazla bilgi için Dağıtım işlem hatlarını kullanmaya başlama bölümüne bakın.

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

3. Aşamalar arasında not defterleri de dahil olmak üzere öğeleri seçin, görüntüleyin ve karşılaştırın. Vurgulanan rozet, önceki aşama ile geçerli aşama arasındaki değiştirilen öğelerin sayısını gösterir.

   

4. Not defterlerini Geliştirme, Test ve Üretim aşamalarında yükseltmek için Dağıt'ı seçin.

   

5. Bu aşamaya dağıt penceresinde yeni ve değiştirilmiş öğeleri gözden geçirin. Bir veya daha fazla öğe başarısız olsa bile dağıtıma devam etmek için, Bir veya daha fazla öğe başarısız olursa dağıtımı sürdür'e tıklayın.

   Seçimi gözden geçirip onayladıktan sonra Dağıt'ı seçin.

   

6. (İsteğe bağlı.) Dağıtım kuralları oluşturmak için işlem hattındaki hedef aşama öğesinde Dağıtım kuralları'nı seçin (örneğin, Test veya Üretim).

   Genel kural davranışı ve sınırlamaları için bkz. Dağıtım kuralları oluşturma.

   

7. Her bir not defteri dağıtımı için varsayılan bir lakehouse kuralı yapılandırın.

   Bu kural, dağıtımdan sonra hedef süreçte çalışma defterinin hangi lakehouse'a bağlandığını kontrol eder.

   Dağıtım kurallarını ayarla bölmesinde Varsayılan göl evi kutucuğunu seçin.

   Kaynak aşama varsayılan lakehouse'u hedef aşama varsayılan lakehouse ile eşlemek için Kaynak ve Hedef açılır menülerini kullanın.

   • Kaynak lakehouse ile aynı: Kaynak aşamasının varsayılan lakehouse ayarlarını koruyun.
   • Yok (varsayılan göl evi yok): Hedef aşamadaki varsayılan göl evi ayarını kaldırın.
   • Diğer: Kaynak aşamasının varsayılan lakehouse'unu, hedef aşamada farklı bir lakehouse ile değiştirin.

   Diğer seçeneğini Hedef açılır listesinden seçerseniz, hedef lakehouse ayrıntılarını belirtin:

   • Lakehouse Kimliği
   • Lakehouse adı
   • Lakehouse çalışma alanı kimliği

   

   Not

   Bu kuralı yapılandırırken Lakehouse kimliği gereklidir. Öğe URL'sinden lakehouse kimliğini alabilirsiniz. Dağıtım kuralları otomatik bağlamaya göre önceliklidir. Bir dağıtım kuralı yapılandırılırsa, otomatik olarak bağlanan lakehouse'ı geçersiz kılar.

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

İlgili içerik

• Genel API'ler ile Fabric not defterlerini yönetme ve çalıştırma
• Git tümleştirmesine giriş
• Dağıtım işlem hatlarına giriş