Версионирование. Работа с контрольными точками

Контрольная точка в DataSphere — это состояние ноутбука, автоматически сохраняемое после каждого выполнения ячейки с кодом. Контрольная точка включает код ячеек, вывод и значения переменных.

Перед началом

Если проект уже открыт, перейдите на вкладку ноутбука.

Если нет, откройте проект:

1. В консоли управления откройте раздел DataSphere в каталоге, в котором вы работаете с проектами DataSphere.

2. Перейдите во вкладку Проекты.
3. Выберите проект, который хотите открыть и нажмите значок .
4. Выберите Открыть и дождитесь открытия проекта.

Создание контрольной точки

1. Откройте панель Checkpoints-panel.

   Если вы уже выполняли код в открытом проекте, то в списке Checkpoints будут содержаться созданные ранее контрольные точки.

2. Выполните код в ячейке ноутбука.

   Запустите собственный код или воспользуйтесь примером.

3. Дождитесь выполнения кода.

Созданная контрольная точка появится в начале списка Checkpoints. Имя контрольной точки состоит из следующих элементов:

• Ключ операции, после выполнения которой была создана контрольная точка, например [1].

  Такой же ключ отображается в ноутбуке слева от выполненной ячейки.

• Тип операции, после которой была создана контрольная точка, например CELL_RUN.

• Имя блокнота, в котором была выполнена ячейка, например Untitled.ipynb.

• Дата и время создания контрольной точки в UTC, например 2020-10-09 06:12:08.

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

Применение контрольной точки

Чтобы вернуться к состоянию ноутбука на определенной контрольной точке:

1. Откройте панель Checkpoints-panel.
2. Выберите нужную контрольную точку в списке.
3. Нажмите кнопку Apply.
4. Дождитесь выполнения операции.

После восстановления состояния будет создана контрольная точка с типом операции ROLLBACK в имени.

Сохранение контрольной точки

Чтобы защитить контрольную точку от автоматического удаления, ее нужно сохранить:

1. Откройте панель Checkpoints-panel.
2. Выберите нужную контрольную точку в списке Checkpoints и нажмите кнопку Pin.
3. В открывшемся окне введите имя сохраняемой контрольной точки.
4. Нажмите кнопку Save.

Сохраненная контрольная точка переместится в список Pinned checkpoints.

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

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

Экспорт контрольной точки

Сохраненную контрольную точку можно экспортировать:

1. Откройте панель Checkpoints-panel.
2. В списке Pinned checkpoints выберите контрольную точку.
3. Нажмите кнопку Share.
4. В открывшемся окне нажмите кнопку Copy to clipboard.

Ссылка на контрольную точку ноутбука будет скопирована в буфер обмена.

Импорт контрольной точки

Чтобы импортировать ноутбук из контрольной точки:

1. В верхней панели нажмите File и выберите Import notebook from checkpoint.
2. В открывшемся окне введите URI контрольной точки.
3. Нажмите кнопку import.
4. Дождитесь выполнения операции.