Запуск записных книжек Jupyter Notebook в рабочей области

Узнайте, как использовать записные книжки Jupyter Notebook прямо в рабочей области Студии машинного обучения Azure. Работать с записными книжками можно не только в Jupyter или JupyterLab, но и прямо в рабочей области.

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

Важно!

Компоненты, которые помечены как "предварительная версия", предоставляются без соглашения об уровне обслуживания и не рекомендуются для использования в рабочей среде. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Дополнительные сведения см. в статье Дополнительные условия использования предварительных выпусков Microsoft Azure.

Предварительные требования

Изменение записной книжки

Чтобы изменить записную книжку, откройте любую записную книжку, расположенную в разделе User Files (Файлы пользователя) рабочей области. Щелкните ячейку, которую хотите изменить. Если у вас нет записных книжек в этом разделе, см. статью Создание файлов и управление ими в рабочей области.

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

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

Вы также можете запустить Jupyter или JupyterLab на панели инструментов записной книжки. Машинное обучение Azure не предоставляет обновления и исправления ошибок из Jupyter или JupyterLab, так как они являются продуктами с открытым кодом вне компетенции службы поддержки Майкрософт.

Режим фокусировки

Используйте режим фокусировки, чтобы развернуть текущее представление и сосредоточиться на активных вкладках. Режим фокусировки скрывает обозреватель файлов записных книжек.

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

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

    Переключение режима фокусировки/стандартного представления

Завершение кода (IntelliSense)

IntelliSense — это вспомогательное средство для написания кода, включающее множество возможностей: "Список членов", "Сведения о параметрах", "Краткие сведения" и "Завершить слово". За несколько нажатий клавиш вы можете:

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

Вставка фрагментов кода (предварительная версия).

Нажмите клавиши CTRL + ПРОБЕЛ, чтобы активировать фрагменты кода IntelliSense. Прокрутите список предложений или начните ввод, чтобы найти код, который нужно вставить. После вставки кода пройдите по аргументам, чтобы настроить код для собственного использования.

Вставка фрагмента кода

Эти же фрагменты кода доступны при открытии записной книжки в VS Code. Полный список доступных фрагментов см. в разделе фрагменты VS Code в Машинном обучении Azure.

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

Открытие инструмента панели фрагментов кода на панели инструментов записной книжки

На панели фрагментов кода можно также отправить запрос на добавление новых фрагментов кода.

Панель фрагментов кода позволяет предложить новый фрагмент кода

Совместная работа с комментариями записной книжки (предварительная версия)

Используйте комментарий записной книжки для совместной работы с другими пользователями, имеющими доступ к этой записной книжке.

Переключить отображение области комментариев можно с помощью инструмента Notebook comments (Комментарии записной книжки) в верхней части записной книжки. Если экран недостаточно слишком широкий, откройте этот инструмент, выбрав в конце набора инструментов.

Снимок экрана инструмента управления комментариями записной книжки на верхней панели инструментов.

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

  1. Выделите фрагмент текста в ячейке кода. В ячейке кода можно комментировать только текст.
  2. Чтобы создать комментарий, используйте инструмент New comment thread (Создать цепочку комментариев). Снимок экрана: добавление комментария к ячейке кода в инструменте.
  3. Если область комментариев была ранее скрыта, она откроется.
  4. Введите комментарий и опубликуйте его с помощью инструмента или нажав клавиши CTRL+ВВОД.
  5. После публикации комментария выберите в правом верхнем углу, чтобы:
    • изменить комментарий;
    • разрешить цепочку;
    • удалить цепочку.

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

Примечание

Комментарии сохраняются в метаданных ячейки кода.

Очистка записной книжки (предварительная версия)

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

  1. Выполните все ячейки записной книжки.
  2. Выберите ячейку, содержащую код, который должна запускать новая записная книжка. Например, код, который отправляет эксперимент, или код, регистрирующий модель.
  3. Нажмите значок Сбор, отображаемый на панели инструментов ячейки. Снимок экрана: выбор значка "Сбор"
  4. Введите имя новой, "собранной" записной книжки.

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

Сохранение записной книжки и создание контрольных точек

Машинное обучение Azure создает файл контрольных точек при создании IPYNB-файла.

На панели инструментов записной книжки выберите меню, а затем Файл>Сохранить и создать контрольные точки, чтобы вручную сохранить записную книжку и добавить файл контрольных точек, связанный с записной книжкой.

Снимок экрана: инструмент сохранения на панели инструментов записной книжки

Записные книжки автоматически сохраняются каждые 30 секунд. Функция автосохранения обновляет только исходный IPYNB-файл, а не файл проверки.

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

Экспорт записной книжки

На панели инструментов записной книжки выберите меню и нажмите Экспортировать как, чтобы экспортировать записную книжку как любой из поддерживаемых типов:

  • Записная книжка
  • Python
  • HTML
  • LaTeX

Экспорт записной книжки на компьютер

Экспортированный файл сохраняется на компьютере.

Запуск записной книжки или скрипта Python

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

  • Если у вас нет вычислительной операции, выполните следующие действия, чтобы создать ее:

    1. На панели инструментов записной книжки или скрипта справа от раскрывающегося списка "Вычислительная среда" нажмите + Создать вычислительную среду. В зависимости от размера экрана этот параметр может находиться в меню ... . Создание вычислительной среды
    2. Присвойте имя вычислительной операции и выберите значение Virtual Machine Size (Размер виртуальной машины).
    3. Нажмите кнопку создания.
    4. Вычислительный экземпляр подключается к файлу автоматически. Теперь можно запускать ячейки записной книжки или скрипт Python, используя инструмент слева от вычислительного экземпляра.
  • Если у вас остановленный вычислительный экземпляр, выберите Запустить вычислительную среду справа от раскрывающегося списка "Вычислительная среда". В зависимости от размера экрана этот параметр может находиться в меню ... .

    Запустить вычислительный экземпляр

Только вы можете просматривать и использовать созданные вами вычислительные операции. Ваша папка User files (Файлы пользователя) хранится отдельно от виртуальной машины и является общей для всех вычислительных операций в рабочей области.

Просмотр журналов и выходных данных

Используйте мини-приложения записной книжки для просмотра хода выполнения и журналов. Мини-приложение работает асинхронно и предоставляет обновленные сведения до тех пор, пока обучение не будет завершено. Мини-приложения Машинного обучения Azure также поддерживаются в Jupyter и JupyterLab.

Снимок экрана: мини-приложение записной книжки Jupyter

Изучение переменных в записной книжке

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

Снимок экрана: обозреватель переменных

Выберите инструмент, чтобы открыть окно обозревателя переменных.

Снимок экрана: окно обозревателя переменных

На панели инструментов записной книжки используйте инструмент Оглавление, чтобы отобразить или скрыть оглавление. Запустите ячейку Markdown с заголовком, чтобы добавить ее в оглавление. Щелкните запись в таблице, чтобы прокрутить ее до этой ячейки в записной книжке.

Снимок экрана: оглавление в записной книжке

Изменение среды записной книжки

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

При этом не меняется ни состояние записной книжки, ни значения переменных в ней.

Действие Результат
Остановка ядра Все выполняемые ячейки останавливаются. При выполнении ячейки ядро автоматически перезапускается.
Переход в другой раздел рабочей области Выполняемые ячейки останавливаются.

Эти действия сбрасывают состояние записной книжки и все переменные в записной книжке.

Действие Результат
Изменение ядра Записная книжка использует новое ядро.
Переключение вычисления Записная книжка автоматически использует новое вычисление.
Сброс вычисления Повторный запуск при попытке выполнить ячейку.
Остановка вычисления Ячейки не выполняются.
Открытие записной книжки в Jupyter или JupyterLab Записная книжка открывается на новой вкладке.

Добавление новых ядер

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

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

Индикаторы состояния

Индикатор рядом с раскрывающимся списком Compute (Вычисление) отображает его состояние. Состояние также отображается в самом раскрывающемся списке.

Color Состояние вычисления
Зеленый Вычисление выполняется
Красный Сбой при вычислении
Черный Вычисление остановлено
Голубой Создание, запуск, перезапуск, настройка вычисления
Серый Идет процесс удаления или остановки вычисления

Индикатор рядом с раскрывающимся списком Kernel (Ядро) отображает его состояние.

Color Состояние ядра
Зеленый Ядро подключено, неактивно или занято
Серый Ядро не подключено

Сведения о вычислениях

Сведения о вычислительных операциях см. на странице Compute (Вычисления) в Студии.

Полезные сочетания клавиш

Аналогично Jupyter Notebook в записных книжках Машинного обучения Azure есть модальный пользовательский интерфейс. Клавиатура выполняет разные действия в зависимости от того, в каком режиме находится ячейка записной книжки. Записные книжки Машинного обучения Azure поддерживают для данной ячейки кода следующие два режима: режим команд и режим правки.

Сочетания клавиш для режима команд

Ячейка находится в режиме команд, когда нет текстового курсора для ввода текста. Когда ячейка находится в режиме команд, вы можете редактировать записную книжку целиком, но не вводить ее в отдельные ячейки. Войдите в режим команд, нажав ESC или щелкнув за пределами области редактора ячейки с помощью мыши. Левая граница активной ячейки — синяя и сплошная, а кнопка Запуск — синяя.

Ячейка записной книжки в режиме команд

Сочетание клавиш Описание
ВВОД Вход в режим редактирования
SHIFT + ВВОД Запуск ячейки, выбор следующей
CTRL/CMD+ВВОД Запуск ячейки
ALT + ВВОД Запуск ячейки, вставка ячейки кода ниже
CTRL/CMD + ALT + ВВОД Запуск ячейки, вставка ячейки Markdown ниже
ALT + R Выполнить все
Да Преобразование ячейки в код
M Преобразование ячейки в Markdown
ВВЕРХ/K Выбор ячейки выше
ВНИЗ/J Выбор ячейки ниже
А Вставка ячейки кода выше
B Вставка ячейки кода ниже
CTRL/CMD + SHIFT + A Вставка ячейки Markdown выше
CTRL/CMD + SHIFT + B Вставка ячейки Markdown ниже
X Вырезание выбранной ячейки
C Копирование выбранной ячейки
SHIFT + V Вставка выбранной ячейки выше
V Вставка выбранной ячейки ниже
D D Удаление выбранной ячейки
O Переключить выходные данные
SHIFT + O Переключение прокручивания выходных данных
I I Прерывание ядра
0 0 Перезапуск ядра
SHIFT + ПРОБЕЛ Прокрутка вверх
Пробел Прокрутка вниз
Вкладка Переход фокуса на следующий фокусируемый элемент (при отключенной ловушке фокуса)
CTRL/CMD + S Сохранение записной книжки
1 Изменение на h1
2 Изменение на h2
3 Изменение на h3
4 Изменение на h4
5 Изменение на h5
6 Изменение на h6

Сочетания клавиш режима правки

Режим правки обозначается текстовым курсором для ввода текста в области редактора. Когда ячейка находится в режиме правки, вы можете ввести в нее текст. Войдите в режим правки, нажав Enter или щелкнув область редактора ячейки с помощью мыши. Левая граница активной ячейки — зеленая и пунктирная, а кнопка Запуск — зеленая. Вы также видите курсор в ячейке в режиме редактирования.

Ячейка записной книжки в режиме редактирования

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

Сочетание клавиш Описание
ESC Вход в режим команд
CTRL/CMD + ПРОБЕЛ Активация IntelliSense
SHIFT + ВВОД Запуск ячейки, выбор следующей
CTRL/CMD+ВВОД Запуск ячейки
ALT + ВВОД Запуск ячейки, вставка ячейки кода ниже
CTRL/CMD + ALT + ВВОД Запуск ячейки, вставка ячейки Markdown ниже
ALT + R Выполнение всех ячеек
Up Перемещение курсора вверх или в предыдущую ячейку
Down Перемещение курсора вниз или в следующую ячейку
CTRL/CMD + S Сохранение записной книжки
CTRL/CMD + стрелка вверх Переход к началу ячейки
CTRL/CMD + стрелка вниз Передох к концу ячейки
Вкладка Завершение кода или отступ (если включена ловушка фокуса)
CTRL/CMD + M Включение или отключение ловушки фокуса
CTRL/CMD + ] Отступ
CTRL/CMD + [ Понижение уровня
CTRL/CMD + A Выбрать все
CTRL/CMD + Z Отменить
CTRL/CMD + SHIFT + Z Повторить
CTRL/CMD + Y Повторить
CTRL/CMD + HOME Переход к началу ячейки
CTRL/CMD + END Передох к концу ячейки
CTRL/CMD + стрелка влево Переход на одно слово влево
CTRL/CMD + стрелка вправо Переход на одно слово вправо
Control/Command + BACKSPACE Удаление слова перед
CTRL/CMD + DELETE Удаление слова после
CTRL/CMD + / Переключение комментария в ячейке

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

  • Если вы не можете подключиться к записной книжке, убедитесь, что связь с веб-сокетом не отключена. Для использования функциональности Jupyter экземпляра вычислительных ресурсов необходимо включить связь через веб-сокет. Убедитесь, что сеть разрешает подключения через веб-сокеты к *.instances.azureml.net и *.instances.azureml.ms.

  • При развертывании вычислительного экземпляра в рабочей области с частной закрытой точкой доступ к нему можно получить только из виртуальной сети. Если вы используете пользовательский DNS или файл hosts, добавьте запись для < имя экземпляра >.< регион >.instances.azureml.ms с частным IP-адресом частной конечной точки рабочей области. Дополнительные сведения см. в разделе Пользовательская DNS.

  • В случае сбоя ядра и перезапуска можно выполнить следующую команду, чтобы просмотреть журнал Jupyter на предмет дополнительных сведений: sudo journalctl -u jupyter. Если проблемы с ядром не исчезли, рекомендуется использовать вычислительный экземпляр с большим объемом памяти.

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

Дальнейшие действия