Aracılığıyla paylaş

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ı yedekle ve sürümlendir
  • 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
  • Kumaş öğelerini yönetmek için tanıdık kaynak denetim araçlarının yeteneklerini uygulayın

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. alt klasörleri de dahil olmak üzere çalışma alanı yapısı Git deposunda korunur.

Desteklenen öğelerin listesine bakın.

Git tümleştirmesi için ağ güvenliği

Microsoft Fabric'teki çalışma alanı düzeyinde güvenlik, yöneticilerin tek tek çalışma alanları için hem gelen hem de giden korumaları yapılandırmasına olanak tanıyarak veri erişimi ve ağ bağlantısı üzerinde ayrıntılı denetim sağlar. Bu denetimler hassas verilerin güvenilir ağ sınırları içinde kalmasını sağlar ve Git tümleştirmesi gibi CI/CD araçlarıyla tümleştirilir. Daha fazla bilgi için bkz . Sürekli tümleştirme/sürekli dağıtım için ağ güvenliği

Gizlilik bilgileri

Git tümleştirmesini etkinleştirmeden önce aşağıdaki gizlilik bildirimlerini gözden geçirin:

Desteklenen Git sağlayıcıları

Aşağıdaki Git sağlayıcıları desteklenir:

Desteklenen öğeler

Şu anda aşağıdaki öğeler Git tümleştirmesini destekler:

Çalışma alanı veya Git dizininde desteklenmeyen öğeler varsa, yine de bağlantı kurulabilir; ancak bu durumda, 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.
  • Çalışma alanı kimliğini bir eserde kullanır ve Git'e aktarırsanız, yalnızca aynı kimliğe bağlı bir çalışma alanında güncellenebilir (yeniden bir fabric çalışma alanına dönüştürülebilir). Bu durum dallanma gibi özellikleri de etkilediğinden dikkatli olun.
  • Alt modüller desteklenmez.
  • Bağımsız bulutlar desteklenmez.
  • Çalışma alanınız yüzlerce öğe içeriyorsa, bunu daha küçük yapıt kümelerine bölmeyi göz önünde bulundurun. Her küme ayrı bir çalışma alanına yerleştirilmeli ve farklı bir Git dalı ile bağlantılı olmalı veya farklı klasörler halinde düzenlenmiş tek bir dala bağlanmalıdır.
  • IP Koşullu Erişim ilkesi doğrulamasını etkinleştir seçeneği etkinse Azure DevOps desteklenmez.
  • Ç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.
  • Kuruluşunuz koşullu erişim yapılandırdıysa , Power BI Hizmeti'nin kimlik doğrulamasının beklendiği gibi çalışması için ayarlanan koşulların aynı olduğundan emin olun.
  • Aşağıdaki işleme boyutu sınırı uygulanır:
    • Hizmet Sorumlusu ile Azure DevOps bağlayıcısını kullanarak 25 MB.
    • Varsayılan çoklu oturum açma (SSO) Microsoft Entra ID hesabı ve Kullanıcı Sorumlusu ile Azure DevOps bağlayıcısı kullanılarak 125 MB.

GitHub Enterprise sınırlamaları

Bazı GitHub Enterprise sürümleri ve ayarları desteklenmez. Örneğin:

  • Veri saklama özellikli GitHub Enterprise Cloud (ghe.com)
  • Özel etki alanına sahip GitHub Enterprise Server, örneğe genel erişim sağlansa bile desteklenmez
  • Özel ağda barındırılan Github Enterprise Server
  • IP izin listesi

Azure DevOps'dan GitHub Enterprise'a geçiş konusunda dikkat edilmesi gerekenler

Ekibiniz Doku Git Tümleştirmesi kullanıyorsa ve Azure DevOps'tan GitHub Enterprise'a geçişi değerlendiriyorsa, Git Tümleştirme işlevselliğinin etkilenmediğinden emin olmak için doğrulama testleri çalıştırmanız önerilir. Doku Git Tümleştirmesi, yukarıda açıklandığı gibi Azure DevOps ile GitHub Enterprise arasındaki özellikler ve sınırlamalar bakımından farklılık gösteren temel Git sağlayıcı API'lerine dayanır.

Ç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.
  • Şablon uygulamalarının yüklü olduğu çalışma alanları Git'e bağlanamaz.
  • MyWorkspace bir Git sağlayıcısına bağlanamıyor.

Şube 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ızlıkla sonuçlanır.
  • Dosya boyutu üst sınırı 25 MB'tır.
  • Klasör yapısı en fazla 10 düzey derinlikte tutulur.
  • Rapor/veri kümesini Git tümleştirmesi ile dağıttıktan sonra hizmetten .pbix olarak indirmek önerilmez, aksi durumda sonuçlar güvenilir değildir. Raporları/veri kümelerini .pbix olarak indirmek için PowerBI Desktop'ı kullanmanızı öneririz.
  • Öğenin görünen adı bu özelliklerden herhangi birine sahipse Git klasörü mantıksal kimlik (Guid) olarak yeniden adlandırılır ve şunu yazın:
  • Klasörleri olan bir çalışma alanını Git'e bağladığınızda, bu klasör yapısı farklıysa değişiklikleri Git deposuna işlemeniz gerekir.

Dizin adı sınırlamaları

  • Git deposuna bağlanan dizinin adı aşağıdaki adlandırma kısıtlamalarına sahiptir:

    • Dizin adı bir boşluk veya sekmeyle başlayamaz veya bitemez.
    • Dizin adı şu karakterlerden hiçbirini içeremez: "/:<>\*|

  • Öğe klasörü (öğe dosyalarını içeren klasör) şu karakterlerden hiçbirini içeremez: ":<>\*?|. Klasörü bu karakterlerden birini içeren bir adla yeniden adlandırırsanız, Git çalışma alanına bağlanamaz veya çalışma alanıyla eşitlenemez ve bir hata oluşur.

Yayılma 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.
  • 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.
  • Dallanırken yeni bir dal oluşturulur ve özgün daldaki ayarlar kopyalanmamıştır. Yeninin kuruluşunuzun ilkelerini karşıladığından emin olmak için tüm ayarları veya tanımları ayarlayın.
  • Mevcut bir çalışma alanına geçiş yaparken:
    • Hedef çalışma alanının git bağlantısını desteklemesi gerekir.
    • Kullanıcının hedef çalışma alanının yöneticisi olması gerekir.
    • Hedef çalışma alanında yeterli kapasite olmalıdır.
    • Çalışma alanında şablon uygulamaları olamaz.
  • Bir çalışma alanında yeni bir dal oluşturduğunuzda, Git'e kaydedilmemiş tüm öğelerin kaybolabileceğini unutmayın. Dallanmadan önce saklamak istediğiniz öğeleri işlemenizi öneririz.

Eşitleme ve işleme sınırlamaları

  • Aynı anda yalnızca tek bir yönde eşitleyebilirsiniz. Aynı anda taahhüt edemez 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örde bulunan 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 gönderdiğinizde, bim dosyası değiştirilmiş olarak kaydedilir ve değiştirilen sütun dizinin sonuna columns itilir. 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ını kullanan bir dosyayı 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, bir raporu masaüstünde açarsanız proje dosyasını (.pbip) kaydedin ve crlfkullanarak Git'e yükleyin.
  • Gelişmiş yenileme API'sini kullanarak bir anlam modelini yenilemek, her yenilemeden sonra Git farkına neden olur.

İlgili içerik

  • Last updated on