Git tümleştirmesi ile çalışmaya başlama

Bu makalede, Microsoft Fabric'in Git tümleştirme aracında aşağıdaki temel görevler açıklanmaktadır:

• Git deposuna bağlanma
• Değişiklikleri işleme
• Git'ten güncelleştirme
• Git bağlantısını kesme

Başlamadan önce Git entegrasyonu genel bakışını okumayı öneririz.

Önkoşullar

Git'i Microsoft Fabric çalışma alanınızla entegre etmek için hem Fabric hem de Git için aşağıdaki önkoşulları ayarlamanız gerekir.

Kumaş önkoşulları

Git entegrasyon özelliğine erişmek için Fabric kapasitesinesahip olmanız gerekir. Desteklenen tüm Fabric öğelerini kullanmak için Fabric kapasitesi gereklidir. Henüz bir aboneliğiniz yoksa ücretsiz deneme sürümüne kaydolun. Power BI Premium kapasitesine sahip olan müşteriler bu kapasiteyi kullanabilir, ancak bazı Power BI SKU'larının yalnızcaPower BI öğelerini desteklediğini unutmayın.

Ayrıca, aşağıdaki kiracı ayarlarının Yönetici portalından etkinleştirilmesi gerekir.

• Kullanıcılar Fabric öğeleri oluşturabilir
• Kullanıcılar çalışma alanı öğelerini Git depolarıyla eşitleyebilir
• Yalnızca GitHub kullanıcıları için: Kullanıcılar çalışma alanı öğelerini GitHub depolarıyla eşitleyebilir

Bu anahtarlar, kuruluşunuzun ayarlarına bağlı olarak kiracı yöneticisi, kapasite yöneticisi veya çalışma alanı yöneticisi tarafından etkinleştirilebilir.

Git önkoşulları

Git tümleştirmesi şu anda Azure DevOps ve GitHub için desteklenmektedir. Doku çalışma alanınızla Git tümleştirmesini kullanmak için Azure DevOps veya GitHub'da aşağıdakilere ihtiyacınız vardır:

Çalışma alanını Git deposuna bağlama

Git deposuna bağlanma

Yalnızca çalışma alanı yöneticisi çalışma alanını bir depoya bağlayabilir, ancak bağlandıktan sonra, izni olan herkes çalışma alanında çalışabilir. Yönetici değilseniz, bağlanma konusunda yöneticinizden yardım isteyin. Çalışma alanını Bir Azure veya GitHub Deposuna bağlamak için şu adımları izleyin:

1. Fabric'da oturum açın ve bağlanmak istediğiniz çalışma alanına erişin.

2. Çalışma alanı ayarlarına gidin

   

3. Git tümleştirmesi'ne tıklayın.

4. Git sağlayıcınızı seçin. Şu anda Azure DevOps ve GitHub desteklenmektedir.

Çalışma alanına bağlanma

Çalışma alanı GitHub'a zaten bağlıysa Paylaşılan çalışma alanına bağlanma yönergelerini izleyin.

Bağlan ve eşitle'yi seçin.

İlk eşitleme sırasında, çalışma alanı veya Git dalı boşsa, içerik dolu konumdan boş olana kopyalanır. Hem çalışma alanında hem de Git dalında içerik varsa eşitlemenin hangi yöne gitmesi gerektiği sorulur. Bu ilk eşitleme hakkında daha fazla bilgi için bkz . Bağlanma ve eşitleme.

Bağlandıktan sonra, Çalışma Alanı kullanıcının bağlı dalı, daldaki her öğenin durumunu ve son eşitleme zamanını görüntülemesine olanak tanıyan kaynak denetimi hakkındaki bilgileri görüntüler.

Çalışma alanınızı Git dalı ile eşitlenmiş durumda tutmak için, çalışma alanında yaptığınız değişiklikleri Git dalında işleyin ve git dalında yeni işlemeler oluşturan herkes çalışma alanınızı güncelleştirin.

Değişiklikleri git'e işleme

Git klasörüne başarıyla bağlandıktan sonra çalışma alanınızı her zamanki gibi düzenleyin. Kaydettiğiniz tüm değişiklikler yalnızca çalışma alanına kaydedilir. Hazır olduğunuzda, değişikliklerinizi Git dalında işleyebilir veya değişiklikleri geri alıp önceki duruma dönebilirsiniz.

Commit'ler hakkında daha fazla bilgi edinin.

Git'ten çalışma alanını güncelleştirme

Herkes bağlı Git dalında yeni bir değişiklik işlediğinde ilgili çalışma alanında bir bildirim görüntülenir. Kaynak denetim masasını, en son değişiklikleri, birleştirmeleri veya geri almaları çalışma alanına çekmek ve canlı öğeleri güncellemek için kullanın. Klasörlerdeki değişiklikler de güncelleştirilir. Güncellemeler hakkında daha fazla bilgi edinin.

Çalışma alanını güncelleştirmek için şu adımları izleyin:

1. Çalışma alanına gidin.
2. Kaynak denetimi simgesini seçin.
3. Kaynak denetim masasından Güncelleştirmeler'i seçin. Son güncelleştirmeden sonra dalda değiştirilen tüm öğelerle birlikte bir liste görüntülenir.
4. Tümünü güncelleştir'i seçin.

Güncelleme başarıyla tamamlandığında, öğe listesi kaldırılır ve çalışma alanı, eşitleme yapılan yeni çalışma alanına yönlendirilir.

Güncelleştirme başarıyla tamamlandıktan sonra öğelerin durumu Eşitlendi olarak değişir.

Çalışma alanının Git ile bağlantısını kesme

Çalışma alanının git deposuyla bağlantısını yalnızca çalışma alanı yöneticisi kesebilir. Yönetici değilseniz, bağlantıyı kesme konusunda yöneticinizden yardım isteyin. Yöneticiyseniz ve deponuzun bağlantısını kesmek istiyorsanız şu adımları izleyin:

1. Çalışma alanı ayarlarına gidin
2. Git tümleştirmesi'ne tıklayın
3. "Çalışma alanının bağlantısını kes seçin."
4. Tekrar onaylamak için Bağlantıyı Kes'i seçin.

İzinler

Çalışma alanında gerçekleştirebileceğiniz eylemler hem çalışma alanında hem de Git deposunda sahip olduğunuz izinlere bağlıdır. İzinler hakkında daha ayrıntılı bir tartışma için bkz . İzinler.

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.
• Alt modüller desteklenmez.
• Bağımsız bulutlar desteklenmez.

GitHub Enterprise sınırlamaları

Bazı GitHub Enterprise ayarları desteklenmez. Örneğin:

• IP izin 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.

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 isimler başarısız olur.
• Dosya boyutu üst sınırı 25 MB'tır.
• Klasör yapısı en fazla 10 düzey derinlikte tutulur.
• Git tümleştirmesi ile dağıtıldıktan sonra bir raporu/veri kümesini hizmetten .pbix olarak indiremezsiniz.
• Öğ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:
  • 256'dan fazla karakter içeriyor
  • ile biter. veya boşluk
  • dizin adı sınırlamalarında açıklandığı gibi yasak karakterleri içerir
• Klasörleri olan bir çalışma alanını Git'e bağladığınızda, klasör yapısı farklıysa değişiklikleri Git deposunda 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.

Genişleme 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 öneririz.

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

• Eşitleme işlemini aynı anda yalnızca bir yönde yapabilirsiniz. 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 öğ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 sürecinde, Fabric 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 dosyayı yükleme. Hizmet LF (satır beslemesi) satır sonlarını kullanır. Git deposunda CRLF satır sonlarına sahip öğe dosyalarınız varsa, hizmetten işlediğinizde bu dosyalar LF ile 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

• Git tümleştirme işlemini anlama
• Git dallarını yönetme
• Git tümleştirmesi için en iyi yöntemler