Risoluzione degli errori relativi alle cartelle Git di Databricks

Questa pagina descrive gli errori comuni e il comportamento imprevisto quando si usano Azure Databricks cartelle Git con un provider Git remoto, raggruppati per categoria per facilitare l'identificazione della causa più rapidamente. Se nessuna delle indicazioni qui risolve il problema, vedere Ottenere assistenza.

Errori di autenticazione

Questi errori si verificano quando Azure Databricks non è in grado di verificare l'identità con il provider Git remoto.

Invalid credentials

Provare quanto segue:

• Verificare che le impostazioni di integrazione Git (Impostazioni>account collegati) siano corrette. È necessario immettere sia il nome utente del provider Git che il token.

• Verificare di aver selezionato il provider Git corretto in Impostazioni>Account collegati.

• Verificare che il token di accesso personale o la password dell'app disponga dell'accesso corretto al repository.

• Se il tuo provider Git ha l'SSO abilitato, autorizza i tuoi token per l'SSO.

• Testare il token con la riga di comando git. Sostituire le stringhe di testo tra parentesi angolari:

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

Errori di connessione SSL

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

Questo errore si verifica quando Azure Databricks non riesce a raggiungere il server Git tramite HTTPS. In genere indica un problema di connettività di rete o un problema di certificato TLS nell'infrastruttura Git dell'organizzazione.

Prima di contattare il team dell'account Azure Databricks, tieni pronte le seguenti informazioni:

• URL del server Git
• Indica se il server usa un certificato ca autofirmato o privato
• Indica se altri utenti nella stessa area di lavoro visualizzano lo stesso errore

errore delle credenziali di 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.

Questo errore può verificarsi quando l'organizzazione ha abilitato di recente un criterio di autenticazione a più fattori (MFA). Quando l'imposizione dell'autenticazione a più fattori ha effetto, le sessioni di Microsoft Entra ID esistenti potrebbero non soddisfare i nuovi requisiti di autenticazione e la connessione non riesce.

Per risolvere l'errore:

1. Passare a portal.azure.com e disconnettersi da Microsoft Entra ID.
2. Accedi di nuovo. Dovresti visualizzare un prompt per completare l'autenticazione a più fattori.

Se non funziona, disconnettersi da tutti i servizi Azure prima di accedere di nuovo.

Errori di stato del repository

Questi errori si verificano quando la cartella Git locale raggiunge uno stato che impedisce le normali operazioni.

Testa disconnessa

In Git, la "head" fa riferimento alla posizione corrente nella cronologia dei commit e in genere punta a un ramo. Quando HEAD punta direttamente a un commit specifico anziché a un ramo, il repository è in uno stato di "HEAD detached". Git non tiene traccia delle modifiche apportate in questo stato in alcun ramo. Se si esce senza prima creare un nuovo ramo, tali modifiche potrebbero andare perse.

Una cartella Git può immettere lo stato head scollegato quando:

• Qualcuno elimina il ramo remoto. Azure Databricks tenta di recuperare le modifiche locali di cui non è stato eseguito il commit applicandole al ramo predefinito. Se sono presenti modifiche in conflitto, Azure Databricks le applica in uno snapshot del ramo predefinito, con conseguente scollegamento della testa.
• Un utente o un'entità di servizio esegue il check-out di un tag tramite l'update repo API.

Per eseguire il ripristino da questo stato:

1. Fare clic su Crea ramo per creare un ramo dal commit corrente oppure selezionare un ramo per estrazione di un ramo esistente.
2. Effettuare il commit e il push per mantenere le modifiche. Per annullare le modifiche, fare clic Menu kebab in Modifiche.

Stato del repository incoerente

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

Questo errore indica che si è verificato un problema durante l'eliminazione delle cartelle. Il repository è ora in uno stato incoerente. Eliminare e clonare nuovamente il repository per reimpostarne lo stato.

Conflitti di nomi dei notebook

I notebook con nomi di file identici o simili possono causare errori quando si crea un repository o una richiesta 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).

I conflitti di denominazione possono verificarsi anche con estensioni di file diverse. Ad esempio, questi due file sono in conflitto:

• notebook.ipynb
• notebook.py

Per correggere il conflitto, rinominare il notebook, il file o la cartella che contribuisce allo stato di errore. Se l'errore si verifica quando si clona il repository, rinominare i notebook, i file o le cartelle nel repository Git remoto.

Comportamento imprevisto

Questi problemi non generano un messaggio di errore chiaro, ma sono segni di un problema che richiede l'analisi.

Errori di timeout

Le operazioni come la clonazione di un repository di grandi dimensioni o l'estrazione di un grande branch possono causare errori di timeout. L'operazione potrebbe essere ancora completata in background dopo il timeout.

Se viene visualizzato un errore di timeout:

1. Attendere alcuni minuti, quindi aggiornare la cartella Git. Se sono presenti i file o i rami previsti, l'operazione è stata completata correttamente.
2. Se l'area di lavoro è in condizioni di carico elevato, ripetere l'operazione dopo che il carico diminuisce.

Per evitare timeout con repository di grandi dimensioni, usa sparse checkout per lavorare solo con i file necessari.

Errori 404

Se viene visualizzato un errore 404 quando si apre un file non notebook, attendere alcuni minuti e riprovare. Si verifica un breve ritardo tra quando il sistema abilita l'area di lavoro e quando l'app Web seleziona la configurazione.

I notebook risultano modificati senza alcun intervento dell'utente

Se ogni riga di un notebook viene modificata senza modifiche dell'utente, è probabile che le modifiche siano dovute alle differenze di fine riga. Azure Databricks usa terminazioni di riga in stile Linux (LF), che possono differire dai file di cui è stato eseguito il commit nei sistemi Windows (CRLF).

Per diagnosticare questo problema, verificare se si dispone di un .gitattributes file:

• Non può contenere * text eol=crlf.
• Se non si usa Windows, rimuovere questa impostazione. Sia l'ambiente di sviluppo che Azure Databricks utilizzano terminatori di riga Linux.
• Se si usa Windows, modificare l'impostazione su * text=auto. Git memorizza quindi i file internamente con terminazioni di riga nel formato Linux, ma li controlla automaticamente con terminazioni di riga specifiche della piattaforma.

Se hai già sottoposto a commit file con caratteri di fine riga di Windows in Git:

1. Cancellare eventuali modifiche in sospeso.
2. Aggiorna il file .gitattributes come descritto in precedenza per il tuo ambiente.
3. Approvare la modifica.
4. Eseguire git add --renormalize. Eseguire il commit e il push di tutte le modifiche.

Ripristinare i file eliminati

La recuperabilità dei file varia in base all'azione. Alcune azioni consentono il ripristino tramite la cartella Cestino, mentre altre no. Per ripristinare i file di cui è stato eseguito il commit e il push in precedenza in un ramo remoto, usare la cronologia di commit Git del repository remoto:

Action	Il file è recuperabile?
Eliminare un file con il browser dell'area di lavoro	Sì, dalla cartella Cestino
Rimuovere un nuovo file con la finestra di dialogo della cartella Git	Sì, dalla cartella Cestino
Rimuovere un file modificato con la finestra di dialogo della cartella Git	No, il file non è più disponibile
reset (hard) per le modifiche di file di cui non è stato eseguito il commit	No, le modifiche ai file non sono più disponibili
reset (hard) per i file di cui non è stato eseguito il commit, appena creati	No, le modifiche ai file non sono più disponibili
Cambiare rami con la finestra di dialogo della cartella Git	Sì, dal repository Git remoto
Altre operazioni Git, ad esempio commit o push, dalla finestra di dialogo della cartella Git	Sì, dal repository Git remoto
PATCH operazioni di aggiornamento dall'API /repos/id Repos	Sì, dal repository Git remoto

Come ottenere assistenza

Se nessuna delle linee guida in questa pagina risolve il problema, contattare Azure Databricks supporto tecnico. Quando si contatta il supporto tecnico, includere quanto segue:

• Messaggio di errore esatto
• Nome del provider Git e se il repository è pubblico o privato
• Indica se il problema interessa tutti gli utenti o solo alcuni utenti nell'area di lavoro
• I passaggi già provati