Pemecahan masalah kesalahan untuk folder Databricks Git

Halaman ini menjelaskan kesalahan umum dan perilaku tak terduga saat menggunakan folder Git Azure Databricks dengan penyedia Git jarak jauh, dikelompokkan menurut kategori untuk membantu Anda mengidentifikasi penyebabnya dengan lebih cepat. Jika tidak ada panduan di sini yang menyelesaikan masalah Anda, lihat Mendapatkan bantuan.

Kesalahan autentikasi

Kesalahan ini terjadi ketika Azure Databricks tidak dapat memverifikasi identitas Anda dengan penyedia Git jarak jauh.

Invalid credentials

Cobalah langkah-langkah berikut:

• Konfirmasikan bahwa pengaturan integrasi Git (Pengaturan>Akun tertaut) sudah benar. Anda harus memasukkan nama pengguna dan token penyedia Git Anda.

• Konfirmasikan bahwa Anda memilih penyedia Git yang benar di Pengaturan>Akun tertaut.

• Verifikasi bahwa token akses pribadi atau kata sandi aplikasi Anda memiliki akses repositori yang benar.

• Jika penyedia Git Anda mengaktifkan SSO, otorisasi token Anda untuk SSO.

• Uji token Anda dengan baris perintah Git. Ganti string teks dalam tanda kurung sudut:

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

Kesalahan koneksi SSL

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

Kesalahan ini terjadi ketika Azure Databricks tidak dapat menjangkau server Git Anda melalui HTTPS. Biasanya menunjukkan masalah konektivitas jaringan atau masalah sertifikat TLS pada infrastruktur Git organisasi Anda.

Sebelum menghubungi tim akun Azure Databricks Anda, siapkan informasi berikut:

• URL dari server Git Anda
• Apakah server menggunakan sertifikat CA yang ditandatangani sendiri atau privat
• Apakah pengguna lain di ruang kerja yang sama melihat kesalahan yang sama

Kesalahan kredensial Microsoft Entra ID

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

Kesalahan ini dapat terjadi ketika organisasi Anda baru-baru ini mengaktifkan kebijakan autentikasi multifaktor (MFA). Ketika penerapan MFA berlaku, sesi Microsoft Entra ID yang ada mungkin tidak memenuhi persyaratan autentikasi baru, dan koneksi gagal.

Untuk mengatasi masalah ini:

1. Buka portal.azure.com lalu keluar dari Microsoft Entra ID.
2. Masuk kembali. Anda akan melihat perintah untuk menyelesaikan proses MFA.

Jika tidak berhasil, keluar dari semua layanan Azure sebelum masuk lagi.

Kesalahan status repositori

Kesalahan ini terjadi ketika folder Git lokal mencapai status yang mencegah operasi normal.

Status kepala yang dilepas

Dalam Git, "head" mengacu pada posisi saat ini dalam riwayat commit, dan biasanya merujuk ke sebuah branch. Ketika HEAD menunjuk langsung ke commit tertentu, bukan ke branch, repositori berada dalam status "detached HEAD". Git tidak melacak perubahan yang dibuat dalam status ini di cabang mana pun. Jika Anda menavigasi pergi tanpa terlebih dahulu membuat cabang baru, perubahan tersebut mungkin hilang.

Folder Git dapat memasuki status detached HEAD saat:

• Seseorang menghapus cabang jarak jauh. Azure Databricks mencoba memulihkan perubahan lokal yang belum di-commit dengan menerapkannya ke cabang default. Jika ada perubahan yang bertentangan, Azure Databricks menerapkannya pada rekam jepret cabang default, yang mengakibatkan kepala yang terlepas.
• Pengguna atau perwakilan layanan memeriksa tag menggunakan update repo API.

Untuk pulih dari kondisi ini:

1. Klik Buat cabang untuk membuat cabang dari penerapan saat ini, atau Pilih cabang untuk memeriksa cabang yang ada.
2. Terapkan dan dorong untuk menyimpan perubahan Anda. Untuk membuang perubahan, klik menu kebab di bawah Perubahan.

Status repositori yang tidak konsisten

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

Kesalahan ini menunjukkan bahwa terjadi masalah saat menghapus folder. Repositori sekarang dalam keadaan tidak konsisten. Hapus dan klon ulang repositori untuk mengatur ulang statusnya.

Konflik nama buku catatan

Notebook dengan nama file yang identik atau serupa dapat menyebabkan kesalahan saat Anda membuat repositori atau permintaan pull:

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

Konflik penamaan dapat terjadi bahkan dengan ekstensi file yang berbeda. Misalnya, kedua file ini berkonflik:

• notebook.ipynb
• notebook.py

Untuk memperbaiki konflik, ganti nama buku catatan, file, atau folder yang berkontribusi pada status kesalahan. Jika kesalahan terjadi saat Anda mengkloning repositori, ganti nama notebook, file, atau folder di repositori Git jarak jauh.

Perilaku tak terduga

Masalah ini tidak menghasilkan pesan kesalahan yang jelas, tetapi merupakan tanda-tanda masalah yang perlu diselidiki.

Kesalahan Batas Waktu Habis

Operasi seperti mengkloning repositori besar atau memeriksa keluar cabang besar dapat mengakibatkan kesalahan batas waktu. Proses mungkin masih dapat diselesaikan di latar belakang setelah waktu tunggu habis.

Jika Anda melihat kesalahan waktu habis:

1. Tunggu beberapa menit, lalu refresh folder Git. Jika file atau cabang yang diharapkan ada, operasi telah berhasil.
2. Jika ruang kerja berada di bawah beban berat, coba lagi operasi setelah beban berkurang.

Untuk menghindari timeout pada repositori besar, gunakan sparse checkout agar hanya bekerja dengan file yang Anda perlukan.

Kesalahan 404

Jika Anda mendapatkan kesalahan 404 saat membuka file non-buku catatan, tunggu beberapa menit dan coba lagi. Ada penundaan singkat antara ketika sistem mengaktifkan ruang kerja dan ketika aplikasi web mengambil konfigurasi.

Notebook tampak telah diubah tanpa diedit oleh pengguna

Jika setiap baris buku catatan tampak dimodifikasi tanpa pengeditan pengguna, perubahan tersebut kemungkinan disebabkan oleh perbedaan akhir baris. Azure Databricks menggunakan karakter akhir baris bergaya Linux (LF), yang dapat berbeda dari file yang di-commit pada sistem Windows (CRLF).

Untuk mendiagnosis masalah ini, periksa apakah Anda memiliki .gitattributes file:

• Ini tidak dapat berisi * text eol=crlf.
• Jika Anda tidak menggunakan Windows, hapus pengaturan ini. Baik lingkungan pengembangan Anda maupun Azure Databricks menggunakan akhiran baris Linux.
• Jika Anda menggunakan Windows, ubah pengaturan menjadi * text=auto. Git kemudian menyimpan file dengan akhiran baris gaya Linux secara internal, tetapi secara otomatis mengecek keluar dengan akhiran baris sesuai platform.

Jika Anda sudah meng-commit file dengan karakter akhir baris Windows ke Git:

1. Hapus perubahan yang tertunda.
2. Perbarui file .gitattributes sesuai dengan penjelasan di atas untuk lingkungan Anda.
3. Terapkan perubahan.
4. Jalankan git add --renormalize. Terapkan dan dorong semua perubahan.

Memulihkan file yang dihapus

Pemulihan file bervariasi menurut tindakan. Beberapa tindakan memungkinkan pemulihan melalui folder Sampah , sedangkan tindakan lain tidak. Untuk memulihkan file yang sebelumnya di-commit dan di-push ke branch remote, gunakan riwayat commit Git dari repositori jarak jauh.

Action	Apakah file dapat dipulihkan?
Hapus file menggunakan penjelajah ruang kerja	Ya, dari folder Sampah
Buang file baru dengan dialog folder Git	Ya, dari folder Sampah
Membuang file yang dimodifikasi dengan dialog folder Git	Tidak, file hilang
reset (hard) untuk modifikasi file yang belum dikomit	Tidak, modifikasi file hilang
reset (hard) untuk file yang belum di-commit dan baru dibuat	Tidak, modifikasi file hilang
Beralih cabang dengan dialog Git folder	Ya, dari repositori Git jarak jauh
Operasi Git lainnya, seperti commit atau push, dari dialog folder Git	Ya, dari repositori Git jarak jauh
PATCH operasi pembaruan /repos/id dari API Repositori	Ya, dari repositori Git jarak jauh

Dapatkan bantuan

Jika tidak ada panduan di halaman ini yang menyelesaikan masalah Anda, hubungi dukungan Azure Databricks. Saat Anda menghubungi dukungan, sertakan hal berikut:

• Pesan kesalahan yang tepat
• Nama penyedia Git Anda dan apakah repositori bersifat publik atau privat
• Apakah masalah memengaruhi semua pengguna atau hanya beberapa pengguna di ruang kerja Anda
• Langkah-langkah yang telah Anda coba