Solución de errores para carpetas Git de Databricks

En esta página se describen los errores comunes y el comportamiento inesperado al usar Azure Databricks carpetas de Git con un proveedor de Git remoto, agrupado por categoría para ayudarle a identificar la causa más rápidamente. Si ninguna de las instrucciones aquí resuelve el problema, consulte Obtener ayuda.

Errores de autenticación

Estos errores se producen cuando Azure Databricks no pueden comprobar la identidad con el proveedor de Git remoto.

Invalid credentials

Realice lo siguiente:

• Confirme que la configuración de integración de Git (Configuración>cuentas vinculadas) es correcta. Debe escribir el nombre de usuario y el token del proveedor de Git.

• Confirme que seleccionó el proveedor de Git correcto en Configuración>Cuentas vinculadas.

• Compruebe que el token de acceso personal o la contraseña de la aplicación tenga el acceso correcto al repositorio.

• Si tu proveedor de Git tiene habilitado SSO, autoriza tus tokens para SSO.

• Pruebe el token con la línea de comandos de Git. Sustituya las cadenas de texto entre corchetes angulares:

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

Errores de conexión SSL

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

Este error se produce cuando Azure Databricks no puede acceder al servidor Git a través de HTTPS. Normalmente indica un problema de conectividad de red o un problema de certificado TLS en la infraestructura de Git de la organización.

Antes de ponerse en contacto con el equipo de la cuenta de Azure Databricks, tenga la siguiente información lista:

• La dirección URL de su servidor Git
• Si el servidor usa un certificado de entidad de certificación privada o autofirmado
• Si otros usuarios del mismo área de trabajo ven el mismo error

Error de credenciales de 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.

Este error puede producirse cuando la organización habilitó recientemente una directiva de autenticación multifactor (MFA). Cuando la aplicación de MFA surte efecto, es posible que las sesiones de Microsoft Entra ID existentes no cumplan los nuevos requisitos de autenticación y se produzca un error en la conexión.

Para resolver el error:

1. Vaya a portal.azure.com y cierre sesión en Microsoft Entra ID.
2. Vuelva a iniciar sesión. Debería aparecer un mensaje solicitándole que complete la autenticación de dos factores (MFA).

Si eso no funciona, cierre sesión de todos los servicios de Azure antes de volver a iniciar sesión.

Errores de estado del repositorio

Estos errores se producen cuando la carpeta git local alcanza un estado que impide las operaciones normales.

Estado de head separado

En Git, el "head" hace referencia a la posición actual en el historial de confirmaciones y, normalmente, apunta a una rama. Cuando el head apunta directamente a una confirmación específica en lugar de a una rama, el repositorio se encuentra en un estado de head separado. Git no realiza un seguimiento de los cambios realizados en este estado en ninguna rama. Si navega fuera de esta página sin crear primero una nueva rama, esos cambios podrían perderse.

Una carpeta de Git puede entrar en el estado de head separado cuando:

• Alguien elimina la rama remota. Azure Databricks intenta recuperar los cambios locales no confirmados aplicándolos a la rama predeterminada. Si hay cambios conflictivos, Azure Databricks los aplica en una instantánea de la rama predeterminada, lo que da lugar a un head desvinculado.
• Un usuario o entidad de servicio realiza un check-out de una etiqueta mediante la update repoAPI.

Para recuperarse de este estado:

1. Haga clic en Crear rama para crear una rama a partir de la confirmación actual, o en Seleccionar rama para realizar un check-out de una rama existente.
2. Realice una confirmación y envíe los cambios para conservarlos. Para descartar los cambios, haga clic en el Menú kebab en Cambios.

Estado de repositorio incoherente

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

Este error indica que se produjo un problema al eliminar carpetas. El repositorio está ahora en un estado incoherente. Elimine y vuelva a clonar el repositorio para restablecer su estado.

Conflictos de nombres de bloc de notas

Los cuadernos con nombres de archivo idénticos o similares pueden producir errores al crear un repositorio o una solicitud de incorporación de cambios:

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

Los conflictos de nomenclatura pueden producirse incluso con diferentes extensiones de archivo. Por ejemplo, estos dos archivos entran en conflicto:

• notebook.ipynb
• notebook.py

Para corregir el conflicto, cambie el nombre del cuaderno, el archivo o la carpeta que contribuye al estado de error. Si se produce el error al clonar el repositorio, cambie el nombre de los cuadernos, los archivos o las carpetas del repositorio de Git remoto.

Comportamiento inesperado

Estos problemas no generan un mensaje de error claro, pero son signos de un problema que necesita investigación.

Errores de tiempo de espera

Operaciones como clonar un repositorio de gran tamaño o realizar un check-out de una rama de gran tamaño pueden provocar errores de tiempo de espera. Es posible que la operación se complete en segundo plano después del tiempo de espera.

Si aparece un error de tiempo de espera:

1. Espere unos minutos y, a continuación, actualice la carpeta Git. Si los archivos o ramas esperados están presentes, la operación se completó correctamente.
2. Si el área de trabajo estaba bajo carga pesada, vuelva a intentar la operación después de que se reduzca la carga.

Para evitar tiempos de espera con repositorios de gran tamaño, use sparse checkout para trabajar solo con los archivos que necesita.

Errores 404

Si recibe un error 404 al abrir un archivo que no es de cuaderno, espere unos minutos e inténtelo de nuevo. Hay un breve retraso entre cuando el sistema habilita el área de trabajo y cuando la aplicación web recoge la configuración.

Los cuadernos aparecen modificados sin que el usuario los haya editado

Si todas las líneas de un notebook aparecen como modificadas sin que el usuario haya realizado ninguna edición, es probable que los cambios se deban a diferencias en los finales de línea. Azure Databricks utiliza finales de línea al estilo de Linux (LF), que pueden diferir de los archivos confirmados en sistemas Windows (CRLF).

Para diagnosticar este problema, compruebe si tiene un .gitattributes archivo:

• No puede contener * text eol=crlf.
• Si no usa Windows, quite esta configuración. Tanto su entorno de desarrollo como Azure Databricks utilizan finales de línea de Linux.
• Si usa Windows, cambie la configuración a * text=auto. Git almacena internamente los archivos con finales de línea al estilo de Linux, pero los extrae automáticamente con finales de línea específicos de la plataforma.

Si ya has confirmado en Git archivos con caracteres de fin de línea de Windows:

1. Borre los cambios pendientes.
2. Actualice el .gitattributes archivo tal y como se ha descrito anteriormente para su entorno.
3. Confirme el cambio.
4. Ejecute git add --renormalize. Confirme e inserte todos los cambios.

Recuperación de archivos eliminados

La capacidad de recuperación de archivos varía según la acción. Algunas acciones permiten la recuperación a través de la carpeta Papelera , mientras que otras no. Para restaurar archivos previamente confirmados e insertados en una rama remota, use el historial de confirmaciones de Git del repositorio remoto:

Acción	¿Se puede recuperar el archivo?
Eliminación de un archivo con el explorador del área de trabajo	Sí, desde la carpeta Papelera
Descartar un nuevo archivo con el cuadro de diálogo de carpeta de Git	Sí, desde la carpeta Papelera
Descartar un archivo modificado con el cuadro de diálogo de carpeta de Git	No, el archivo se ha ido
reset (difícil) para modificaciones de archivos no confirmadas	No, las modificaciones de archivos han desaparecido
reset (duro) para archivos no confirmados y recién creados	No, las modificaciones de archivos han desaparecido
Cambio de ramas con el cuadro de diálogo de carpeta de Git	Sí, desde el repositorio de Git remoto
Otras operaciones de Git, como confirmación o inserción, desde el cuadro de diálogo de carpeta de Git	Sí, desde el repositorio de Git remoto
PATCH operaciones que actualizan /repos/id desde la API de Repos	Sí, desde el repositorio de Git remoto

Obtención de ayuda

Si ninguna de las instrucciones de esta página resuelve el problema, póngase en contacto con Azure Databricks soporte técnico. Al ponerse en contacto con el soporte técnico, incluya lo siguiente:

• Mensaje de error exacto
• Nombre del proveedor de Git y si el repositorio es público o privado.
• Si el problema afecta a todos los usuarios o solo a algunos usuarios del área de trabajo
• Los pasos que ya ha probado