Поиск и устранение ошибок в папках Databricks Git

На этой странице описываются распространенные ошибки и непредвиденное поведение при использовании папок Azure Databricks Git с удаленным поставщиком Git, сгруппированных по категориям, чтобы быстрее определить причину. Если ни одно из приведенных здесь рекомендаций не устраняет проблему, см. статью "Справка".

Ошибки проверки подлинности

Эти ошибки возникают, когда Azure Databricks не может подтвердить вашу личность у удаленного поставщика Git.

Invalid credentials

Попробуйте сделать следующее.

• Убедитесь, что параметры интеграции Git (параметры>связанные учетные записи) верны. Вы должны ввести и имя пользователя, и токен поставщика Git.

• Убедитесь, что выбран правильный Git-провайдер в параметрах>связанных учетных записей.

• Убедитесь, что ваш личный маркер доступа или пароль приложения имеет правильный доступ к репозиторию.

• Если у поставщика Git включен единый вход, авторизуйте маркеры для единого входа.

• Протестируйте токен с помощью командной строки Git. Замените текстовые строки в угловых скобках:

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

Ошибки SSL-подключения

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

Эта ошибка возникает, когда Azure Databricks не удается связаться с сервером Git по протоколу HTTPS. Обычно это означает проблему с сетевым подключением или проблему с сертификатом TLS в инфраструктуре Git организации.

Перед обращением к группе учетной записи Azure Databricks укажите следующие сведения:

• URL-адрес сервера Git
• Использует ли сервер самоподписанный сертификат или сертификат частного центра сертификации
• Если другие пользователи в той же рабочей области видят ту же ошибку

Ошибка учетных данных 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.

Эта ошибка может возникать, когда в вашей организации недавно включена политика многофакторной проверки подлинности (MFA). Когда вступает в силу требование MFA, существующие сеансы Microsoft Entra ID могут не соответствовать новым требованиям аутентификации, и подключение завершается с ошибкой.

Чтобы устранить эту ошибку, сделайте следующее:

1. Перейдите к portal.azure.com и выйдите из Microsoft Entra ID.
2. Войдите обратно. Вы должны увидеть запрос на завершение многофакторной аутентификации.

Если это не работает, выйдите из всех служб Azure перед повторной входной записью.

Ошибки состояния репозитория

Эти ошибки возникают, когда локальная папка Git достигает состояния, которое предотвращает обычные операции.

Состояние отсоединённого головного устройства

В Git «HEAD» обозначает текущее положение в истории коммитов и обычно указывает на ветку. Если HEAD указывает непосредственно на конкретный коммит, а не на ветку, репозиторий находится в состоянии detached HEAD. Git не отслеживает изменения, внесенные в это состояние в любой ветви. Если вы уйдёте с этой страницы, не создав сначала новую ветку, эти изменения могут быть потеряны.

Репозиторий Git может перейти в состояние detached HEAD, когда:

• Кто-то удаляет удаленную ветвь. Azure Databricks пытается восстановить незафиксированные локальные изменения, применяя их к ветви по умолчанию. Если есть конфликтующие изменения, Azure Databricks применяет их к моментальному снимку ветви по умолчанию, что приводит к отсоединяемой голове.
• Пользователь или субъект-служба извлекает тег с помощью update repoAPI.

Чтобы восстановить это состояние, выполните указанные ниже действия.

1. Нажмите Создать ветвь, чтобы создать ветвь из текущего коммита, или Выбрать ветвь, чтобы переключиться на существующую ветвь.
2. Зафиксируйте и отправьте их, чтобы сохранить изменения. Чтобы отменить изменения, щелкните в разделе "Изменения".

Несогласованное состояние репозитория

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

Эта ошибка означает, что при удалении папок возникла проблема. Теперь репозиторий находится в несогласованном состоянии. Удалите и повторно клонируйте репозиторий, чтобы сбросить его состояние.

Конфликты имен блокнотов

Файлы notebook с одинаковыми или похожими именами могут вызывать ошибки при создании репозитория или pull request:

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

Конфликты именования могут возникать даже с различными расширениями файлов. Например, эти два файла конфликтуют:

• notebook.ipynb
• notebook.py

Чтобы устранить конфликт, переименуйте записную книжку, файл или папку, которая вносит вклад в состояние ошибки. Если ошибка возникает при клонировании репозитория, переименуйте записные книжки, файлы или папки в удаленном репозитории Git.

Непредвиденное поведение

Эти проблемы не создают четкое сообщение об ошибке, но они признаки проблемы, которая нуждается в расследовании.

Ошибки, связанные с истечением времени ожидания

Такие операции, как клонирование большого репозитория или проверка большой ветви, могут привести к ошибкам времени ожидания. Операция может завершиться в фоновом режиме после истечения времени ожидания.

Если появляется ошибка тайм-аута:

1. Подождите несколько минут, а затем обновите папку Git. Если ожидаемые файлы или ветви присутствуют, операция выполнена успешно.
2. Если рабочая область находилась под тяжелой нагрузкой, повторите операцию после уменьшения нагрузки.

Чтобы избежать тайм-аутов при работе с большими репозиториями, используйте разрежённую проверку, чтобы работать только с нужными файлами.

Ошибки 404

Если при открытии файла без записной книжки возникает ошибка 404, подождите несколько минут и повторите попытку. Существует краткая задержка между тем, когда система включает рабочую область и когда веб-приложение выбирает конфигурацию.

Блокноты выглядят изменёнными, хотя пользователь их не редактировал

Если каждая строка ноутбука выглядит изменённой, хотя пользователь не вносил никаких правок, то, скорее всего, это связано с различиями в символах окончания строк. Azure Databricks использует окончания строк в стиле Linux (LF), которые могут отличаться от файлов, зафиксированных в системах Windows (CRLF).

Чтобы диагностировать эту проблему, проверьте, есть ли у вас файл .gitattributes:

• Он не может содержать * text eol=crlf.
• Если вы не используете Windows, удалите этот параметр. Как среда разработки, так и Azure Databricks используют окончания строк Linux.
• Если вы используете Windows, измените параметр * text=autoна . Затем Git хранит файлы с концами строк в стиле Linux внутри, но выводит файлы с концами строк, соответствующими конкретной платформе, автоматически.

Если вы уже зафиксировали в Git файлы с символами конца строки Windows:

1. Снимите все невыполненные изменения.
2. .gitattributes Обновите файл, как описано выше для вашей среды.
3. Зафиксируйте изменения.
4. Запустите git add --renormalize. Зафиксируйте и отправьте все изменения.

Восстановление удаленных файлов

Возможность восстановления файлов зависит от действия. Некоторые действия позволяют восстановление через папку корзины, в то время как другие — нет. Чтобы восстановить файлы, ранее зафиксированные и отправленные в удаленную ветвь, используйте журнал фиксации Git удаленного репозитория:

Действие	Можно ли восстановить файл?
Удаление файла с помощью браузера рабочей области	Да, из папки Корзина
Отмена нового файла с помощью диалогового окна папки Git	Да, из папки Корзина
Отмена измененного файла с помощью диалогового окна папки Git	Нет, файл исчезнет
reset (жесткий режим) для незафиксированных изменений файлов	Нет, изменения файлов исчезли
reset (строго) для незафиксированных вновь созданных файлов	Нет, изменения файлов исчезли
Переключение ветвей с помощью диалогового окна папки Git	Да, из удаленного репозитория Git
Другие операции Git, такие как фиксация или отправка, из диалогового окна папки Git	Да, из удаленного репозитория Git
операции PATCH обновления /repos/id из API Repos	Да, из удаленного репозитория Git

Получите помощь

Если ни одно из рекомендаций на этой странице не устраняет проблему, обратитесь в службу поддержки Azure Databricks. При обращении в службу поддержки включите следующее:

• Точное сообщение об ошибке
• Имя поставщика Git и то, является ли репозиторий общедоступным или частным.
• Влияет ли проблема на всех пользователей или только некоторых пользователей в рабочей области
• Шаги, которые вы уже попробовали