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

Контрольная точка в DataSphere — это сохраненное состояние ноутбука. Контрольная точка включает код ячеек, вывод и значения переменных, а также данные хранилища проекта. Данные версионируются, если их объем не превышает 10 ГБ. Контрольные точки с версионированными данными отмечены значком .

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

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

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

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

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

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

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

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

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

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

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

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

В автоматическом режиме сохранения состояний вы можете создать контрольную точку принудительно. Для этого в правом верхнем углу вкладки Checkpoints нажмите значок , либо используйте сочетание клавиш CMD+K или Ctrl+K.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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