Felsöka fel för Databricks Git-mappar

Den här sidan beskriver vanliga fel och oväntat beteende när du använder Azure Databricks Git-mappar med en fjärransluten Git-provider, grupperad efter kategori för att hjälpa dig att identifiera orsaken snabbare. Om ingen av vägledningarna här löser problemet kan du läsa Hämta hjälp.

Autentiseringsfel

Dessa fel uppstår när Azure Databricks inte kan verifiera din identitet med git-fjärrprovidern.

Invalid credentials

Prova följande:

• Bekräfta att Git-integreringsinställningarna (Inställningar>Länkade konton) är korrekta. Du måste ange både ditt användarnamn och token för Git-providern.

• Bekräfta att du har valt rätt Git-provider i Inställningar>Länkade konton.

• Kontrollera att din personliga åtkomsttoken eller ditt applösenord har rätt lagringsplatsåtkomst.

• Om din Git-provider har aktiverat enkel inloggning auktoriserar du dina token för enkel inloggning.

• Testa din token med Git-kommandoraden. Ersätt textsträngarna inom vinkelparenteser:

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

SSL-anslutningsfel

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

Det här felet uppstår när Azure Databricks inte kan nå din Git-server via HTTPS. Det indikerar vanligtvis ett problem med nätverksanslutningen eller ett TLS-certifikatproblem i organisationens Git-infrastruktur.

Innan du kontaktar ditt Azure Databricks kontoteam måste du ha följande information klar:

• URL:en för din Git-server
• Om servern använder ett självsignerat eller privat CA-certifikat
• Om andra användare på samma arbetsyta ser samma fel

Fel med Microsoft Entra ID-autentiseringsuppgifter

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

Det här felet kan inträffa när din organisation nyligen har aktiverat en princip för multifaktorautentisering (MFA). När MFA-tillämpningen börjar gälla kanske befintliga Microsoft Entra ID sessioner inte uppfyller de nya autentiseringskraven och anslutningen misslyckas.

Så här löser du felet:

1. Gå till portal.azure.com och logga ut från Microsoft Entra ID.
2. Logga in igen. Du bör se en uppmaning om att slutföra MFA.

Om det inte fungerar loggar du ut från alla Azure tjänster innan du loggar in igen.

Fel i lagringsplatsens tillstånd

Dessa fel uppstår när den lokala Git-mappen når ett tillstånd som förhindrar normala åtgärder.

Frånkopplat huvudtillstånd

I Git syftar "HEAD" på den aktuella positionen i commithistoriken, och den pekar normalt på en gren. När HEAD pekar direkt på en specifik commit i stället för en gren, är arkivet i ett "detached HEAD"-tillstånd. Git spårar inte ändringar som görs i det här läget på någon gren. Om du navigerar bort utan att först skapa en ny gren kan dessa ändringar gå förlorade.

En Git-mapp kan ange det frånkopplade huvudtillståndet när:

• Någon tar bort fjärrgrenen. Azure Databricks försöker återställa lokala ändringar som inte har checkats in genom att tillämpa dem på standardgrenen. Om det finns motstridiga ändringar tillämpar Azure Databricks dem på en ögonblicksbild av standardgrenen, vilket resulterar i ett frånkopplat huvud.
• En användare eller ett tjänsthuvudnamn checkar ut en tagg via update repoAPI.

Så här återställer du från det här tillståndet:

1. Klicka på Skapa gren för att skapa en gren från den aktuella committen, eller Välj gren för att checka ut en befintlig gren.
2. Commita och pusha för att behålla dina ändringar. Om du vill ta bort ändringar klickar du på kebabmeny under Ändringar.

Inkonsekvent tillstånd i arkivet

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

Det här felet anger att ett problem uppstod när mappar skulle tas bort. Lagringsplatsen är nu i ett inkonsekvent tillstånd. Ta bort och klona lagringsplatsen igen för att återställa dess tillstånd.

Konflikter i notebook-namn

Notebook-filer med identiska eller liknande filnamn kan orsaka fel när du skapar en lagringsplats eller pull-begäran:

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

Namngivningskonflikter kan uppstå även med olika filnamnstillägg. Dessa två filer är till exempel i konflikt:

• notebook.ipynb
• notebook.py

Åtgärda konflikten genom att byta namn på anteckningsboken, filen eller mappen som bidrar till feltillståndet. Om felet uppstår när du klonar repo:t, byt namn på notebookarna, filerna eller mapparna i det fjärranslutna Git-repo:t.

Oväntat beteende

De här problemen genererar inte ett tydligt felmeddelande, men de är tecken på ett problem som behöver undersökas.

Timeout-felmeddelanden

Åtgärder som att klona en stor lagringsplats eller checka ut en stor gren kan resultera i timeout-fel. Åtgärden kan fortfarande slutföras i bakgrunden efter tidsgränsen.

Om du ser ett timeout-fel:

1. Vänta några minuter och uppdatera sedan Git-mappen. Om de förväntade filerna eller grenarna finns har åtgärden slutförts.
2. Om arbetsytan var hårt belastad försöker du utföra åtgärden igen när belastningen har minskat.

Använd sparse checkout för att undvika timeout-fel i stora kodförråd och bara arbeta med de filer du behöver.

404-fel

Om du får ett 404-fel när du öppnar en fil som inte är notebook-fil väntar du några minuter och försöker igen. Det finns en kort fördröjning mellan när systemet aktiverar arbetsytan och när webbappen hämtar konfigurationen.

Anteckningsböcker verkar ha ändrats utan att användaren har redigerat dem

Om varje rad i en notebook-fil visas som ändrad utan användarredigeringar beror ändringarna sannolikt på skillnader i radslut. Azure Databricks använder radslutstecken i Linux-format (LF), vilket kan skilja sig från filer som har checkats in i Windows-system (CRLF).

Om du vill diagnostisera det här problemet kontrollerar du om du har en .gitattributes fil:

• Den får inte innehålla * text eol=crlf.
• Om du inte använder Windows tar du bort den här inställningen. Både din utvecklingsmiljö och Azure Databricks använder radslutstecken för Linux.
• Om du använder Windows ändrar du inställningen till * text=auto. Git lagrar sedan filer med linjeslut i Linux-stil internt, men checkar ut med plattformsspecifika radslut automatiskt.

Om du redan har checkat in filer med radslutstecken i Windows-format i Git:

1. Rensa eventuella utestående ändringar.
2. Uppdatera filen enligt beskrivningen .gitattributes ovan för din miljö.
3. Genomför ändringen.
4. Kör git add --renormalize. Checka in och skicka alla ändringar.

Återställa borttagna filer

Filåterställbarheten varierar beroende på åtgärd. Vissa åtgärder tillåter återställning via papperskorgen , medan andra inte gör det. Om du vill återställa filer som tidigare checkats in och push-överförts till en fjärrgren använder du fjärrlagringsplatsens Git-incheckningshistorik:

Få hjälp

Om inget av riktlinjerna på den här sidan löser problemet kontaktar du Azure Databricks support. Ta med följande när du kontaktar supporten:

• Det exakta felmeddelandet
• Namnet på git-providern och om lagringsplatsen är offentlig eller privat
• Om problemet påverkar alla användare eller bara vissa användare på din arbetsyta
• De steg som du redan har provat