Not defterleri için Git sürüm denetimi (eski)

Önemli

Eski not defteri Git tümleştirme desteği 31 Ocak 2024'te kaldırıldı. Databricks, Databricks'teki çalışmanızı uzak bir Git deposuyla eşitlemek için Databricks Git klasörlerini kullanmanızı önerir.

Bu makalede, not defterleri için Git sürüm denetiminin nasıl ayarlanacağı açıklanmaktadır (eski özellik). Ayrıca Databricks CLI veya Çalışma Alanı API'sini kullanarak not defterlerini içeri ve dışarı aktarabilir ve yerel geliştirme ortamınızda Git işlemleri gerçekleştirebilirsiniz.

Git sürüm oluşturma özelliğini etkinleştirme ve devre dışı bırakma

Varsayılan olarak sürüm denetimi etkindir. Bu ayarı değiştirmek için:

1. Ayarlar>Çalışma alanı ayarlarına gidin.
2. Gelişmiş bölümünde, “Notebook Git Sürümlendirme” anahtarının seçimini kaldırın.

Sürüm denetimini yapılandırma

Sürüm denetimini yapılandırmak için Git sağlayıcınızda erişim kimlik bilgileri oluşturun ve ardından bu kimlik bilgilerini Azure Databricks'e ekleyin.

Not defteri sürümleriyle çalışma

Geçmiş panelinde not defteri sürümleriyle çalışırsınız. Sağ kenar çubuğuna tıklayarak geçmiş panelini açın.

Not

Geçmiş paneli açıkken not defterini değiştiremezsiniz.

Not defterini GitHub'a bağlama

1. Sağ kenar çubuğundaki tıklayın. Git durum çubuğunda Git: Bağlı değil gösterilir.

   

2. Git: Bağlı değil seçeneğine tıklayın.

   Git Tercihleri iletişim kutusu görüntülenir. Not defterinizi ilk kez açtığınızda, not defteri GitHub'da olmadığı için Durum Unlink olur.

   

3. Durum alanında Bağlantı'ya tıklayın.

4. Bağlantı alanına GitHub deposunun URL'sini yapıştırın.

5. Dal açılan kutusuna tıklayın ve bir dal seçin veya yeni dalın adını yazın.

6. Git klasöründeki Yol alanında, depoda dosyanızın depolandığı yeri belirtin.

   Python not defterleri önerilen varsayılan dosya uzantısına .pysahiptir. .ipynb kullanırsanız, not defteriniz IPython not defteri biçiminde kaydedilir. Dosya GitHub'da zaten varsa, doğrudan dosyanın URL'sini kopyalayıp yapıştırabilirsiniz.

7. Not defterinizi bağlamayı tamamlamak için Kaydet'e tıklayın. Bu dosya daha önce yoksa, Bu dosyayı GitHub deponuza kaydet seçeneğine sahip bir istem görüntülenir.

8. Bir ileti yazın ve Kaydet'e tıklayın.

Not defterini GitHub'a kaydetme

Not defterinizde yaptığınız değişiklikler Azure Databricks sürüm geçmişine otomatik olarak kaydedilirken, değişiklikler GitHub'da otomatik olarak kalıcı olmaz.

1. Geçmiş panelini açmak için sağ kenar çubuğundaki tıklayın.

   

2. Not defterinizi GitHub'a kaydetmek için Şimdi Kaydet'e tıklayın. Not Defteri Sürümünü Kaydet iletişim kutusu görüntülenir.

3. İsteğe bağlı olarak, değişikliğinizi açıklamak için bir ileti girin.

4. Git’e de kaydet seçeneğinin seçili olduğundan emin olun.

   

5. Kaydet'e tıklayın.

Not defterini GitHub'dan bir sürüme geri döndürme veya güncelleştirme

Bir not defterini bağladığınızda Azure Databricks, geçmiş panelini her yeniden açtığınızda geçmişinizi Git ile eşitler. Git ile senkronize edilen sürümlerin kaydında commit hash’leri yer alır.

1. Geçmiş panelini açmak için sağ kenar çubuğundaki tıklayın.

   

2. Geçmiş panelinde bir girdi seçin. Azure Databricks bu sürümü görüntüler.

3. Bu sürümü geri yüklemek içintıklayın.

4. Bu sürümü geri yüklemek istediğinizi onaylamak için Onayla'ya tıklayın.

Not defterinin bağlantısını kaldırın

1. Geçmiş panelini açmak için sağ kenar çubuğundaki tıklayın.

2. Git durum çubuğunda Git: Eşitlendi görüntülenir.

   

3. Git: Eşitlendi seçeneğine tıklayın.

   

4. Git Tercihleri iletişim kutusunda Bağlantıyı Kaldır'a tıklayın.

5. Kaydet'e tıklayın.

6. Not defterinin sürüm denetimiyle bağlantısını kaldırmak istediğinizi onaylamak için Onayla'ya tıklayın.

Dalları kullanma

Deponuzun herhangi bir dalında çalışabilir ve Azure Databricks içinde yeni dallar oluşturabilirsiniz.

Dal oluşturma

1. Geçmiş panelini açmak için sağ kenar çubuğundaki tıklayın.

2. GitHub panelini açmak için Git durum çubuğuna tıklayın.

3. Dal açılır menüsüne tıklayın.

4. Bir dal adı girin.

   

5. Açılır menünün alt kısmındaki Dal Oluştur seçeneğini belirleyin. Üst dal belirtilir. Her zaman şu anda seçili olan daldan dallanırsınız.

Çekme isteği oluşturma

1. Geçmiş panelini açmak için sağ kenar çubuğundaki tıklayın.

2. GitHub panelini açmak için Git durum çubuğuna tıklayın.

   

3. PR Oluştur'a tıklayın. GitHub, bu dal için bir çekme talebi sayfasını açar.

Bir dalı rebase et

Ayrıca Azure Databricks'in içinde dalınızı yeniden temel alabilirsiniz. Ana dalda yeni commit’ler varsa Rebase bağlantısı görüntülenir. Yalnızca üst deponun varsayılan dalını temel alan rebase işlemi desteklenir.

Örneğin, üzerinde databricks/reference-appsçalıştığınızı varsayalım. Onu kendi hesabınıza (örneğin, brkyvz) çatallayıp my-branch adlı bir dal üzerinde çalışmaya başlarsınız. databricks:master öğesine yeni bir güncelleştirme gönderildiğinde Rebase düğmesi görüntülenir ve değişiklikleri dalınıza brkyvz:my-branch çekebilirsiniz.

Yeniden boyutlandırma, Azure Databricks'te biraz farklı çalışır. Aşağıdaki dal yapısını varsayın:

Yeniden temel aldıktan sonra dal yapısı şöyle görünür:

Burada farklı olan C5 ve C6 İşlemelerinin C4 üzerine uygulanmamasıdır. Bunlar not defterinizde yerel değişiklikler olarak görünür. Birleştirme çakışmaları aşağıdaki gibi görünür:

Ardından Şimdi Kaydet düğmesini kullanarak değişikliklerinizi GitHub'a bir kez daha commit edebilirsiniz.

Az önce rebase ettiğim dalımdan biri yeni bir dal oluşturduysa ne olur?

Dalınız (örneğin, branch-a) başka bir dalın temeliyse (branch-b ) ve yeniden temel alırsanız, endişelenmenize gerek yok! Bir kullanıcı branch-b üzerinde de rebase yaptığında her şey yoluna girecektir. Bu durumda en iyi uygulama, her not defteri için ayrı bir dal kullanmaktır.

Kod incelemeleri için en iyi yöntemler

Azure Databricks, Git dallanmayı destekler.

• Bir not defterini depodaki herhangi bir dala bağlayabilirsiniz. Azure Databricks, her not defteri için ayrı bir dal kullanılmasını önerir.
• Geliştirme sırasında, bir not defterini bir deponun çatalı veya ana depodaki varsayılan olmayan bir dala bağlayabilirsiniz. Değişikliklerinizi üst akışa tümleştirmek için Azure Databricks'teki Git Tercihleri iletişim kutusundaki PR Oluştur bağlantısını kullanarak bir GitHub çekme isteği oluşturabilirsiniz. Ana depoya ait varsayılan dal üzerinde çalışmıyorsanız çekme isteği oluşturma bağlantısı yalnızca o zaman görüntülenir.

Sorun giderme

GitHub geçmişini eşitleme ile ilgili hatalar alırsanız aşağıdakileri doğrulayın:

• Not defterini yalnızca boş olmayan, başlatılmış bir Git deposuna bağlayabilirsiniz. Web tarayıcısında URL'yi test edin.
• GitHub kişisel erişim belirteci etkin olmalıdır.
• Özel GitHub deposunu kullanmak için depoyu okuma izniniz olmalıdır.
• Not defteri yeniden adlandırılan bir GitHub dalı ile bağlantılıysa, değişiklik Otomatik olarak Azure Databricks'e yansıtılmaz. Notebook'u manuel olarak yeniden dalla bağlamanız gerekir.

Databricks Git klasörlerine geçiş

Eski Git sürüm denetiminden Databricks Git klasörlerine geçirilmesi gereken kullanıcılar aşağıdaki kılavuzu kullanabilir:

• Eski Git tümleştirmesinden Databricks Git klasörlerine geçme