Řešení chyb pro Databricks Git složky

Tato stránka popisuje běžné chyby a neočekávané chování při použití Azure Databricks složek Git se vzdáleným poskytovatelem Gitu seskupených podle kategorie, které vám pomůžou rychleji identifikovat příčinu. Pokud žádný z těchto doprovodných materiálů váš problém nevyřeší, přečtěte si nápovědu.

Chyby ověřování

K těmto chybám dochází v případě, že Azure Databricks nemůže ověřit vaši identitu u vzdáleného poskytovatele Gitu.

Invalid credentials

Vyzkoušejte následující kroky:

• Ověřte, že nastavení integrace Gitu (Settings>Propojené účty) jsou správná. Musíte zadat uživatelské jméno i token svého poskytovatele Gitu.

• Ověřte, že jste v propojených účtech> vybrali správného poskytovatele Gitu.

• Ověřte, že váš osobní přístupový token nebo heslo aplikace má správný přístup k úložišti.

• Pokud má váš poskytovatel Git povolené jednotné přihlašování, povolte tokeny pro jednotné přihlašování.

• Otestujte token pomocí příkazového řádku Gitu. Nahraďte textové řetězce v lomených závorkách:

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

Chyby připojení SSL

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

K této chybě dochází, když Azure Databricks se nemůže spojit se serverem Git přes HTTPS. Obvykle značí problém s připojením k síti nebo problém s certifikátem TLS v infrastruktuře Git vaší organizace.

Před kontaktováním týmu Azure Databricks účtu připravte následující informace:

• Adresa URL vašeho serveru Git
• Bez ohledu na to, jestli server používá certifikát podepsaný svým držitelem nebo privátní certifikační autoritu
• Jestli se ostatním uživatelům ve stejném pracovním prostoru zobrazuje stejná chyba

Chyba přihlašovacích údajů 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.

K této chybě může dojít, když vaše organizace nedávno povolila zásady vícefaktorového ověřování (MFA). Když se vynucení vícefaktorového ověřování projeví, stávající relace Microsoft Entra ID nemusí splňovat nové požadavky na ověřování a připojení selže.

Řešení chyby:

1. Přejděte na portal.azure.com a odhlaste se z Microsoft Entra ID.
2. Přihlaste se zpět. Měla by se zobrazit výzva k dokončení vícefaktorového ověřování.

Pokud to nepomůže, před dalším přihlášením se odhlaste ze všech Azure služeb.

Chyby stavu úložiště

K těmto chybám dochází, když místní složka Gitu dosáhne stavu, který brání normálním operacím.

Odpojený stav hlavy

V Gitu „HEAD“ odkazuje na aktuální pozici v historii commitů a obvykle ukazuje na větev. Když hlava odkazuje přímo na konkrétní potvrzení místo větve, úložiště je ve stavu "odpojená hlava". Git nesleduje změny provedené v tomto stavu v žádné větvi. Pokud přejdete pryč, aniž byste nejdřív vytvořili novou větev, může dojít ke ztrátě těchto změn.

Složka Gitu může přejít do stavu odpojené hlavy, když:

• Někdo odstraní vzdálenou větev. Azure Databricks se pokusí obnovit nepotvrzené místní změny tak, že je použije na výchozí větev. Pokud existují konfliktní změny, Azure Databricks je aplikuje na snímek výchozí větve, což má za následek stav detached HEAD.
• Uživatel nebo instanční objekt služby načte značku pomocí rozhraní update repo API.

Jak se zotavit z tohoto stavu:

1. Kliknutím na Vytvořit větev vytvoříte větev z aktuálního commitu nebo kliknutím na Vybrat větev přepnete na existující větev.
2. Potvrďte a odeslat změny, aby byly změny uloženy. Chcete-li zahodit změny, klikněte na Nabídka kebab v části Změny.

Nekonzistentní stav úložiště

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

Tato chyba značí, že při odstraňování složek došlo k problému. Úložiště je teď v nekonzistentním stavu. Odstraněním a opětovným klonováním úložiště resetujte jeho stav.

Konflikty názvů poznámkových bloků

Notebooky se stejným nebo podobným názvem souboru mohou způsobit chyby při vytváření repozitáře nebo žádosti o přetažení změn:

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

Konflikty pojmenování mohou nastat i s různými příponami souborů. Například tyto dva soubory kolidují:

• notebook.ipynb
• notebook.py

Pokud chcete konflikt vyřešit, přejmenujte poznámkový blok, soubor nebo složku, které přispívají ke stavu chyby. Pokud k chybě dojde při klonování úložiště, přejmenujte poznámkové bloky, soubory nebo složky ve vzdáleném úložišti Git.

Neočekávané chování

Tyto problémy nevytvářejí jasnou chybovou zprávu, ale jsou to známky problému, který potřebuje prozkoumat.

Chyby časového limitu

Operace, jako je klonování velkého úložiště nebo přepnutí na velkou větev, může vést k chybám vypršení časového limitu. Operace může být i po vypršení časového limitu nadále dokončena na pozadí.

Pokud se zobrazí chyba vypršení časového limitu:

1. Počkejte několik minut a pak aktualizujte složku Git. Pokud jsou přítomné očekávané soubory nebo větve, operace se úspěšně dokončila.
2. Pokud byl pracovní prostor zatížený velkým zatížením, zkuste operaci zopakovat po snížení zatížení.

Abyste se vyhnuli časovým limitům u velkých úložišť, použijte sparse checkout, abyste pracovali jen se soubory, které potřebujete.

Chyby 404

Pokud se při otevření jiného než poznámkového souboru zobrazí chyba 404, počkejte několik minut a zkuste to znovu. Mezi tím, kdy systém povolí pracovní prostor a kdy webová aplikace převezme konfiguraci, je krátká prodleva.

Poznámkové bloky se jeví jako změněné, aniž by je uživatel upravil.

Pokud se každý řádek poznámkového bloku zobrazí změněný bez úprav uživatele, změny jsou pravděpodobně způsobeny koncovými rozdíly mezi řádky. Azure Databricks používá konce řádků ve stylu systému Linux (LF), které se mohou lišit od konců řádků v souborech uložených v systémech Windows (CRLF).

Pokud chcete tento problém diagnostikovat, zkontrolujte, jestli máte .gitattributes soubor:

• Nemůže obsahovat * text eol=crlf.
• Pokud windows nepoužíváte, odeberte toto nastavení. Vaše vývojové prostředí i Azure Databricks používají konce řádků Linuxu.
• Pokud používáte Windows, změňte nastavení na * text=auto. Git pak ukládá soubory s koncem čar ve stylu Linuxu interně, ale automaticky se podívá na konce čar specifických pro platformu.

Pokud jste už zacommitovali soubory se znaky konce řádku systému Windows do Git repozitáře:

1. Vymažte všechny nevyřízené změny.
2. .gitattributes Aktualizujte soubor, jak je popsáno výše pro vaše prostředí.
3. Potvrďte změnu.
4. Spusťte git add --renormalize. Potvrďte a odešlete všechny změny.

Obnovení odstraněných souborů

Obnovitelnost souborů se liší podle akce. Některé akce umožňují obnovení prostřednictvím složky Koš , zatímco jiné ne. Pokud chcete obnovit dříve potvrzené a vložené soubory do vzdálené větve, použijte historii potvrzení Gitu vzdáleného úložiště:

Action	Je soubor obnovitelný?
Odstranění souboru v prohlížeči pracovního prostoru	Ano, ze složky Koš
Zahodit nový soubor pomocí dialogového okna složky Git	Ano, ze složky Koš
Zahodit upravený soubor pomocí dialogového okna složky Git	Ne, soubor je pryč.
reset (přísné) pro nepotvrzené úpravy souboru	Ne, úpravy souborů jsou pryč.
reset (hard) pro nepotvrzené, nově vytvořené soubory	Ne, úpravy souborů jsou pryč.
Přepínání větví pomocí dialogového okna složky Git	Ano, ze vzdáleného úložiště Git
Jiné operace Gitu, například potvrzení nebo nasdílení změn, z dialogového okna složky Git	Ano, ze vzdáleného úložiště Git
operace PATCH, které aktualizují /repos/id z rozhraní API Repos	Ano, ze vzdáleného úložiště Git

Získání pomoci

Pokud žádný z pokynů na této stránce váš problém nevyřeší, kontaktujte Azure Databricks podporu. Pokud se obrátíte na podporu, uveďte následující:

• Přesná chybová zpráva
• Název vašeho poskytovatele Gitu a informace o tom, jestli je úložiště veřejné nebo soukromé
• Jestli se problém týká všech uživatelů nebo jenom některých uživatelů ve vašem pracovním prostoru
• Kroky, které jste už vyzkoušeli