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.

İzinler

  • Git tümleştirmesini kullanmak için kuruluşunuzun yöneticisinin bunu etkinleştirmesi gerekir.
  • Çalışma alanı ve Azure deposu iki farklı bölgedeyse kiracı yöneticisinin coğrafi bölgeler arası dışarı aktarmayı etkinleştirmesi gerekir. Bu kısıtlama GitHub için geçerli değildir.
  • Bir çalışma alanında gerçekleştirebileceğiniz eylemler, sonraki bölümlerde listelendiği gibi hem çalışma alanında hem de Git'te sahip olduğunuz izinlere bağlıdır.

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

  • Yönetici: Çalışma alanında herhangi bir işlemi yalnızca Git rolüyle sınırlı olarak gerçekleştirebilir.
  • Üye/Katkıda Bulunan: Bir çalışma alanına bağlandıktan sonra, üye/katkıda bulunan Git 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öneticiden 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.

Çalışma alanı rolleri

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

İşlem Çalışma alanı rolü
Çalışma alanını Git deposuna bağlama Yönetici
Çalışma alanını Git deposuyla eşitleme Yönetici
Çalışma alanının Git deposuyla bağlantısını kesme Yönetici
Çalışma alanında dal değiştirme (veya bağlantı ayarındaki herhangi bir değişiklik) Yönetici
Git bağlantı ayrıntılarını görüntüleme Yönetici, Üye, Katkıda Bulunan
Bkz. çalışma alanı 'Git durumu' Yönetici, Üye, Katkıda Bulunan
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)
Ç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)
Doku içinden yeni Git dalı oluşturma Yönetici
Yeni bir çalışma alanına dallanma Yönetici, Üye, Katkıda Bulunan

Git rolleri

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

İşlem Git izinleri
Çalışma alanını Git deposuna bağlama Read=İzin Ver
Çalışma alanını Git deposuyla eşitleme Read=İzin Ver
Çalışma alanının Git deposuyla bağlantısını kesme İzin gerekmez
Çalışma alanında dal değiştirme (veya bağlantı ayarındaki herhangi bir değişiklik) Read=allow (hedef depoda/dizinde/dalda)
Git bağlantı ayrıntılarını görüntüleme Okuma veya Yok
Bkz. çalışma alanı 'Git durumu' Read=İzin Ver
Git'ten güncelleştirme Read=İzin Ver
Çalışma alanı değişikliklerini Git'e işleme Read=İzin Ver
Contribute=İzin Ver
dal ilkesi doğrudan işlemeye izin vermelidir
Doku içinden yeni Git dalı oluşturma Rol=Yazma
Dal oluşturma=İzin Ver
Yeni bir çalışma alanına dallanma Read=İzin Ver
Dal oluşturma=İzin Ver

Bağlanma ve eşitleme

Çalışma alanını yalnızca çalışma alanı yöneticisi Git Depolarına 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.

Hem Git'in hem de çalışma alanının içeriği varsa hangi yönün eşitlenmesinin istendiğini soran iletişim kutusunun ekran görüntüsü.

Eşitlenecek içeriği seçmezseniz çalışmaya devam edemezseniz.

Çalışma alanı eşitlenene kadar çalışmaya devam edememenize ilişkin ekran görüntüsü bildirimi.

Paylaşılan çalışma alanına bağlanma

Git'e zaten bağlı olan bir çalışma alanına bağlanmayı denerseniz aşağıdaki iletiyi alabilirsiniz:

Git hesabında oturum açmasını söyleyen hata iletisinin ekran görüntüsü.

Kaynak denetim masasının sağ tarafındaki Hesaplar sekmesine gidin, bir hesap seçin ve buna bağlanın.

Kullanıcının GitHub hesabına bağlanarak Hesaplar sekmesinin ekran görüntüsü.

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.

Çalışma alanında Git durumlarının özetlenmiş olduğu öğelerin ekran görüntüsü.

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ğlı dal
  • Son eşitleme zamanı
  • Çalışma alanının eşitlendiği son işlemeye bağlantı

Git'e bağlanıldığında ekranın alt kısmında görünen eşitleme bilgilerinin ekran görüntüsü.

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ında veya Git dalında değişiklik yapıldığında, sayı güncelleştirilir. Çalışma alanı Git dalı ile eşitlendiğinde Kaynak denetimi simgesi 0 değerini görüntüler.

Sıfır öğenin değiştiğini gösteren kaynak denetimi simgesinin ekran görüntüsü.

Kaynak denetim simgesini seçerek Kaynak denetim masasını açın.

Kaynak denetim bölmesinin yanında üç sekme vardır:

İşlemeler ve güncelleştirmeler

Ç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 denetim simgesini seçerek Kaynak denetim masasını açın.

İşleme ve güncelleştirme panelinde iki bölüm vardır.

Değişiklikler , çalışma alanında değiştirilen ve Git'e işlenmesi gereken öğelerin sayısını gösterir.
Güncelleştirmeler , Git dalında değiştirilmiş olan ve çalışma alanına güncelleştirilmiş olması gereken öğe sayısını gösterir.

Her bölümde, değiştirilen öğeler durumu gösteren bir simgeyle listelenir:

  • Yeni
  • Değiştirilmiş
  • Silin
  • anlaşmazlık

Panelin üst kısmındaki Yenile düğmesi , değişiklik ve güncelleştirme listesini güncelleştirir.

Değiştirilen öğelerin durumunu gösteren kaynak denetim masasının ekran görüntüsü.

İşleme

  • Çalışma alanında değiştirilen öğeler Değişiklikler bölümünde listelenir. Birden fazla öğe değiştiğinde, 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.

Dallar

Kaynak denetim masasının Dallar sekmesi, dallarınızı yönetmenize ve dalla ilgili eylemler gerçekleştirmenize olanak tanır. İki ana bölümü vardır:

  • Geçerli dalda gerçekleştirebileceğiniz eylemler:

    • Yeni çalışma alanına dallanma (herhangi bir rol): Geçerli çalışma alanına bağlı dalın son işlemesini temel alan yeni bir çalışma alanı ve yeni dal oluşturur. Yeni çalışma alanına ve yeni dala bağlanır.
    • Yeni dalı kullanıma alma (çalışma alanı yöneticisi olmalıdır): Çalışma alanında son eşitlenen işlemeyi temel alan yeni bir dal oluşturur ve geçerli çalışma alanında Git bağlantısını değiştirir. Çalışma alanı içeriğini değiştirmez.
    • Dal değiştir (çalışma alanı yöneticisi olmalıdır): Çalışma alanını başka bir yeni veya mevcut dalla eşitler ve çalışma alanındaki tüm öğeleri seçilen dalın içeriğiyle geçersiz kılar.

    Kaynak denetim masasındaki dallanma sekmesinin ekran görüntüsü.

  • İlgili dallar.
    Dallar sekmesinde, seçebileceğiniz ve geçiş yapabileceğiniz ilgili çalışma alanlarının listesi de bulunur. İlgili çalışma alanı, aynı kuruluş, proje, depo ve git klasörü gibi geçerli dal ile aynı bağlantı özelliklerine sahip bir çalışma alanıdır.
    Bu, doku çalışma alanları listenizde aramak zorunda kalmadan geçerli çalışmanızın bağlamı ile ilgili diğer dallara bağlı çalışma alanlarına gitmenize olanak tanır.
    İlgili çalışma alanını açmak için listedeki bir öğeye tıklayın.

    Kullanıcının geçiş yapabilecekleri ilgili dalların listesini gösteren ekran görüntüsü.

Daha fazla bilgi için bkz . Dallanma sınırlamaları .

Firma ayrıntıları

Hesap ayrıntıları sekmesi, kullanıcının bağlı olduğu GitHub hesabının ayrıntılarını gösterir. İki bölümü vardır. Üst bölümde Git sağlayıcısı ve hesap adı gösterilir. Alt bölümde, çalışma alanının bağlı olduğu depo ve dal gösterilir. Şu anda bu sekme yalnızca GitHub'a bağlı çalışma alanları için kullanılabilir.

GitHub hesabı ayrıntıları şunlardır:

  • Git hesabı ayrıntıları

    • Provider
    • Hesap adı
  • Git deposu

  • Şube

Git ayrıntılarını, depo ve dal adlarını gösteren Kaynak denetim masasında hesaplar sekmesinin ekran görüntüsü.

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:

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

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.
  • Gelişmiş yenileme API'sini kullanarak bir anlam modelini yenilemek, her yenilemeden sonra Git farkına neden olur.