Создание записных книжек Microsoft Fabric и управление ими в Visual Studio Code
Расширение Кода Visual Studio (VS) для Synapse полностью поддерживает операции с записными книжками CRUD (создание, чтение, обновление и удаление) в Fabric. Расширение также поддерживает синхронизацию между локальными и удаленными рабочими областями; При синхронизации изменений можно устранить любые конфликты или различия между локальной и удаленной рабочей областью.
С помощью этого расширения можно также запускать записные книжки на удаленных вычислительных ресурсах Apache Spark для Fabric.
Открытие записной книжки с расширением Synapse
Нажав кнопку "Открыть в VS Code " на странице разработки записных книжек на портале Fabric, вы можете напрямую открыть ту же записную книжку с расширением Synapse VS Code для Fabric. После активации расширения в VS Code и открытия записной книжки один раз рабочая область должна автоматически подключиться к записной книжке.
Совет
Если расширение Synapse для VS Code не установлено, сначала его необходимо установить. Дополнительные сведения см. в разделе "Установка расширения Synapse". После общедоступного выпуска расширения установка автоматически выполняется.
Просмотр списка записных книжек
Узел дерева записной книжки перечисляет все элементы записной книжки в текущей рабочей области. На основе изменений в VS Code список отображает различные цвета и символы, чтобы указать последнее состояние, как показано на следующем рисунке.
- По умолчанию: белый текст и не символ справа от имени записной книжки указывает состояние по умолчанию или инициализированное. Записная книжка существует в удаленной рабочей области, и вы не скачали ее локально.
- Изменено: символ M справа от имени и желтого текста указывает, что вы скачали и редактировали записную книжку локально в VS Code и еще не опубликовали ожидающие изменения обратно в удаленную рабочую область.
- Local: символ L и зеленый текст указывают, что записная книжка загружена, а содержимое совпадает с удаленным рабочим областью.
- Конфликт: символ C и красный текст указывают на то, что конфликты существуют между локальной версией и версией удаленной рабочей области.
Создание записной книжки
В обозревателе VS Code наведите указатель мыши на панель инструментов записной книжки. Появится параметр "Создать записную книжку".
Выберите "Создать записную книжку " и введите имя и описание. Новая записная книжка создается в удаленной рабочей области и отображается в списке записных книжек в состоянии по умолчанию.
Скачивание записной книжки
Прежде чем изменять содержимое записной книжки, необходимо скачать записную книжку в VS Code.
В списке записных книжек в VS Code наведите указатель мыши на имя записной книжки. Параметр скачивания отображается рядом с именем записной книжки.
Выберите "Скачать и сохранить записную книжку" в локальный рабочий каталог.
Открытие записной книжки
В обозревателе VS Code наведите указатель мыши на имя скачаемой записной книжки. Рядом с записной книжкой отображаются несколько параметров, включая параметр "Открыть папку записной книжки ".
Выберите "Открыть папку записной книжки", а записная книжка откроется на экране редактора VS Code.
Удаление записной книжки
Совет
Чтобы избежать сбоя, закройте папку записной книжки в представлении обозревателя и закройте записную книжку в представлении редактора перед удалением записной книжки.
Удаление записной книжки:
В обозревателе VS Code наведите указатель мыши на имя записной книжки, которую вы хотите удалить; Параметры отображаются справа от имени, включая параметр "Удалить записную книжку".
Выберите параметр "Удалить записную книжку". При появлении запроса выберите удалить только локальную копию или как локальную, так и удаленную рабочую область.
Публикация локальных изменений в удаленной рабочей области
Чтобы отправить локальные изменения в удаленную рабочую область, выполните следующие действия.
В обозревателе VS Code наведите указатель мыши на имя записной книжки, которую вы хотите опубликовать в удаленной рабочей области; Параметры отображаются справа от имени, включая параметр "Опубликовать ".
Выберите Опубликовать. Версия удаленной рабочей области обновляется с изменениями локального VS Code.
- Если локальное обновление создает любые конфликт слияния, вам будет предложено устранить их перед слиянием.
Если кто-то другой имеет ту же записную книжку, открытую на портале Fabric, они уведомляются принять или отклонить изменения локального VS Code, как показано на следующем рисунке.
- Примите: изменение vs Code успешно сохранено в рабочей области.
- Отклонить: изменение из VS Code игнорируется.
Извлечение изменений из удаленной рабочей области
Чтобы обновить локальную версию с помощью последней версии рабочей области, вы извлеките удаленную версию:
В обозревателе VS Code наведите указатель мыши на имя записной книжки, которую вы хотите обновить; Параметры отображаются справа от имени, включая параметр "Обновить записную книжку".
Выберите параметр "Обновить записную книжку". VS Code извлекает последнюю версию из удаленной рабочей области и открывает редактор диффов VS Code, чтобы сравнить два файла записной книжки. Левый экран находится в рабочей области, а правый экран — из локальной версии:
Обновите ячейку code/markdown слева, чтобы устранить проблему.
После решения всех конфликтов выберите параметр слияния в правом верхнем углу редактора диффа, чтобы убедиться, что слияние завершено. (Пока вы не выберете Слияние, записная книжка остается в режиме конфликта .)
Внимание
После открытия редактора диффа один раз расширение не будет автоматически обновлять левую часть представления диффа, чтобы получить последнее обновление из удаленной рабочей области.
Запуск или отладка записной книжки на удаленных вычислительных ресурсах Spark
Выбрав ядро synapse-spark-kernel , отправленное с этим расширением, можно запустить ячейку кода на основе удаленного вычисления Spark. После выбора этого ядра во время выполнения расширение перехватывает все вызовы API PySpark и преобразует их в соответствующий http-вызов к удаленному вычислению Spark. Для чистого кода Python он по-прежнему выполняется в локальной среде.
