Databricks Git klasörleriyle ilgili sorunları giderme

Bu sayfada, nedeni daha hızlı belirlemenize yardımcı olmak için kategoriye göre gruplandırılmış Azure Databricks Git klasörlerinin uzak Git sağlayıcısıyla kullanılmasıyla ilgili yaygın hatalar ve beklenmeyen davranışlar açıklanmaktadır. Buradaki kılavuzlardan hiçbiri sorununuzu çözmezse bkz. Yardım alma.

Kimlik doğrulama hataları

Bu hatalar, Azure Databricks uzak Git sağlayıcısıyla kimliğinizi doğrulayamazsa oluşur.

Invalid credentials

Aşağıdaki işlemi deneyin:

• Git tümleştirme ayarlarının (Ayarlar>Bağlı hesaplar) doğru olduğunu onaylayın. Hem Git sağlayıcı kullanıcı adınızı hem de belirtecinizi girmelisiniz.

• Ayarlar>Bağlı hesaplar bölümünde doğru Git sağlayıcısını seçtiğinizden emin olun.

• Kişisel erişim belirtecinizin veya uygulama parolanızın doğru depo erişimine sahip olduğunu doğrulayın.

• Git sağlayıcınızda SSO etkinleştirildiyse, SSO için belirteçlerinizi yetkilendirilin.

• Belirtecinizi Git komut satırıyla test edin. Köşeli ayraç içindeki metin dizelerini değiştirin:

  git clone https://<username>:<personal-access-token>@github.com/<org>/<repo-name>.git
  

SSL bağlantı hataları

<link>: Secure connection to <link> could not be established because of SSL problems

bu hata, Azure Databricks HTTPS üzerinden Git sunucunuza erişemezse oluşur. Genellikle kuruluşunuzun Git altyapısındaki bir ağ bağlantısı sorununu veya TLS sertifika sorununu gösterir.

Azure Databricks hesap ekibinizle iletişime geçmeden önce aşağıdaki bilgileri hazır bulundurun:

• Git sunucunuzun URL'si
• Sunucunun otomatik olarak imzalanan veya özel CA sertifikası kullanıp kullanmadığı
• Aynı çalışma alanında bulunan diğer kullanıcıların aynı hatayı görüp görmediği

Microsoft Entra ID kimlik bilgileri hatası

Encountered an error with your :re[ms-entra-id] credentials. Try logging out of :re[ms-entra-id] and logging back in.

Kuruluşunuz yakın zamanda çok faktörlü kimlik doğrulaması (MFA) ilkesini etkinleştirdiğinde bu hata oluşabilir. MFA zorlaması etkin olduğunda, mevcut Microsoft Entra ID oturumları yeni kimlik doğrulama gereksinimlerini karşılamayabilir ve bağlantı başarısız olabilir.

Hatayı düzeltmek için:

1. portal.azure.com adresine gidin ve Microsoft Entra ID’den çıkış yapın.
2. Yeniden oturum açın. MFA’yı tamamlamanız için bir istem görmelisiniz.

Bu işe yaramazsa, yeniden oturum açmadan önce tüm Azure hizmetlerinden çıkış yapın.

Depo durumu hataları

Bu hatalar, yerel Git klasörü normal işlemleri engelleyen bir duruma ulaştığında oluşur.

Ayrılmış baş durumu

Git'te "head" işleme geçmişindeki geçerli konumu ifade eder ve normalde bir dala işaret eder. Baş dal yerine doğrudan belirli bir işlemeye işaret ettiğinde, depo "ayrılmış baş" durumundadır. Git, herhangi bir dalda bu durumda yapılan değişiklikleri izlemez. Önce yeni bir dal oluşturmadan giderseniz, bu değişiklikler kaybolabilir.

Git klasörü aşağıdaki durumlarda ayrılmış baş durumunu girebilir:

• Birisi uzaktaki dalı sildi. Azure Databricks, kaydedilmemiş yerel değişiklikleri varsayılan dala uygulayarak kurtarmaya çalışır. Çakışan değişiklikler varsa, Azure Databricks bunları varsayılan dalın anlık görüntüsüne uygular ve bu da ayrılmış bir kafayla sonuçlanır.
• Kullanıcı veya hizmet sorumlusu API'yi kullanarak bir etiketi kullanıma alırupdate repo.

Bu durumdan kurtulmak için:

1. Geçerli işlemeden dal oluşturmak için Dal oluştur'a veya var olan bir dalı kullanıma almak için Dalı seçin'e tıklayın.
2. Değişikliklerinizi kaydetmek ve göndermek için commit yapın ve push yapın. Değişiklikleri atmak için

Tutarsız depo durumu

There was a problem with deleting folders. The repo could be in an inconsistent state and re-cloning is recommended.

Bu hata, klasörleri silerken bir sorun oluştuğuna işaret eder. Depo artık tutarsız bir durumda. Durumunu sıfırlamak için depoyu silin ve yeniden kopyalayın.

Not defteri ad çakışmaları

Aynı veya benzer dosya adlarına sahip not defterleri, depo veya çekme isteği oluşturduğunuzda hatalara neden olabilir:

Cannot perform Git operation due to conflicting names

A folder cannot contain a notebook with the same name as a notebook, file, or folder (excluding file extensions).

Adlandırma çakışmaları farklı dosya uzantılarıyla bile oluşabilir. Örneğin, bu iki dosya çakışıyor:

• notebook.ipynb
• notebook.py

Çakışmayı düzeltmek için hata durumuna katkıda bulunan not defterini, dosyayı veya klasörü yeniden adlandırın. Depoyu kopyaladığınızda hata oluşursa, uzak Git deposundaki not defterlerini, dosyaları veya klasörleri yeniden adlandırın.

Beklenmeyen davranış

Bu sorunlar net bir hata iletisi oluşturmaz, ancak araştırılması gereken bir sorunun işaretleridir.

Zaman aşımı hataları

Büyük bir depo kopyalama veya büyük bir dalı kullanıma alma gibi işlemler zaman aşımı hatalarına neden olabilir. İşlem, zaman aşımından sonra yine de arka planda tamamlanabilir.

Zaman aşımı hatası görürseniz:

1. Birkaç dakika bekleyin, ardından Git klasörünü yenileyin. Beklenen dosyalar veya dallar varsa, işlem başarıyla tamamlanır.
2. Çalışma alanı ağır yük altındaysa, yük azaldıktan sonra işlemi yeniden deneyin.

Büyük depolarda zaman aşımlarını önlemek için yalnızca ihtiyaç duyduğunuz dosyalarla çalışmak üzere seyrek kullanıma alma özelliğini kullanın.

404 hataları

Not defteri olmayan bir dosyayı açtığınızda 404 hatası alırsanız, birkaç dakika bekleyin ve yeniden deneyin. Sistemin çalışma alanını etkinleştirmesi ile web uygulamasının yapılandırmayı alması arasında kısa bir gecikme vardır.

Not defterleri kullanıcı düzenlemeleri olmadan değiştirilmiş olarak görünür

Not defterinin her satırı hiçbir kullanıcı düzenlemesi olmadan değiştirilmiş olarak görünüyorsa, değişiklikler büyük olasılıkla satır sonu farklarından kaynaklanır. Azure Databricks, Windows sistemlerinde kaydedilen dosyalardan farklı olabilen Linux tarzı satır sonları (LF) kullanır.

Bu sorunu tanılamak için bir .gitattributes dosyanız olup olmadığını denetleyin:

• * text eol=crlf öğesini içeremez.
• Windows kullanmıyorsanız bu ayarı kaldırın. Hem geliştirme ortamınız hem de Azure Databricks Linux satır sonlarını kullanır.
• Windows kullanıyorsanız, ayarını olarak * text=autodeğiştirin. Git daha sonra Linux stili satır sonlarıyla dosyaları dahili olarak depolar, ancak platforma özgü satır sonlarıyla otomatik olarak kullanıma alır.

Dosyaları Windows satır sonu karakterleriyle zaten Git’e commit ettiyseniz:

1. Var olan değişiklikleri temizleyin.
2. .gitattributes Dosyayı ortamınız için yukarıda açıklandığı gibi güncelleştirin.
3. Değişikliği kaydedin.
4. git add --renormalize'i çalıştırın. Tüm değişiklikleri taahhüt et ve gönder.

Silinen dosyaları kurtarma

Dosya kurtarılabilirliği eyleme göre değişir. Bazı eylemler Çöp Sepeti klasörü üzerinden kurtarma sağlarken, diğerleri kurtarmaz. Daha önce işlenen ve uzak bir dala gönderilen dosyaları geri yüklemek için uzak deponun Git işleme geçmişini kullanın:

Action	Dosya kurtarılabilir mi?
Çalışma alanı tarayıcısıyla dosya silme	Evet, Çöp Sepeti klasöründen
Yeni bir dosyayı Git klasörü iletişim kutusunu kullanarak sil	Evet, Çöp Sepeti klasöründen
Git klasörü iletişim kutusuyla değiştirilmiş bir dosyayı atma	Hayır, dosya yok.
reset (sabit) kaydedilmemiş dosya değişiklikleri için	Hayır, dosya değişiklikleri yok
reset (sabit) kaydedilmemiş, yeni oluşturulan dosyalar için	Hayır, dosya değişiklikleri yok
Git klasörünün iletişim kutusunu kullanarak dalları değiştirin	Evet, uzak Git deposundan
Git klasörü iletişim kutusundan işleme veya gönderme gibi diğer Git işlemleri	Evet, uzak Git deposundan
PATCH Repos API'den /repos/id güncelleyen işlemler	Evet, uzak Git deposundan

Yardım alın

Bu sayfadaki kılavuzlardan hiçbiri sorununuzu çözmezse Azure Databricks desteğe başvurun. Desteğe başvurarak aşağıdakileri ekleyin:

• Tam hata iletisi
• Git sağlayıcınızın adı ve deponun genel mi yoksa özel mi olduğu
• Sorunun tüm kullanıcıları mı yoksa yalnızca çalışma alanınızdaki bazı kullanıcıları mı etkilediği
• Zaten denediğiniz adımlar