이 페이지에서는 Databricks Git 폴더와 관련된 일반적인 오류 메시지 및 문제 해결에 대한 지침을 제공합니다.
Invalid credentials
다음을 시도해 보세요.
Git 통합 설정(연결된 계정 설정>)이 올바른지 확인합니다. Git 공급자 사용자 이름과 토큰을 모두 입력해야 합니다.
설정>연결된 계정에서 올바른 Git 공급자를 선택했는지 확인합니다.
개인 액세스 토큰 또는 앱 암호에 올바른 리포지토리 액세스 권한이 있는지 확인합니다.
Git 공급자가 SSO를 사용하도록 설정한 경우 SSO에 대한 토큰에 권한을 부여합니다.
Git 명령줄을 사용하여 토큰을 테스트합니다. 텍스트 문자열을 꺾쇠 괄호로 바꿉니다.
git clone https://<username>:<personal-access-token>@github.com/<org>/<repo-name>.git
Secure connection...SSL problems
이 오류는 Azure Databricks가 Git 서버에 액세스할 수 없는 경우에 발생합니다. 프라이빗 Git 서버에 액세스하려면 Azure Databricks 계정 팀에 문의하세요.
<link>: Secure connection to <link> could not be established because of SSL problems
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(다단계 인증) 정책을 사용하기 시작한 경우에 발생할 수 있습니다. 오류를 해결하려면 Microsoft Entra ID로 portal.azure.com 이동하여 로그아웃합니다. 다시 로그인하면 MFA를 사용하라는 메시지가 표시됩니다.
작동하지 않는 경우 다시 로그인하기 전에 모든 Azure 서비스에서 로그아웃해 보세요.
시간 제한 오류
대형 리포지토리를 복제하거나 대형 브랜치를 체크아웃하는 작업은 타임아웃 오류를 발생시킬 수 있습니다. 그러나 백그라운드에서 작업이 완료될 수 있습니다. 작업 영역이 부하가 많은 경우 나중에 다시 시도합니다.
큰 리포지토리로 작업하려면 스파스 체크 아웃을 사용해 보세요.
404 오류
전자 필기장이 아닌 파일을 열 때 404 오류가 발생하면 몇 분 정도 기다렸다가 다시 시도하세요. 시스템에서 작업 영역을 사용하도록 설정하는 시기와 웹앱이 구성을 선택하는 시점 사이에는 잠시 지연이 있습니다.
분리된 헤드 상태
Databricks Git 폴더는 다음과 같은 경우 분리된 헤드 상태로 전환할 수 있습니다.
- 누군가가 원격 분기를 삭제합니다. Databricks는 커밋되지 않은 로컬 변경 내용을 기본 분기에 적용하여 복구하려고 합니다. 충돌하는 변경 내용이 있는 경우 Databricks는 기본 분기(분리된 헤드)의 스냅샷에 적용합니다.
- 사용자 또는 서비스 주체가 API를 사용하여 태그를 체크 아웃했습니다
update repo.
이 상태에서 복구하려면 다음을 수행합니다.
- 분기 만들기를 클릭하여 현재 커밋에서 새 분기를 만들거나 분기를 선택하여 기존 분기를 확인합니다.
- 커밋하고 푸시하여 변경 내용을 유지합니다. 변경 사항을 취소하려면
을 클릭하십시오. 그런 다음, 변경 아래의 kebab 메뉴를 클릭하십시오.
전자 필기장 이름 충돌 해결
파일 이름이 동일하거나 유사한 Notebook은 리포지토리 또는 끌어오기 요청을 만들 때 오류가 발생할 수 있습니다( 예: 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.ipynbnotebook.py
충돌을 해결하려면 오류 상태에 영향을 주는 전자 필기장, 파일 또는 폴더의 이름을 바꿉니다. 리포지토리를 복제할 때 오류가 발생하면 원격 Git 리포지토리의 Notebook, 파일 또는 폴더 이름을 바꿉니다.
오류가 재복제를 제안합니다.
There was a problem with deleting folders. The repo could be in an inconsistent state and re-cloning is recommended.
이 오류는 폴더를 삭제하는 동안 문제가 발생했음을 나타내며, 이로 인해 리포지토리가 일관되지 않은 상태로 남을 수 있습니다. 리포지토리를 삭제하고 다시 복제하여 상태를 다시 설정합니다.
전자 필기장이 사용자 편집 없이 수정된 것으로 표시됨
전자 필기장의 모든 줄이 사용자 편집 없이 수정된 것으로 나타나면 줄 끝 문자로 인해 변경될 수 있습니다. Databricks는 Windows 시스템에서 커밋된 파일과 다를 수 있는 Linux 스타일 줄 끝을 사용합니다.
이 문제를 진단하려면 .gitattributes 파일이 있는지 확인하십시오. 그렇게 하는 경우:
- 포함할 수 없습니다
* text eol=crlf. - Windows를 사용하지 않는 경우 이 설정을 제거합니다. 개발 환경과 Databricks 모두 Linux의 줄 바꿈 방식을 사용합니다.
- Windows를 사용하는 경우 설정을 .로 변경합니다
* text=auto. 그런 다음 Git은 내부적으로 Linux 스타일 줄 끝으로 파일을 저장하지만 플랫폼별 줄 끝으로 자동으로 체크 아웃합니다.
Windows 줄 끝 문자가 포함된 파일을 이미 Git에 커밋한 경우 다음 단계를 수행합니다.
- 미해결 변경 내용을 지웁다.
-
.gitattributes사용자 환경에 대해 위에서 설명한 대로 파일을 업데이트합니다. - 변경 내용을 커밋합니다.
-
git add --renormalize를 실행합니다. 모든 변경 내용을 커밋하고 푸시합니다.