Управление версиями Git для записных книжек (устаревшая версия)

Внимание

Поддержка интеграции Git для устаревших записных книжек была прекращена 31 января 2024 г. Databricks рекомендует использовать папки Databricks Git для синхронизации работы в Databricks с удаленным репозиторием Git.

В этой статье описывается настройка управления версиями Git для записных книжек (устаревшая функция). Вы также можете использовать интерфейс командной строки Databricks или API рабочей области для импорта и экспорта блокнотов, а также для выполнения Git-операций в локальной среде разработки.

Включение и отключение управления версиями Git

По умолчанию управление версиями включено. Чтобы переключить этот параметр, выполните следующие действия.

  1. Перейдите в Настройки>Настройки рабочего пространства.
  2. В разделе Дополнительно отключите переключатель Управление версиями Git для блокнота.

Настройка системы управления версиями

Чтобы настроить управление версиями, создайте учетные данные доступа в поставщике Git, а затем добавьте эти учетные данные в Azure Databricks.

Работа с версиями блокнота

Вы работаете с версиями блокнота на панели истории. Откройте панель журнала, щелкнув Значок журнала версий в правой боковой панели.

История версий

Примечание.

Изменить записную книжку, пока открыта панель журнала, невозможно.

  1. Щелкните Значок журнала версий в правой боковой панели. В строке состояния Git отобразится надпись Git: не связано.

    Панель состояния Git

  2. Нажмите надпись Git: не связано.

    Откроется диалоговое окно параметров Git. При первом открытии записной книжки отображается состояние Удалить связь, так как записная книжка не находится в GitHub.

    Параметры Git — привязка новой записной книжки

  3. В поле "Состояние" щелкните Связать.

  4. В поле "Связать" вставьте URL-адрес репозитория GitHub.

  5. Щелкните раскрывающийся список Ветвь и выберите существующую ветвь или введите имя новой.

  6. В поле папки "Путь" в Git укажите место в репозитории для хранения файла.

    Для ноутбуков Python рекомендуется расширение файла по умолчанию .py. Если вы используете .ipynb, записная книжка будет сохранена в формате записной книжки IPython. Если файл уже существует на GitHub, вы можете скопировать и вставить URL-адрес этого файла напрямую.

  7. Нажмите кнопку Сохранить, чтобы завершить привязывание своей записной книжки. Если этот файл ранее не существовал, появится запрос с командой Сохранить этот файл в репозитории GitHub.

  8. Введите сообщение и нажмите кнопку Сохранить.

Сохранение записной книжки в GitHub

Хотя внесенные в записную книжку изменения сохраняются автоматически в журнале версий Azure Databricks, изменения не сохраняются в GitHub автоматически.

  1. Щелкните Значок журнала версий в правой боковой панели, чтобы открыть панель журнала.

    Панель истории — сохранить сейчас

  2. Щелкните Сохранить сейчас, чтобы сохранить записную книжку в GitHub. Откроется диалоговое окно "Сохранить версию записной книжки".

  3. При необходимости введите сообщение, описывающее изменение.

  4. Убедитесь, что выбран параметр Также зафиксировать в Git.

    Сохранение версии

  5. Нажмите кнопку Сохранить.

Вернуть или обновить блокнот до версии из GitHub

После связывания блокнота Azure Databricks синхронизирует историю с Git каждый раз, когда вы снова открываете панель истории. Версии, синхронизируемые с Git, включают хэши коммитов как часть записи.

  1. Щелкните Значок журнала версий в правой боковой панели, чтобы открыть панель журнала.

    Панель журнала

  2. Выберите запись в панели истории. Azure Databricks отобразит эту версию.

  3. Щелкните Восстановить эту версию.

  4. Нажмите кнопку Подтвердить, чтобы подтвердить восстановление версии.

  1. Щелкните Значок журнала версий в правой боковой панели, чтобы открыть панель журнала.

  2. В строке состояния Git отображается Git: синхронизировано.

    Панель истории — сохранить текущее изображение

  3. Щелкните Git: синхронизировано.

    Параметры Git — удаление привязки записной книжки

  4. В диалоговом окне «Параметры Git» нажмите кнопку Удалить связь.

  5. Нажмите кнопку Сохранить.

  6. Нажмите кнопку Подтвердить, чтобы подтвердить, что вы хотите отключить записную книжку от системы управления версиями.

Использование ветвей

Вы можете работать с любой ветвью репозитория и создавать новые ветви в Azure Databricks.

Создание ветви

  1. Щелкните Значок журнала версий в правой боковой панели, чтобы открыть панель журнала.

  2. Щелкните строку состояния Git, чтобы открыть панель GitHub.

  3. Щелкните раскрывающийся список Branch.

  4. Введите имя ветви.

    Создать ветвь

  5. Выберите параметр Создать ветвь в нижней части раскрывающегося списка. Будет указана родительская ветвь. Вы всегда создаёте ветвь из текущей выбранной ветви.

Создать pull request

  1. Щелкните Значок журнала версий в правой боковой панели, чтобы открыть панель журнала.

  2. Щелкните строку состояния Git, чтобы открыть панель GitHub.

    Параметры Git — создание pull request

  3. Нажмите Создать запрос на включение изменений. GitHub открывает страницу запроса на включение изменений для этой ветви.

Перебазировать ветку

Вы также можете переместить изменения из одной ветви в другую в Azure Databricks. Ссылка Rebase отображается, если в родительской ветви доступны новые коммиты. Поддерживается только перебазирование на ветку родительского репозитория по умолчанию.

Ребейз

Например, предположим, что вы работаете над databricks/reference-apps. Вы создаёте форк в своей учётной записи (например, brkyvz) и начинаете работать в ветке my-branch. При отправке обновления в databricks:master отображается кнопка Rebase, после чего вы сможете извлечь изменения в свою ветвь brkyvz:my-branch.

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

Структура ветки до перебазирования

После ребейза структура ветви выглядит следующим образом:

Структура ветки после перебазирования

Особенность здесь в том, что коммиты C5 и C6 не применяются на основе C4. Они отображаются как локальные изменения в записной книжке. Конфликты слияния отображаются следующим образом:

Конфликт слияния

Затем можно снова выполнить фиксацию в GitHub с помощью кнопки Сохранить сейчас.

Что произойдет, если кто-то ответвился от моей ветки, которую я только что перебазировал?

Если ваша ветвь (например, branch-a) стала базой для другой ветви (branch-b), и вы выполняете перебазирование, не беспокойтесь! После того как пользователь также выполнит rebase для branch-b, всё будет работать как надо. В этой ситуации рекомендуется использовать отдельные ветки для отдельных ноутбуков.

Рекомендации по проверке кода

Azure Databricks поддерживает ветвление Git.

  • Вы можете связать записную книжку с любой ветвью в репозитории. Azure Databricks рекомендует использовать отдельную ветвь для каждой записной книжки.
  • Во время разработки можно привязать ноутбук к форку репозитория или к ветви основного репозитория, отличной от ветви по умолчанию. Чтобы интегрировать свои изменения в основной репозиторий, можно использовать ссылку Create PR в диалоговом окне Git Preferences в Azure Databricks, чтобы создать pull request в GitHub. Ссылка "Создать PR" отображается только в том случае, если вы не работаете в основной ветке родительского репозитория.

Устранение неполадок

При получении ошибок, связанных с синхронизацией журнала GitHub, проверьте следующее:

  • Вы можете связать записную книжку только с инициализированным репозиторием Git, который не пуст. Проверьте URL-адрес в веб-браузере.
  • Личный маркер доступа GitHub должен быть активен.
  • Чтобы использовать частный репозиторий GitHub, у вас должно быть разрешение на чтение репозитория.
  • Если записная книжка связана с переименованной ветвью GitHub, это изменение не отражается автоматически в Azure Databricks. Необходимо вручную повторно связать ноутбук с веткой.

Перейдите на папки Git в Databricks

Пользователи, которым необходимо выполнить миграцию в папки Databricks Git из устаревшей системы управления версиями Git, могут использовать следующее руководство.

  • Последнее обновление: