Запуск записных книжек Jupyter Notebook в рабочей области
В этой статье показано, как запускать записные книжки Jupyter в рабочей области Студия машинного обучения Azure. Существуют и другие способы запуска записной книжки: Jupyter, JupyterLab и Visual Studio Code. Vs Code Desktop можно настроить для доступа к вычислительному экземпляру. Или используйте VS Code для Интернета непосредственно из браузера и без каких-либо необходимых установок или зависимостей.
Мы рекомендуем попробовать VS Code для Интернета, чтобы воспользоваться преимуществами простой интеграции и расширенной среды разработки, которая предоставляется. VS Code для Интернета предоставляет множество функций VS Code Desktop, включая поиск и синтаксис при просмотре и редактировании. Дополнительные сведения об использовании VS Code Desktop и VS Code для Интернета см. в статье "Запуск Visual Studio Code" с Машинное обучение Azure (предварительная версия) и удаленное подключение к вычислительному экземпляру (предварительная версия) в VS Code.
Независимо от того, какое решение вы используете для запуска записной книжки, у вас будет доступ ко всем файлам из рабочей области. Сведения о создании файлов и управлении ими, включая записные книжки, см. в разделе Создание файлов и управление ими в рабочей области.
В этой статье показано, как запустить записную книжку непосредственно в студии.
Важно!
Компоненты, которые помечены как "предварительная версия", предоставляются без соглашения об уровне обслуживания и не рекомендуются для использования в рабочей среде. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Дополнительные сведения см. в статье Дополнительные условия использования Предварительных версий Microsoft Azure.
Необходимые компоненты
- Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу.
- Рабочая область машинного обучения. См.раздел Создание ресурсов рабочей области.
- Удостоверение пользователя должно иметь доступ к учетной записи хранения по умолчанию вашей рабочей области. Возможность чтения, изменения и создания записных книжек зависит от уровня доступа к рабочей области. Например, участник может редактировать записную книжку, в то время как читатель может только просматривать ее.
Доступ к записным книжкам из рабочей области
Используйте раздел Записные книжки рабочей области для редактирования и запуска записных книжек Jupyter.
- Войдите в Студию машинного обучения Azure.
- Выберите рабочую область, если она еще не открыта
- Выберите Записные книжки слева.
Изменение записной книжки
Чтобы изменить записную книжку, откройте любую записную книжку, расположенную в разделе User Files (Файлы пользователя) рабочей области. Выберите ячейку, которую вы хотите изменить. Если у вас нет записных книжек в этом разделе, см. статью Создание файлов и управление ими в рабочей области.
Вы можете изменить записную книжку без подключения к вычислительному экземпляру. Если нужно выполнить ячейки в записной книжке, выберите или создайте вычислительный экземпляр. Если выбрать остановленный вычислительный экземпляр, он автоматически запустится при запуске первой ячейки.
Если выполняется вычислительная операция, можно также использовать функцию завершения кода на платформе IntelliSense в любой записной книжке Python.
Вы также можете запустить Jupyter или JupyterLab на панели инструментов записной книжки. Машинное обучение Azure не предоставляет обновления и не исправляет ошибки из Jupyter или JupyterLab, так как они находятся вне границы служба поддержки Майкрософт.
Режим фокусировки
Используйте режим фокусировки, чтобы развернуть текущее представление и сосредоточиться на активных вкладках. Режим фокусировки скрывает обозреватель файлов записных книжек.
На панели инструментов окна терминала выберите режим фокусировки, чтобы включить режим фокусировки. В зависимости от ширины окна средство может находиться в меню ... на панели инструментов.
В режиме фокусировки вернитесь к стандартному представлению, выбрав Стандартное представление.
Завершение кода (IntelliSense)
IntelliSense — это вспомогательное средство для написания кода, включающее множество возможностей: "Список членов", "Сведения о параметрах", "Краткие сведения" и "Завершить слово". За несколько нажатий клавиш вы можете:
- узнать больше о коде, который вы используете;
- следить за параметрами, которые вы вводите;
- добавлять вызовы в свойства и методы.
Совместное использование записной книжки
Ваши записные книжки хранятся в учетной записи хранения рабочей области и могут использоваться совместно с другими пользователями в зависимости от уровня доступа к рабочей области. Они могут открывать и редактировать записную книжку, если у них есть соответствующий доступ. Например, участник может редактировать записную книжку, в то время как читатель может только просматривать ее.
Другие пользователи рабочей области могут найти записную книжку в разделе "Записные книжки", "Файлы пользователей" Студия машинного обучения Azure. По умолчанию записные книжки находятся в папке с вашим именем пользователя, и другие пользователи могут получить к ним доступ.
Вы также можете скопировать URL-адрес из браузера при открытии записной книжки, а затем отправить его другим пользователям. Если у них есть соответствующий доступ к рабочей области, они могут открыть записную книжку.
Так как вы не делитесь вычислительными экземплярами, другие пользователи, запускающие записную книжку, будут использовать собственный вычислительный экземпляр.
Совместная работа с комментариями записной книжки (предварительная версия)
Используйте комментарий записной книжки для совместной работы с другими пользователями, имеющими доступ к этой записной книжке.
Переключить отображение области комментариев можно с помощью инструмента Notebook comments (Комментарии записной книжки) в верхней части записной книжки. Если экран недостаточно слишком широкий, откройте этот инструмент, выбрав … в конце набора инструментов.
Вне зависимости от того, отображается ли область комментариев, можно добавить комментарий в любую ячейку кода.
- Выделите фрагмент текста в ячейке кода. В ячейке кода можно комментировать только текст.
- Чтобы создать комментарий, используйте инструмент New comment thread (Создать цепочку комментариев).
- Если область комментариев была ранее скрыта, она откроется.
- Введите комментарий и опубликуйте его с помощью инструмента или нажав клавиши CTRL+ВВОД.
- После публикации комментария выберите ... в правом верхнем углу:
- изменить комментарий;
- разрешить цепочку;
- удалить цепочку.
Текст, для которого был добавлен комментарий, будет отображаться в коде фиолетовым цветом. При выборе комментария в области комментариев записная книжка прокрутится до ячейки, содержащей выделенный текст.
Примечание.
Комментарии сохраняются в метаданных ячейки кода.
Очистка записной книжки (предварительная версия)
В ходе создания записной книжки обычно образуются ячейки, используемые для просмотра или отладки данных. Функция сбора поможет вам создать чистую записную книжку без этих лишних ячеек.
- Выполните все ячейки записной книжки.
- Выберите ячейку, содержащую код, который должна запускать новая записная книжка. Например, код, который отправляет эксперимент, или код, регистрирующий модель.
- Нажмите значок Сбор, отображаемый на панели инструментов ячейки.
- Введите имя новой, "собранной" записной книжки.
Новая записная книжка содержит только ячейки кода, при этом все ячейки должны получать те же результаты, что и выбранная ячейка для сбора.
Сохранение записной книжки и создание контрольных точек
Машинное обучение Azure создает файл контрольных точек при создании IPYNB-файла.
На панели инструментов записной книжки выберите меню, а затем Файл>Сохранить и создать контрольные точки, чтобы вручную сохранить записную книжку и добавить файл контрольных точек, связанный с записной книжкой.
Записные книжки автоматически сохраняются каждые 30 секунд. Функция автосохранения обновляет только исходный IPYNB-файл, а не файл проверки.
Выберите Контрольные точки в меню записной книжки, чтобы создать именованную контрольную точку и вернуть записную книжку к сохраненной контрольной точке.
Экспорт записной книжки
На панели инструментов записной книжки выберите меню и нажмите Экспортировать как, чтобы экспортировать записную книжку как любой из поддерживаемых типов:
- Записная книжка
- Python
- HTML
- LaTeX
Экспортированный файл сохраняется на компьютере.
Запуск записной книжки или скрипта Python
Чтобы запустить записную книжку или скрипт Python, сначала подключитесь к выполняющемуся вычислительному экземпляру.
Если у вас нет вычислительной операции, выполните следующие действия, чтобы создать ее:
- На панели инструментов записной книжки или скрипта справа от раскрывающегося списка "Вычислительная среда" нажмите + Создать вычислительную среду. В зависимости от размера экрана этот параметр может находиться в меню ....
- Присвойте имя вычислительной операции и выберите значение Virtual Machine Size (Размер виртуальной машины).
- Выберите Создать.
- Вычислительный экземпляр подключается к файлу автоматически. Теперь можно запускать ячейки записной книжки или скрипт Python, используя инструмент слева от вычислительного экземпляра.
- На панели инструментов записной книжки или скрипта справа от раскрывающегося списка "Вычислительная среда" нажмите + Создать вычислительную среду. В зависимости от размера экрана этот параметр может находиться в меню ....
Если ваш вычислительный экземпляр остановлен, выберите Запустить вычислительную среду справа от раскрывающегося списка "Вычислительная среда". В зависимости от размера экрана этот параметр может находиться в меню ....
После подключения к вычислительному экземпляру используйте панель инструментов для запуска всех ячеек в записной книжке или control + ВВОД, чтобы запустить одну выбранную ячейку.
Только вы можете просматривать и использовать созданные вами вычислительные операции. Ваша папка User files (Файлы пользователя) хранится отдельно от виртуальной машины и является общей для всех вычислительных операций в рабочей области.
Изучение переменных в записной книжке
На панели инструментов записной книжки используйте Обозреватель переменных, чтобы отобразить имя, тип, длину и примеры значений для всех переменных, созданных в записной книжке.
Выберите инструмент, чтобы открыть окно обозревателя переменных.
Навигация с помощью оглавления
На панели инструментов записной книжки используйте инструмент Оглавление, чтобы отобразить или скрыть оглавление. Запустите ячейку Markdown с заголовком, чтобы добавить ее в оглавление. Выберите запись в таблице, чтобы прокрутить эту ячейку в записной книжке.
Изменение среды записной книжки
С помощью панели инструментов записной книжки можно изменить среду, в которой выполняется записная книжка.
Эти действия не изменят состояние записной книжки или значения каких-либо переменных в записной книжке:
| Действие | Результат |
|---|---|
| Остановка ядра | Все выполняемые ячейки останавливаются. При выполнении ячейки ядро автоматически перезапускается. |
| Переход в другой раздел рабочей области | Выполняемые ячейки останавливаются. |
Эти действия сбрасывают состояние записной книжки и все переменные в записной книжке.
| Действие | Результат |
|---|---|
| Изменение ядра | Записная книжка использует новое ядро. |
| Переключение вычисления | Записная книжка автоматически использует новое вычисление. |
| Сброс вычисления | Повторный запуск при попытке выполнить ячейку. |
| Остановка вычисления | Ячейки не выполняются. |
| Открытие записной книжки в Jupyter или JupyterLab | Записная книжка открывается на новой вкладке. |
Добавление новых ядер
Используйте терминал для создания и добавления новых ядер в вычислительный экземпляр. Записная книжка автоматически находит все ядра Jupyter, установленные на подключенном вычислительном экземпляре.
Используйте раскрывающееся меню ядра справа, чтобы перейти на любое из установленных ядер.
Управление пакетами
Так как вычислительный экземпляр имеет несколько ядер, убедитесь, что используются %pip или %condaволшебные функции, которые устанавливают пакеты в текущее работающее ядро. Не используйте !pip или !condaне относится ко всем пакетам (включая пакеты за пределами запущенного ядра).
Индикаторы состояния
Индикатор рядом с раскрывающимся списком Compute (Вычисление) отображает его состояние. Состояние также отображается в самом раскрывающемся списке.
| Color | Состояние вычисления |
|---|---|
| Зеленый | Вычисление выполняется |
| Красный | Сбой при вычислении |
| Черный | Вычисление остановлено |
| Голубой | Создание, запуск, перезапуск, настройка вычисления |
| Серый | Идет процесс удаления или остановки вычисления |
Индикатор рядом с раскрывающимся списком Kernel (Ядро) отображает его состояние.
| Color | Состояние ядра |
|---|---|
| Зеленый | Ядро подключено, неактивно или занято |
| Серый | Ядро не подключено |
Сведения о вычислениях
Сведения о вычислительных операциях см. на странице Compute (Вычисления) в Студии.
Полезные сочетания клавиш
Аналогично Jupyter Notebook, Студия машинного обучения Azure записные книжки имеют модальный пользовательский интерфейс. Клавиатура выполняет разные действия в зависимости от того, в каком режиме находится ячейка записной книжки. Студия машинного обучения Azure записные книжки поддерживают следующие два режима для заданной ячейки кода: режим команд и режим редактирования.
Сочетания клавиш для режима команд
Ячейка находится в командном режиме, если текстовый курсор не запрашивает ввод. Когда ячейка находится в режиме команд, вы можете редактировать записную книжку целиком, но не вводить ее в отдельные ячейки. Войдите в режим команд, нажав ESC или щелкнув за пределами области редактора ячейки с помощью мыши. Левая граница активной ячейки — синяя и сплошная, а кнопка Запуск — синяя.
| Ярлык | Description |
|---|---|
| ВВОД | Ввод режима редактирования |
| SHIFT + ВВОД | Запуск ячейки, выбор следующей |
| CTRL/CMD+ВВОД | Запустить ячейки |
| ALT + ВВОД | Запуск ячейки, вставка ячейки кода ниже |
| CTRL/CMD + ALT + ВВОД | Запуск ячейки, вставка ячейки Markdown ниже |
| ALT + R | Запустить все |
| Y | Преобразование ячейки в код |
| M | Преобразование ячейки в Markdown |
| ВВЕРХ/K | Выбор ячейки выше |
| ВНИЗ/J | Выбор ячейки ниже |
| А | Вставка ячейки кода выше |
| Б | Вставка ячейки кода ниже |
| 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 + ПРОБЕЛ | Прокрутка вверх |
| Space | Прокрутка вниз |
| TAB | Переход фокуса на следующий фокусируемый элемент (при отключенной ловушке фокуса) |
| CTRL/CMD + S | Сохранение записной книжки |
| 1 | Изменение на h1 |
| 2 | Изменение на h2 |
| 3 | Изменение на h3 |
| 4 | Изменение на h4 |
| 5 | Изменение на h5 |
| 6 | Изменение на h6 |
Сочетания клавиш режима правки
Режим правки обозначается текстовым курсором для ввода текста в области редактора. Когда ячейка находится в режиме правки, можно ввести текст в ячейку. Введите режим редактирования, нажав Enter или выберите область редактора ячейки. Левая граница активной ячейки — зеленая и пунктирная, а кнопка Запуск — зеленая. Вы также видите курсор в ячейке в режиме редактирования.
С помощью приведенных ниже сочетаний клавиш вы можете легче перемещаться и выполнять код в записных книжках Машинного обучения Azure в режиме правки.
| Ярлык | Description |
|---|---|
| ESCAPE | Вход в режим команд |
| CTRL/CMD + ПРОБЕЛ | Активация IntelliSense |
| SHIFT + ВВОД | Запуск ячейки, выбор следующей |
| CTRL/CMD+ВВОД | Запустить ячейки |
| ALT + ВВОД | Запуск ячейки, вставка ячейки кода ниже |
| CTRL/CMD + ALT + ВВОД | Запуск ячейки, вставка ячейки Markdown ниже |
| ALT + R | Выполнение всех ячеек |
| Up | Перемещение курсора вверх или в предыдущую ячейку |
| Down | Перемещение курсора вниз или в следующую ячейку |
| CTRL/CMD + S | Сохранение записной книжки |
| CTRL/CMD + стрелка вверх | Переход к началу ячейки |
| CTRL/CMD + стрелка вниз | Передох к концу ячейки |
| TAB | Завершение кода или отступ (если включена ловушка фокуса) |
| 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 или узлов, добавьте запись для < имени >экземпляра .< регион >.instances.azureml.ms с частным IP-адресом частной конечной точки рабочей области. Дополнительные сведения см. в статье о пользовательской DNS.
Сбой ядра: если ядро разбилось и было перезапущено, можно выполнить следующую команду, чтобы просмотреть журнал Jupyter и узнать дополнительные сведения:
sudo journalctl -u jupyterЕсли проблемы с ядром не исчезли, рекомендуется использовать вычислительный экземпляр с большим объемом памяти.Ядро не найдено или Операции ядра отключены. Такая ошибка может возникнуть при использовании ядра Python 3.8 по умолчанию в вычислительном экземпляре. Для ее исправления можно использовать один из следующих методов.
- Создание нового вычислительного экземпляра. Будет использован новый образ, в котором эта проблема была устранена.
- Используйте ядро Py 3.6 в существующем вычислительном экземпляре.
- В терминале в среде py38 по умолчанию запустите
pip install ipykernel==6.6.0ИЛИpip install ipykernel==6.0.3
Маркер с истекшим сроком действия: при возникновении проблемы с истекшим сроком действия маркера выйдите из Студия машинного обучения Azure, войдите обратно и перезапустите ядро записной книжки.
Ограничение отправки файлов: при отправке файла через проводник записной книжки ограничены файлы, которые меньше 5 ТБ. Если вам нужно отправить файл, превышающий это, рекомендуется использовать пакет SDK для отправки данных в хранилище данных. Дополнительные сведения см. в разделе "Создание ресурсов данных".