Поделиться через

Функции пользовательских данных для управления исходным кодом и развертывания

В этой статье объясняется, как работают конвейеры интеграции и развертывания Git для пользовательских функций данных в Microsoft Fabric. Интеграция с Git позволяет синхронизировать рабочую область Fabric с ветвью репозитория, что дает возможность вести контроль версий функций пользовательских данных, работать совместно с ветками и pull-запросами, а также взаимодействовать с кодом в предпочитаемых инструментах Git, таких как Azure DevOps.

Узнайте больше о процессе интеграции Git с рабочей областью Microsoft Fabric в разделе Основные понятия интеграции Git.

Настройка подключения

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

Снимок экрана: элемент функций данных пользователя с незафиксированными изменениями в системе контроля версий.

После успешной фиксации элементов пользовательских функций данных в репозитории Git в нем отображаются папки с пользовательскими функциями данных. Теперь можно выполнять предстоящие операции, например создать пулл-реквест.

Представление функций пользовательских данных в Git

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

Снимок экрана: структура папок для элемента пользовательских функций данных в репозитории.

Структура папок содержит следующие элементы:

  • .platform: файл .platform содержит следующие атрибуты:

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

    • версия: номер версии системных файлов. Это число используется для обеспечения обратной совместимости. Номер версии элемента может отличаться.
    • логический идентификатор: автоматически созданный идентификатор кросс-рабочих областей, представляющий элемент и его представление в системе управления версиями.
    • тип: UserDataFunction — это тип для определения элемента пользовательских функций данных.
    • displayName: представляет имя элемента. При переименовании элемента функций данных пользователя это отображаемое имя обновляется.

  • definitions.json: этот файл предоставляет общий доступ ко всем определениям элементов пользовательских функций данных, таким как подключения, библиотеки и т. д. в качестве представления свойств элемента функций данных пользователя.

    Снимок экрана: файл definitions.json для элемента функций данных пользователя.

  • function-app.py: этот файл — код функций. Все изменения кода, внесенные в элемент пользовательских функций данных, синхронизируются с репозиторием с этим файлом. Вы можете выполнять различные операции Git для управления циклом разработки кода.

    снимок экрана, показывающий файл function-app.py для элемента функций данных пользователя.

  • ресурсы: папка содержит файл functions.json со всеми метаданными, такими как соединения, библиотеки и функции данного элемента. НЕ ОБНОВЛЯЙТЕ ЭТОТ ФАЙЛ вручную. functions.json позволяет Fabric создавать или заново создавать объекты функций пользовательских данных в рабочей области.

    снимок экрана, показывающий файл function.json в папке ресурсов для элемента функций пользовательских данных.

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

Функции пользовательских данных в конвейерах развертывания

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

Примечание.

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

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

  1. Создайте новый конвейер развертывания или откройте существующий конвейер развертывания. Дополнительные сведения см. в статье "Начало работы с конвейерами развертывания ".

  2. Распределите рабочие пространства по различным этапам в соответствии с целями развертывания.

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

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

  5. Отслеживайте состояние развертывания из журнала развертывания .

Связанный контент

  • Last updated on