StackMoreLayersДокументация

Notebook Workbench

Документы, вкладки, ядра, файлы, версии и отправка работы.

В рабочей области документы, файлы и среда имеют разное время жизни. Вкладка показывает ноутбук; ядро исполняет его код; среда предоставляет общие ресурсы.

Рабочая область и вкладки

ОбъектЧто в нем хранится
Рабочая областьОбщие Files, ресурсы и контекст задачи
НоутбукЯчейки, вывод и история конкретного документа
СредаОбщий вычислительный сервер рабочей области
ЯдроПеременные и выполняющийся код отдельного ноутбука

Два ноутбука одной рабочей области видят общий data.csv, но Python-переменная из одного ядра сама по себе не появляется в другом. Открытие вкладки не создает отдельную среду. Выбор вкладки у каждого участника свой.

Переключение сохраняет принадлежность начатых действий: выполнение, сохранение, история и уведомления ноутбука A продолжают относиться к A после перехода в B. Закрытие вкладки не удаляет документ и не останавливает среду. Серверное выполнение и уже принятая отправка могут продолжаться после закрытия вкладки или браузера.

Сохранение и связь

Индикатор сохранения возле заголовка рабочей области относится к активному документу. Он не означает, что сохранены все открытые ноутбуки или обычные файлы. Локальная копия при потере связи и подтвержденное сохранение на сервере — разные состояния. После восстановления связи может понадобиться разрешить конфликт.

Во время неизвестного результата система проверяет исходную операцию. Потеря ответа не означает, что копия, отправка или запуск отсутствуют. Дождитесь восстановления состояния; новое нажатие не должно подменять исходный документ другой вкладкой. Код не повторяется автоматически на новом ядре после его потери.

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

Запуск и остановка

ДействиеРезультат
Start средыЗапускает общую вычислительную среду
RunИсполняет выбранные ячейки в ядре этого документа
Отмена очередиУбирает ожидающие задания; уже выполняющийся код требует отдельного управления
InterruptЗапрашивает прерывание текущего кода
Restart ядраСоздает новую жизнь этого ядра; его переменные теряются
Stop средыОстанавливает общую среду и все ее ядра

Перед Stop обзор показывает, что будет остановлено. Закрытие вкладки этого действия не выполняет. Restart одного ядра сохраняет соседние ядра. Фиксированного лимита одновременно открытых ядер и автоматического idle culling нет; запуск зависит от доступных ресурсов и готовности среды.

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

Панели и вывод

ПанельОбласть действия
PlanСтруктура показанного документа и его настройки
Revs / СнимкиИстория выбранного документа
LogsКлиентский журнал операций общей рабочей области
Files, ресурсы и статус средыОбщая рабочая область
Вывод ячеекКонкретный документ и его выполнение

Logs не заменяет долговременный серверный аудит; перезагрузка страницы не обещает восстановить весь журнал. Уведомления сохраняют исходный документ: действие из уведомления A относится к A даже после переключения в B.

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

Версии, восстановление и копии

Снимок — неизменяемая версия. Его просмотр и сравнение не запускают скрытую рабочую версию документа. Plan в таком режиме показывает структуру снимка.

Restore меняет выбранный документ с проверкой его текущего состояния. Undo не должен стирать последующие правки или выполнение. При конкурентном изменении возможен явный конфликт с сохранением данных.

Copy и Save As создают отдельный документ. Копия снимка использует выбранную версию, а не более поздний live notebook. Если за время создания копии вы уже выбрали другую вкладку, поздний ответ не должен менять этот новый выбор. После потери ответа или перезагрузки система восстанавливает исходную команду копирования и ее результат.

Rename сохраняет документ и его историю. Старая ссылка сообщает о переименовании и открывает документ, когда сохраненная история однозначна и доступ действует. При неоднозначном повторном использовании имени или отсутствии доступа результат обычный «Не найден». Удаление закрывает вкладки и ядро этого документа. Явное создание файла с прежним именем создает новый документ с собственной историей.

Files и ресурсы

Files — общий постоянный namespace рабочей области. Файл, записанный одним ядром, доступен другим через общую файловую систему. Конкурентные записи пользовательских процессов в обычный файл требуют согласования самими процессами.

При готовом постоянном хранилище и достаточных правах Files доступны без запущенной среды. Недоступное хранилище показывается ошибкой, а не пустым деревом. Изменение папок с ноутбуками требует остановленной среды.

Ресурс становится доступным после подтвержденной доставки и появления пути. Состояния загрузки, ошибки и неизвестного результата различаются. Копировать путь можно, когда он действительно известен. Legacy notebook SDK не является способом обойти неготовый ресурс.

Материалы, Share и Submit

У материала организатора есть постоянная identity и версии; ваша копия — отдельный документ. Обновление приходит к этой же копии. Нетронутая закрытая копия может обновиться автоматически. Для документа с вашей работой появляется явное действие «Обновить» и просмотр изменений.

При обновлении сохраняются локальные конфликты и ваши ячейки. Измененная вами ячейка, убранная организатором, остается; удаленная вами не возвращается. Undo проверяет более поздние правки и выполнение. При удалении материала нетронутая закрытая копия удаляется, а документ с вашей работой сохраняется. Обновления видны над ноутбуком, в селекторе и в списке снимков.

Share публикует неизменяемую версию после сохранения выбранного источника. Получатель проходит проверку доступа. Submit также использует явно выбранный документ и подтвержденную версию: переключение вкладки не меняет источник начатой отправки. Принятая отправка и завершенная оценка — разные состояния.

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

На этой странице