Risoluzione degli errori relativi alle cartelle Git di Databricks

Questa pagina fornisce indicazioni per i messaggi di errore comuni e la risoluzione dei problemi relativi alle cartelle Git di Databricks.

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
  

Secure connection...SSL problems

Questo errore si verifica se Azure Databricks non riesce ad accedere al server Git. Per accedere a un server Git privato, contattare il team dell'account Azure Databricks.

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

Errore delle credenziali dell'ID di Microsoft Entra

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 se il team ha iniziato di recente a usare criteri di autenticazione a più fattori (MFA). Per risolvere l'errore, passare a portal.azure.com e disconnettersi da Microsoft Entra ID. Quando si esegue di nuovo l'accesso, verrà visualizzato un prompt per l'uso dell'autenticazione a più fattori.

In caso contrario, provare a disconnettersi da tutti i servizi di Azure prima di eseguire di nuovo l'accesso.

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. Tuttavia, l'operazione potrebbe essere completata in background. Riprovare in un secondo momento se l'area di lavoro era sottoposta a un carico elevato.

Per lavorare con un repository di grandi dimensioni, provare il sparse checkout.

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.

Stato di testa scollegata

Una cartella Git di Databricks può entrare nello stato head scollegato se:

• Qualcuno elimina il ramo remoto. Databricks tenta di recuperare le modifiche locali di cui non è stato eseguito il commit applicandole al ramo predefinito. Se sono presenti modifiche contrastanti, Databricks le applica a uno snapshot del ramo predefinito (testa scollegata).
• Un utente o un'entità servizio ha estratto un tag usando l'APIupdate repo.

Per eseguire il ripristino da questo stato:

1. Fare clic su Crea ramo per creare un nuovo 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.

Risolvere i 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, ad esempio Cannot perform Git operation due to conflicting names o 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.

Gli errori indicano la necessità di una reclonazione.

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 di cartelle, che può lasciare il repository in uno stato incoerente. Eliminare e clonare nuovamente il repository per reimpostarne lo stato.

I Notebook appaiono modificati senza interventi dell'utente

Se ogni riga di un notebook viene modificata senza modifiche da parte dell'utente, è probabile che le modifiche siano dovute ai caratteri finali della riga. Databricks usa terminazioni di riga in stile Linux, che possono differire dai file di cui è stato eseguito il commit nei sistemi Windows.

Per diagnosticare questo problema, verificare se si dispone di un .gitattributes file. Se si esegue questa operazione:

• Non può contenere * text eol=crlf.
• Se non si usa Windows, rimuovere questa impostazione. Sia l'ambiente di sviluppo che Databricks usano i terminatori di riga di 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 è già stato eseguito il commit dei file con caratteri di fine riga di Windows in Git, seguire questa procedura:

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.