Интеграция библиотеки переменных с конвейерами

Библиотека переменных — это новый тип элемента в Microsoft Fabric. С помощью библиотеки переменных можно определять переменные на уровне рабочей области и управлять ими. Эти переменные можно использовать в различных элементах рабочей области, таких как конвейеры, записные книжки, ярлыки для lakehouse и многое другое. Он предоставляет единый и централизованный способ управления конфигурациями, уменьшая потребность в жестко закодированных значениях и упрощая процессы CI/CD. Проще управлять конфигурациями в разных средах.

Использование библиотеки переменных с конвейерами

  1. Перейдите в рабочую область и создайте новый элемент.

    Снимок экрана: добавление нового элемента в выделенную рабочую область Fabric.

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

    Снимок экрана: фильтр для нового элемента библиотеки переменной.

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

    Снимок экрана: новый элемент библиотеки переменных с набором имен и выделенной кнопкой

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

    Снимок экрана: начальная страница для нового элемента библиотеки переменных.

  5. При добавлении новой переменной можно настроить переменную и задать значение Name, Type и Default. Вы также можете добавить заметки.

    Снимок экрана: конфигурации, заданные для новой переменной.

  6. При необходимости добавьте альтернативные наборы значений (например, разные значения для разных сред конвейера развертывания). После задания имени и нажатия кнопки "Создать" можно изменить значения переменной и выбрать, какой набор значений будет активным.

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

    Снимок экрана: добавление имени для нового набора значений.

  7. Сохраните изменения после завершения.

    Снимок экрана: кнопка

Используйте переменные библиотеки в вашем конвейере

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

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

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

    Снимок экрана: вкладка переменных библиотеки и кнопка +Создать на нижней панели холста конвейера.

  3. Нажмите кнопку +Создать. Откроется всплывающее окно, отображающее все библиотеки переменных. Используйте этот средство выбора, чтобы выбрать переменную библиотеки переменных и нажмите кнопку "ОК".

    Снимок экрана с выделенной кнопкой +New на вкладке переменной библиотеки.

    Снимок экрана: переменная библиотеки, выбранная в средство выбора переменных.

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

  4. После добавления ссылок на переменные библиотеки добавьте действия конвейера. В параметрах действий выберите "Добавить динамическое содержимое " для параметра, который требуется параметризировать.

    Скриншот показывает

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

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

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

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

    Снимок экрана: набор выражений в построителе выражений.

  7. Вы видите, что динамическое содержимое добавляется в настройку активности.

    Скриншот: заданное выражение как динамическое содержимое в параметрах действия подстановки.

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

    Снимок экрана: параметр предварительного просмотра данных.

    Снимок экрана: панель предварительного просмотра данных.

  9. Сохраните и запустите ваш конвейер, как обычно. Вы видите, что переданное значение является любым значением, заданным как "Активный" в библиотеке переменных.

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

Известные ограничения

Следующие известные ограничения применяются к интеграции библиотеки переменных в конвейерах в Фабрике данных в Microsoft Fabric:

  • Библиотека переменных поддерживает типы данных Boolean, Datetime, Guid, Integer, Number и String. В вашем конвейере вы видите Boolean как тип Bool, Datetime как тип String, Guid как тип String, Целое число как тип Int и String как тип String. Типы чисел не поддерживаются в конвейерах.
  • Параметризация внешнего подключения поддерживается с помощью библиотеки переменных, интегрированной с конвейерами. Однако необходимо найти GUID для подключения из Настройки | Управление подключениями и шлюзами. Идентификатор GUID для вашего подключения можно найти, выбрав "Параметры" рядом с названием вашего подключения.

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

  • Last updated on