Microsoft Fabric Git tümleştirmesi nedir?
Bu makalede geliştiricilere Git sürüm denetimini Microsoft Fabric Uygulama yaşam döngüsü yönetimi (ALM) aracıyla tümleştirme açıklanmaktadır.
Not
Git tümleştirmesi için bazı öğeler önizleme aşamasındadır. Daha fazla bilgi için desteklenen öğelerin listesine bakın.
Microsoft Fabric'teki Git tümleştirmesi, geliştiricilerin geliştirme süreçlerini, araçlarını ve en iyi uygulamalarını doğrudan Doku platformuyla tümleştirmesine olanak tanır. Fabric'te geliştirme yapan geliştiricilerin şunları yapmasına olanak tanır:
- Çalışmalarını yedekleme ve sürüm oluşturma
- Gerektiğinde önceki aşamalara geri dön
- Git dallarını kullanarak başkalarıyla işbirliği yapma veya tek başına çalışma
- Doku öğelerini yönetmek için tanıdık kaynak denetim araçlarının özelliklerini uygulama
Kaynak denetimiyle tümleştirme çalışma alanı düzeyindedir. Geliştiriciler, çalışma alanı içinde geliştirdikleri öğeleri tek bir işlemde sürüme alabilir ve tüm öğelerine tam görünürlük sağlayabilir. Şu anda yalnızca birkaç öğe destekleniyor, ancak desteklenen öğeler listesi büyüyor.
Temel Git kavramlarını bildiğinizden emin olmak için sürüm denetimi ve Git hakkında bilgi edinin.
Git tümleştirme işlemi hakkında daha fazla bilgi edinin.
Git dallarınızı yönetmenin en iyi yolu hakkında bilgi edinin.
Gizlilik bilgileri
Git tümleştirmesini etkinleştirmeden önce aşağıdaki gizlilik bildirimlerini gözden geçirin:
- Microsoft gizlilik bildirimi
- Azure DevOps Services Veri korumasına genel bakış
- GitHub Veri koruma sözleşmesi
Desteklenen Git sağlayıcıları
Aşağıdaki Git sağlayıcıları desteklenir:
Desteklenen öğeler
Şu anda aşağıdaki öğeler desteklenmektedir:
- Veri işlem hatları (önizleme)
- Lakehouse (önizleme)
- Notebooks
- Sayfalandırılmış raporlar (önizleme)
- Raporlar (Azure Analysis Services, SQL Server Analysis Services'te barındırılan anlamsal modellere bağlı raporlar veya Power BI Desktop tarafından dışarı aktarılan ve MyWorkspace'te barındırılan anlamsal modellere bağlı raporlar hariç) (önizleme)
- Anlamsal modeller (gönderme veri kümeleri, Analysis Services'e canlı bağlantılar, model v1 hariç) (önizleme)
- Spark İş Tanımları (önizleme)
- Spark ortamı (önizleme)
- Ambarlar (önizleme)
Çalışma alanı veya Git dizininde desteklenmeyen öğeler varsa, yine de bağlanabilir, ancak desteklenmeyen öğeler yoksayılır. Kaydedilmez veya eşitlenmez, ancak silinmez. Bunlar kaynak denetim masasında görünür, ancak bunları işleyemez veya güncelleştiremezsiniz.
Dikkat edilecekler ve sınırlamalar
Genel Git tümleştirme sınırlamaları
- Doku'daki kimlik doğrulama yöntemi, git için kimlik doğrulama yöntemi kadar güçlü olmalıdır. Örneğin, Git çok faktörlü kimlik doğrulaması gerektiriyorsa, Yapı'nın da çok faktörlü kimlik doğrulaması gerektirmesi gerekir.
- Analysis Services'e bağlı Power BI Veri Kümeleri şu anda desteklenmemektedir.
- Şablon uygulamalarının yüklü olduğu çalışma alanları Git'e bağlanamaz.
- Bağımsız bulutlar desteklenmez.
- Azure DevOps hesabının Doku çalışma alanını kullanan aynı kullanıcıya kaydedilmesi gerekir.
- Çalışma alanı ve Git deposu iki farklı coğrafi bölgedeyse kiracı yöneticisinin coğrafi bölgeler arası dışarı aktarmaları etkinleştirmesi gerekir.
- İşleme boyutu 125 MB ile sınırlıdır.
GitHub Enterprise sınırlamaları
Bazı GitHub Enterprise ayarları desteklenmez. Örneğin:
- IP izin verilenler listesi
- Özel ağ
- Özel etki alanları
Çalışma alanı sınırlamaları
- Git Deposu'na bağlanma, bağlantıyı kesme veya dal ekleme gibi bağlantıları yalnızca çalışma alanı yöneticisi yönetebilir.
Bağlandıktan sonra, izni olan herkes çalışma alanında çalışabilir. - Çalışma alanı klasör yapısı Git deposuna yansıtılmıyor. Klasörlerdeki çalışma alanı öğeleri kök dizine aktarılır.
Dal ve klasör sınırlamaları
- Dal adı uzunluğu üst sınırı 244 karakterdir.
- Dosya adları için en fazla tam yol uzunluğu 250 karakterdir. Uzun adlar başarısız olur.
- Dosya boyutu üst sınırı 25 MB'tır.
- Git tümleştirmesi ile dağıtıldıktan sonra bir raporu/veri kümesini hizmetten .pbix olarak indiremezsiniz.
- Git'te bir klasörü adlandırırken, öğenin görünen adı ise, mantıksal kimlik (Guid) türünden önce bir ön ek olarak eklenir:
- 256'dan fazla karakter içeriyor
- ile veya boşlukla biter
- Şu karakterlerden herhangi birini içerir: " / : ? < > \ * |
Dallanma sınırlamaları
- Dallanma, izinler tablosunda listelenen izinleri gerektirir.
- Bu eylem için kullanılabilir bir kapasite olmalıdır.
- Yeni bir çalışma alanına dallanma sırasında tüm çalışma alanı ve dal adlandırma sınırlamaları uygulanır.
- Dallanırken yeni bir çalışma alanı oluşturulur ve özgün çalışma alanının ayarları kopyalanmaz. Yeni çalışma alanının kuruluşunuzun ilkelerine uygun olduğundan emin olmak için tüm ayarları veya tanımları ayarlayın.
- Yeni çalışma alanında yalnızca Git tarafından desteklenen öğeler kullanılabilir.
- İlgili dallar listesi yalnızca görüntüleme izniniz olan dalları ve çalışma alanlarını gösterir.
- Git tümleştirmesi etkinleştirilmelidir.
Eşitleme ve işleme sınırlamaları
- Aynı anda yalnızca bir yönde eşitleyebilirsiniz. Aynı anda işleyemez ve güncelleştiremezsiniz.
- Duyarlılık etiketleri desteklenmez ve duyarlılık etiketleri olan öğeleri dışarı aktarmak devre dışı bırakılabilir. Duyarlılık etiketi olmayan duyarlılık etiketlerine sahip öğeleri işlemek için yöneticinizden yardım isteyin.
- Sınırlı öğelerle çalışır. Klasördeki desteklenmeyen öğeler yoksayılır.
- Adları yinelemeye izin verilmez. Power BI ad yinelemesine izin veriyor olsa bile güncelleştirme, işleme veya geri alma eylemi başarısız olur.
- B2B desteklenmez.
- Çakışma çözümlemesi Kısmen Git'te yapılır.
- Git'e İşleme işlemi sırasında Doku hizmeti, öğe klasörünün içindeki öğe tanımının parçası olmayan dosyaları siler. Öğe klasöründe olmayan ilişkisiz dosyalar silinmez.
- Değişiklikleri işledikten sonra, öğede yapmadığınız bazı beklenmedik değişiklikler fark edebilirsiniz. Bu değişiklikler önemsizdir ve çeşitli nedenlerle gerçekleşebilir. Örneğin:
- Öğe tanımı dosyasını el ile değiştirme. Bu değişiklikler geçerlidir, ancak düzenleyiciler aracılığıyla yapıldığından farklı olabilir. Örneğin, Git'te bir anlam modeli sütununu yeniden adlandırır ve bu değişikliği çalışma alanına aktarırsanız, değişiklikleri anlam modeline bir sonraki işlemenizde, bim dosyası değiştirilmiş olarak kaydedilir ve değiştirilen sütun dizinin arkasına
columns
iletilir. Bunun nedeni, bim dosyalarını oluşturan AS altyapısının yeniden adlandırılmış sütunları dizinin sonuna göndermesidir. Bu değişiklik öğenin çalışma şeklini etkilemez. - CRLF satır sonları kullanan bir dosya işleme. Hizmet LF (satır akışı) satır sonlarını kullanır. CrLF satır sonları olan Git deposunda öğe dosyalarınız varsa, hizmetten işleme yaptığınızda bu dosyalar LF olarak değiştirilir. Örneğin, masaüstünde bir rapor açarsanız.pbip projesini kaydedin ve CRLF kullanarak Git'e yükleyin.
- Öğe tanımı dosyasını el ile değiştirme. Bu değişiklikler geçerlidir, ancak düzenleyiciler aracılığıyla yapıldığından farklı olabilir. Örneğin, Git'te bir anlam modeli sütununu yeniden adlandırır ve bu değişikliği çalışma alanına aktarırsanız, değişiklikleri anlam modeline bir sonraki işlemenizde, bim dosyası değiştirilmiş olarak kaydedilir ve değiştirilen sütun dizinin arkasına
- Gelişmiş yenileme API'sini kullanarak bir anlam modelini yenilemek, her yenilemeden sonra Git farkına neden olur.