Git tümleştirmesindeki temel kavramlar

Bu makalede, temel Git kavramları ve Git'i Microsoft Fabric çalışma alanınızla tümleştirme işlemi açıklanmaktadır.

Önemli

Bu özellik önizleme aşamasındadır.

İzinler

Azure DevOps izinleri

Aşağıdaki liste, Azure DevOps izinlerine bağlı olarak farklı çalışma alanı rollerinin neler yapabileceğini gösterir:

  • Yönetici: Yalnızca Azure DevOps rolüyle sınırlı olarak çalışma alanında herhangi bir işlem gerçekleştirebilir.
  • Üye/Katkıda Bulunan: Bir çalışma alanına bağlandıktan sonra üye/katkıda bulunan, Azure DevOps rolüne bağlı olarak değişiklikleri işleyebilir ve güncelleştirebilir. Çalışma alanı bağlantısıyla ilgili eylemler için (örneğin, bağlanma, bağlantıyı kesme veya dalları değiştirme) Yönetici yardım isteyin.
  • Görüntüleyici: Hiçbir eylem gerçekleştirilemiyor. Görüntüleyici çalışma alanında Git ile ilgili hiçbir bilgiyi göremez.

Yaygın işlemler için gereken izinler

Aşağıdaki tabloda, çeşitli yaygın işlemleri gerçekleştirmek için gereken izinler açıklanmaktadır:

İşlem Çalışma alanı rolü Git izinleri
Çalışma alanını Git deposuna Bağlan Yönetici Read=İzin Ver
Çalışma alanını Git deposuyla eşitleme Yönetici Read=İzin Ver
Çalışma alanının Git deposuyla bağlantısını kesme Yönetici İzin gerekmez
Çalışma alanında dal değiştirme (veya bağlantı ayarındaki herhangi bir değişiklik) Yönetici Read=allow (hedef depoda/dizinde/dalda)
Git bağlantı ayrıntılarını görüntüleme Yönetici, Üye, Katkıda Bulunan Okuma veya Yok
Bkz. çalışma alanı 'Git durumu' Yönetici, Üye, Katkıda Bulunan Read=İzin Ver
Git'ten güncelleştirme Aşağıdakilerin tümü:

Çalışma alanında katkıda bulunan (tüm öğelerde YAZMA izni)

Öğenin sahibi (kiracı anahtarı, sahip olmayanlar için güncelleştirmeleri engelliyorsa)

Dış bağımlılıklar üzerinde BUILD (uygun olduğunda)
Read=İzin Ver
Çalışma alanı değişikliklerini Git'e işleme Aşağıdakilerin tümü:

Çalışma alanında katkıda bulunan (tüm öğelerde YAZMA izni)

Öğenin sahibi (kiracı anahtarı, sahip olmayanlar için güncelleştirmeleri engelliyorsa)

Dış bağımlılıklar üzerinde BUILD (uygun olduğunda)
Read=İzin Ver
Contribute=İzin Ver
dal ilkesi doğrudan işlemeye izin vermelidir
Doku içinden yeni Git dalı oluşturma Yönetici Rol=Yazma
Dal oluşturma=İzin Ver

Bağlan ve eşitleme

Yalnızca çalışma alanı yöneticisi bir çalışma alanını Azure Repos'a bağlayabilir, ancak bağlandıktan sonra, izinleri olan herkes çalışma alanında çalışabilir. Yönetici değilseniz, bağlanma konusunda yöneticinizden yardım isteyin.

Çalışma alanını Git'e bağladığınızda Doku, aynı içeriğe sahip olmaları için iki konum arasında eşitlenir. Bu ilk eşitleme sırasında, diğerinde içerik varken çalışma alanı veya Git dalı boşsa, içerik boş konuma kopyalanır. Hem çalışma alanında hem de Git dalında içerik varsa eşitlemenin hangi yöne gideceğine karar vermeniz gerekir.

  • Çalışma alanınızı Git dallarına kaydederseniz, desteklenen tüm çalışma alanı içeriği Git'e aktarılır ve geçerli Git içeriğinin üzerine yazılır.
  • Çalışma alanını Git içeriğiyle güncelleştirirseniz, çalışma alanı içeriğinin üzerine yazılır ve çalışma alanı içeriğinizi kaybedersiniz. Çalışma alanı geri yükleyemiyorken Git dalı her zaman önceki aşamaya geri yüklenebileceği için, bu seçeneği belirlerseniz onaylamanız istenir.

Screenshot of dialog asking which direction to sync if both Git and the workspace have content.

Eşitlenecek içeriği seçmezseniz, bunu yapana kadar çalışmaya devam edebilirsiniz:

Screenshot notification that you can't continue working until workspace is synced.

Git durumu

Bağlandıktan sonra çalışma alanı, uzak daldaki öğelerle ilişkili olarak çalışma alanındaki her öğenin eşitleme durumunu gösteren bir Git durum sütunu görüntüler.

Screenshot if items in a workspace with their Git status outlined.

Her öğe aşağıdaki durumlardan birine sahiptir:

  • Eşitlendi (öğe çalışma alanı ve Git dalında aynıdır)
  • Çakışma (öğe hem çalışma alanında hem de Git dalında değiştirildi)
  • Desteklenmeyen öğe
  • Çalışma alanında kaydedilmemiş değişiklikler
  • Git'ten güncelleştirme gerekiyor
  • Öğe her iki yerde de aynıdır ancak son işlemeye güncelleştirilmesi gerekir

Eşitleme bilgileri

Bağlı olduğunuz sürece ekranınızın alt kısmında aşağıdaki bilgiler görüntülenir:

  • Bağlan dal
  • Son eşitleme zamanı
  • Çalışma alanının eşitlendiği son işlemeye bağlantı

Screenshot of sync information that appears on the bottom of the screen when connected to Git.

İşlemeler ve güncelleştirmeler

Kaynak denetim bölmesi

Ekranın üst kısmında Kaynak denetimi simgesi bulunur. Çalışma alanında ve Git dalında farklı olan öğelerin sayısını gösterir. Çalışma alanı Git dalı ile eşitlendiğinde Kaynak denetimi simgesi 0 değerini görüntüler.

Screenshot of the source control icon showing zero items changed.

Çalışma alanında veya Git dalında değişiklik yapıldığında, kaynak denetimi simgesi farklı öğelerin sayısını gösterir. Kaynak denetimi bölmesini açmak için kaynak denetimi simgesini seçin.

Kaynak denetimi bölmesinde, Değişiklikler sekmesi çalışma alanında değiştirilen ve Git'e işlenmesi gereken öğe sayısını, Güncelleştirmeler sekmesinde ise Git dalında değiştirilmiş olan ve çalışma alanına güncelleştirilmiş olan öğelerin sayısı gösterilir.

Her sekmede, değiştirilen öğeler durumu gösteren bir simgeyle listelenir:

  • Yeni
  • Değiştirilmiş
  • Silin
  • Çakışma

Screenshot of the source control panel showing the status of the changed items.

İşleme

  • İşlenen birden fazla öğe olduğunda Git dalı için hangi öğelerin işleyebileceğinizi seçebilirsiniz.
  • Git dalında yapılan güncelleştirmeler varsa, siz çalışma alanınızı güncelleştirene kadar işlemeler devre dışı bırakılır.

Güncelleştir

  • İşleme ve geri alma işlemlerinden farklı olarak, Güncelleştir komutu her zaman dalın tamamını güncelleştirir ve en son işlemeyle eşitlenir. Güncelleştirilecek belirli öğeleri seçemezsiniz.
  • Çalışma alanında ve aynı öğedeki Git dalında değişiklikler yapıldıysa, çakışma çözülene kadar güncelleştirmeler devre dışı bırakılır.

İşleme ve güncelleştirme hakkında daha fazla bilgi edinin. Güncelleştirme işlemi ve çakışmaları çözme hakkında daha fazla bilgi edinin.

Dikkat edilecekler ve sınırlamalar

Genel sınırlamalar

  • Azure DevOps hesabının Doku çalışma alanını kullanan aynı kullanıcıya kaydedilmesi gerekir.
  • Power BI'daki kimlik doğrulama yöntemi, Azure DevOps için kimlik doğrulama yöntemi kadar güçlü olmalıdır. Örneğin, Azure DevOps çok faktörlü kimlik doğrulaması gerektiriyorsa Power BI'ın da çok faktörlü kimlik doğrulaması gerektirmesi gerekir.
  • Power BI Veri Kümeleri ve Analysis Services'daki Doğrudan Sorgu ve bileşik modeller şu anda desteklenmemektedir.
  • DirectLake semantik modelleri şu anda desteklenmiyor.
  • Gelişmiş yenileme API'sini kullanarak bir anlam modelini yenilemek, her yenilemeden sonra Git farkına neden olur.

Çalışma alanı sınırlamaları

Azure 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 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.

  • Öğenin görünen adı:

    • 256'dan fazla karakter içeriyor
    • ' veya boşlukla .biter
    • Şu karakterlerden herhangi birini içerir: ", /, :, <, , >, *\\, ?|

    Git'te klasörü adlandırırken, mantıksal kimlik (Guid) türünden önce bir ön ek olarak eklenir.

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

  • İşleme için boyut sınırı 125 MB'tır.
  • 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. Desteklenmeyen öğeler klasördeyse yoksayılır.
  • Adların çoğaltılmasına izin verilmez; Power BI izin verse 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.