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 tümleştirmesine genel bakışı okumanız önerilir.

Önkoşullar

Git'i Microsoft Fabric çalışma alanınızla tümleştirmek için hem Doku hem de Git için aşağıdaki önkoşulları ayarlamanız gerekir.

Doku önkoşulları

Git tümleştirme özelliğine erişmek için aşağıdakilerden birine ihtiyacınız vardır:

• Power BI Premium lisansı. Power BI premium lisansı yalnızca tüm Power BI öğelerini destekler.
• Doku kapasitesi. Desteklenen tüm Doku öğelerini kullanmak için Doku kapasitesi gereklidir. Henüz bir aboneliğiniz yoksa ücretsiz deneme sürümüne kaydolun.

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

• Kullanıcılar Doku öğ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:

Azure DevOps sınırlamaları

• Doku çalışma alanını kullanan aynı kullanıcıya kayıtlı etkin bir Azure hesabı. Ücretsiz bir hesap oluşturun.
• Mevcut bir depoya erişim.

GitHub sınırlamaları

• Etkin bir GitHub hesabı. GitHub hesabı oluşturun.

• Aşağıdaki kişisel erişim belirteçlerinden biri:

  • Depo izinleri altında İçerik okuma ve yazma iznine sahip ayrıntılı bir belirteç (önerilir):

    

    Bu belirteci GitHub Enterprise ile kullanmak için şu yönergeleri izleyin.

  • Depo kapsamları etkinleştirilmiş bir GitHub klasik belirteci oluşturma:

    

Ç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. Doku'da oturum açın ve bağlanmak istediğiniz çalışma alanına gidin.

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.

Azure DevOps Connect

Azure DevOps'u seçerseniz Bağlan'ı seçerek Doku'da oturum açan Microsoft Entra kullanıcısına kayıtlı Azure Repos hesabında otomatik olarak oturum açın.

GitHub Connect

GitHub'ı seçerseniz GitHub hesabınızda oturum açmanız gerekir.
Doku'dan ilk kez oturum açıyorsanız Hesap ekle'yi seçin veya listelenen hesaplardan birini seçin. Oturum açtığınızda Doku'ya GitHub hesabınıza erişmesine izin vermek için Bağlan'ı seçin.

İlk kez bağlanıyorsanız GitHub kullanıcınızı yetkilendirmeniz gerekir. Aşağıdaki bilgileri girin:

• Görünen ad - her GitHub kullanıcısı için benzersiz olmalıdır
• Klasik veya ayrıntılı kişisel erişim belirtecinizi - kişisel erişim belirteci
• Depo URL'si (isteğe bağlı) - URL girmezseniz, erişiminiz olan herhangi bir depoya bağlanabilirsiniz. URL girerseniz, yalnızca bu depoya bağlanabilirsiniz.

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

Azure DevOps dal bağlantısı

1. Açılan menüden, bağlanmak istediğiniz dal hakkında aşağıdaki ayrıntıları belirtin:

   Not

   Bir çalışma alanını tek seferde yalnızca bir dala ve bir klasöre bağlayabilirsiniz.

   • Kuruluş
   • Proje
   • Git deposu.
   • Dal (Açılan menüyü kullanarak mevcut bir dalı seçin veya + Yeni Dal'ı seçerek yeni bir dal oluşturun. Aynı anda yalnızca bir dala bağlanabilirsiniz.)
   • Klasör (Varolan bir klasörün adını yazın veya yeni bir klasör oluşturmak için bir ad girin. Klasör adını boş bırakırsanız, kök klasörde içerik oluşturulur. Aynı anda yalnızca bir klasöre bağlanabilirsiniz.)

GitHub dal bağlantısı

1. Açılan menüden, bağlanmak istediğiniz dal hakkında aşağıdaki ayrıntıları belirtin:

   Not

   Bir çalışma alanını tek seferde yalnızca bir dala ve bir klasöre bağlayabilirsiniz.

   • Depo URL'si. Kapsamlı bir belirteç kullanarak GitHub'a bağlandıysanız URL otomatik olarak doldurulur ve yalnızca bu depoya bağlanabilirsiniz.
   • Dal (Açılan menüyü kullanarak mevcut bir dalı seçin veya + Yeni Dal'ı seçerek yeni bir dal oluşturun. Aynı anda yalnızca bir dala bağlanabilirsiniz.)
   • Klasör (Varolan bir klasörün adını yazın veya yeni bir klasör oluşturmak için bir ad girin. Klasör adını boş bırakırsanız, kök klasörde içerik oluşturulur. Aynı anda yalnızca bir klasöre bağlanabilirsiniz.)

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

İlk eşitleme sırasında, çalışma alanı veya Git dalı boşsa, içerik boş konumdan boş konuma 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. İşlemeler hakkında daha fazla bilgi edinin.

Git'e kaydetme

Değişikliklerinizi Git dalında işlemek için şu adımları izleyin:

1. Çalışma alanına gidin.

2. Kaynak denetimi simgesini seçin. Bu simge, kaydedilmemiş değişikliklerin sayısını gösterir.

3. Kaynak denetim masasından Değişiklikler'i seçin. Değiştirdiğiniz tüm öğelerle birlikte bir liste ve öğenin yeni , değiştirilmiş, çakışan veya silinmiş olduğunu belirten bir simge görüntülenir.

4. İşlemek istediğiniz öğeleri seçin. Tüm öğeleri seçmek için üstteki kutuyu işaretleyin.

5. Kutuya açıklama ekleyin. Açıklama eklemezseniz, otomatik olarak bir varsayılan ileti eklenir.

6. İşle'yi seçin.

   

Değişiklikler işlendikten sonra, işlenen öğeler listeden kaldırılır ve çalışma alanı eşitlendiği yeni işlemeye işaret eder.

İşleme başarıyla tamamlandıktan sonra, seçili öğelerin durumu Kaydedilmemiş olan Eşitlendi olarak değişir.

Kaydedilen değişikliği geri alma

Değişiklikleri çalışma alanına kaydettikten sonra, bu değişiklikleri git'e kaydetmek istemediğinize karar verirseniz, değişiklikleri geri alabilir ve bu öğeleri önceki duruma geri döndürebilirsiniz. Değişikliklerinizi geri almak için şu adımları izleyin:

1. Çalışma alanına gidin.

2. Kaynak denetimi düğmesini seçin. Bu düğme, kaydedilmemiş değişikliklerin sayısını da gösterir.

3. Kaynak denetim masasından Değişiklikler'i seçin. Değiştirdiğiniz tüm öğelerle birlikte bir liste ve değiştirilen öğenin yeni , değiştirilmiş, çakışan veya silinmiş olduğunu belirten bir simge görüntülenir.

4. Geri almak istediğiniz değişiklikleri seçin.

5. Geri Al'ı seçin.

   

6. Onaylamak için yeniden Geri Al'ı seçin.

   

Çalışma alanınızdaki seçili öğeler, çalışma alanının son eşitlendiği zamandaki haline döner.

Önemli

Bir öğeyi silip değişiklikleri geri alırsanız, öğe yeniden oluşturulur ve bazı meta veriler kaybolabilir. Örneğin, duyarlılık etiketleri tutulmaz ve sıfırlanmalıdır ve öğenin sahibi geçerli kullanıcıya ayarlanır.

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. En son değişiklikleri, birleştirmeleri veya çalışma alanına geri dönmek ve canlı öğeleri güncelleştirmek için Kaynak denetim masasını kullanın. Güncelleştirme 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.

Öğe listesi başarıyla güncelleştirildikten sonra kaldırılır ve çalışma alanı eşitlendiği yeni işlemeye işaret eder.

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'i seçin
4. Onaylamak için Bağlantıyı kes'i yeniden 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.
• Bağımsız bulutlar desteklenmez.

Azure DevOps sınırlamaları

• 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 sınırlamaları

• GitHub, coğrafi bölgeler arası doğrulamaları zorunlu kılamaz.
• Aynı anda işlenen dosyaların toplam birleşik boyutu 50 MB ile sınırlıdır. Bu nedenle, işlenecek birkaç öğeniz varsa, bazen bunları birkaç ayrı işlemeye ayırmak gerekebilir. Dosyaları işleme hakkında daha fazla bilgi için sorun giderme kılavuzumuza bakın.

GitHub Enterprise sınırlamaları

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

• IP izin verilenler listesi
• Özel ağ

Ç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.
• 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