Databricks Git 폴더에 대한 오류 문제 해결

이 페이지에서는 원인을 보다 신속하게 식별할 수 있도록 범주별로 그룹화된 원격 Git 공급자와 Azure Databricks Git 폴더를 사용할 때 발생하는 일반적인 오류 및 예기치 않은 동작에 대해 설명합니다. 여기에 있는 지침 중 어느 것도 문제를 해결하지 못하면 도움말을 참조하세요.

인증 오류

이러한 오류는 Azure Databricks 원격 Git 공급자를 사용하여 ID를 확인할 수 없는 경우에 발생합니다.

Invalid credentials

다음을 시도해 보세요.

  • Git 통합 설정(연결된 계정 설정>)이 올바른지 확인합니다. Git 공급자 사용자 이름과 토큰을 모두 입력해야 합니다.

  • 설정>연결된 계정에서 올바른 Git 공급자를 선택했는지 확인합니다.

  • 개인 액세스 토큰 또는 앱 암호에 올바른 리포지토리 액세스 권한이 있는지 확인합니다.

  • Git 공급자가 SSO를 사용하도록 설정한 경우 SSO에 대한 토큰에 권한을 부여합니다.

  • Git 명령줄을 사용하여 토큰을 테스트합니다. 텍스트 문자열을 꺾쇠 괄호로 바꿉니다.

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

SSL 연결 오류

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

이 오류는 Azure Databricks HTTPS를 통해 Git 서버에 연결할 수 없는 경우에 발생합니다. 일반적으로 조직의 Git 인프라에서 네트워크 연결 문제 또는 TLS 인증서 문제를 나타냅니다.

Azure Databricks 계정 팀에 문의하기 전에 다음 정보를 준비하세요.

  • Git 서버의 URL
  • 서버에서 자체 서명된 CA 인증서 또는 프라이빗 CA 인증서를 사용하는지 여부
  • 동일한 작업 영역의 다른 사용자에게 동일한 오류가 표시되는지 여부

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.

이 오류는 조직에서 최근에 MFA(다단계 인증) 정책을 사용하도록 설정한 경우에 발생할 수 있습니다. MFA 적용이 적용되면 기존 Microsoft Entra ID 세션이 새 인증 요구 사항을 충족하지 못할 수 있으며 연결이 실패합니다.

오류를 해결하려면:

  1. portal.azure.com로 이동한 다음 Microsoft Entra ID에서 로그아웃하세요.
  2. 다시 로그인합니다. MFA를 완료하라는 메시지가 표시됩니다.

작동하지 않는 경우 다시 로그인하기 전에 모든 Azure 서비스에서 로그아웃합니다.

리포지토리 상태 오류

이러한 오류는 로컬 Git 폴더가 정상 작업을 방해하는 상태에 도달하면 발생합니다.

분리된 헤드 상태

Git에서 "HEAD"는 커밋 기록의 현재 위치를 가리키며, 일반적으로 브랜치를 가리킵니다. 헤드가 분기가 아닌 특정 커밋을 직접 가리키는 경우 리포지토리는 "분리된 헤드" 상태입니다. Git은 어떤 브랜치에서도 이 상태에서 이루어진 변경 사항을 추적하지 않습니다. 먼저 새 분기를 만들지 않은 채 이 페이지를 벗어나면 해당 변경 내용이 손실될 수 있습니다.

Git 폴더는 다음과 같은 경우 분리된 헤드 상태를 입력할 수 있습니다.

  • 누군가가 원격 분기를 삭제합니다. Azure Databricks 기본 분기에 적용하여 커밋되지 않은 로컬 변경 내용을 복구하려고 합니다. 충돌하는 변경 내용이 있는 경우 Azure Databricks는 해당 변경 내용을 기본 분기의 스냅샷에 적용하므로 분리된 헤드 상태가 됩니다.
  • 사용자 또는 서비스 주체는 API를 사용하여 태그를 체크 아웃합니다update repo.

이 상태에서 복구하려면 다음을 수행합니다.

  1. 분기 만들기를 클릭하여 현재 커밋에서 분기를 만들거나 분기를 선택하여 기존 분기를 확인합니다.
  2. 커밋하고 푸시하여 변경 내용을 유지합니다. 변경 사항을 취소하려면 Kebab 메뉴 아이콘을 클릭하십시오. 그런 다음, 변경 아래의 kebab 메뉴를 클릭하십시오.

일관성 없는 리포지토리 상태

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

이 오류는 폴더를 삭제하는 동안 문제가 발생했음을 나타냅니다. 이제 리포지토리가 일관되지 않은 상태입니다. 리포지토리를 삭제하고 다시 복제하여 상태를 다시 설정합니다.

전자 필기장 이름 충돌

동일하거나 유사한 파일 이름을 가진 노트북은 리포지토리 또는 풀 요청을 만들 때 오류를 일으킬 수 있습니다.

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

다른 파일 확장자를 사용하는 경우에도 명명 충돌이 발생할 수 있습니다. 예를 들어 다음 두 파일이 충돌합니다.

  • notebook.ipynb
  • notebook.py

다이어그램: 전자 필기장, 파일 또는 폴더의 이름 충돌

충돌을 해결하려면 오류 상태에 영향을 주는 전자 필기장, 파일 또는 폴더의 이름을 바꿉니다. 리포지토리를 복제할 때 오류가 발생하면 원격 Git 리포지토리의 Notebook, 파일 또는 폴더 이름을 바꿉니다.

예기치 않은 동작

이러한 문제는 명확한 오류 메시지를 생성하지 않지만 조사가 필요한 문제의 징후입니다.

시간 제한 오류

대형 리포지토리를 복제하거나 대형 브랜치를 체크아웃하는 작업은 타임아웃 오류를 발생시킬 수 있습니다. 시간이 초과된 후에도 백그라운드에서 작업이 완료될 수 있습니다.

시간 제한 오류가 표시되는 경우:

  1. 몇 분 정도 기다린 다음 Git 폴더를 새로 고칩니다. 예상된 파일 또는 분기가 있으면 작업이 성공적으로 완료되었습니다.
  2. 작업 영역이 부하가 많은 경우 부하가 감소한 후 작업을 다시 시도합니다.

큰 리포지토리가 있는 시간 제한을 방지하려면 스파스 체크 아웃 을 사용하여 필요한 파일만 작업합니다.

404 오류

전자 필기장이 아닌 파일을 열 때 404 오류가 발생하면 몇 분 정도 기다렸다가 다시 시도하세요. 시스템에서 작업 영역을 사용하도록 설정하는 시기와 웹앱이 구성을 선택하는 시점 사이에는 잠시 지연이 있습니다.

전자 필기장이 사용자 편집 없이 수정된 것으로 표시됨

전자 필기장의 모든 줄이 사용자 편집 없이 수정된 것으로 나타나면 줄 끝 차이로 인해 변경될 수 있습니다. Azure Databricks는 Linux 스타일 줄 끝(LF)을 사용하며, 이는 Windows 시스템에서 커밋된 파일(CRLF)과 다를 수 있습니다.

이 문제를 진단하려면 .gitattributes 파일이 있는지 확인하세요:

  • 포함할 수 없습니다 * text eol=crlf.
  • Windows를 사용하지 않는 경우 이 설정을 제거합니다. 개발 환경과 Azure Databricks 모두 Linux 줄 끝을 사용합니다.
  • Windows를 사용하는 경우 설정을 .로 변경합니다 * text=auto. 그런 다음 Git은 내부적으로 Linux 스타일 줄 끝으로 파일을 저장하지만 플랫폼별 줄 끝으로 자동으로 체크 아웃합니다.

이미 Windows 형식의 줄 끝 문자가 포함된 파일을 Git에 커밋했다면:

  1. 미해결 변경 내용을 지웁다.
  2. .gitattributes 사용자 환경에 대해 위에서 설명한 대로 파일을 업데이트합니다.
  3. 변경 내용을 커밋합니다.
  4. git add --renormalize를 실행합니다. 모든 변경 내용을 커밋하고 푸시합니다.

삭제된 파일 복구

파일 복구 가능성은 작업에 따라 다릅니다. 일부 작업은 휴지통 폴더를 통해 복구할 수 있지만 다른 작업은 복구하지 않습니다. 이전에 커밋되고 원격 분기에 푸시된 파일을 복원하려면 원격 리포지토리의 Git 커밋 기록을 사용합니다.

조치 파일을 복구할 수 있나요?
작업 영역 브라우저를 사용하여 파일 삭제 예, \휴지통 폴더에서\
Git 폴더 대화 상자를 사용하여 새 파일 삭제 예, \휴지통 폴더에서\
Git 폴더 대화 상자를 사용하여 수정된 파일 삭제 아니요, 파일이 사라졌습니다.
reset (하드) 커밋되지 않은 파일 수정 아니요, 파일 수정이 사라졌습니다.
reset 커밋되지 않은 새로 만든 파일에 대한 (하드) 아니요, 파일 수정이 사라졌습니다.
Git 폴더 대화 상자를 사용하여 분기 전환 예, 원격 Git 리포지토리에서
Git 폴더 대화 상자의 커밋 또는 푸시와 같은 기타 Git 작업 예, 원격 Git 리포지토리에서
PATCH Repos API에서 /repos/id를 업데이트하는 작업 예, 원격 Git 리포지토리에서

도움받기

이 페이지의 지침에서 문제를 해결하지 못하면 Azure Databricks 지원에 문의하세요. 지원에 문의할 때 다음을 포함합니다.

  • 정확한 오류 메시지
  • Git 공급자의 이름 및 리포지토리가 공용인지 프라이빗인지 여부
  • 문제가 모든 사용자 또는 작업 영역의 일부 사용자에게만 영향을 주는지 여부
  • 이미 시도한 단계
  • Last updated on