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

Что такое библиотека переменных? (предварительная версия)

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

Например, библиотека переменных может содержать переменные, содержащие разные значения:

  • Целое число, которое используется в активности ожидания в конвейере.
  • Ссылка на Lakehouse в качестве источника в действии Копирования данных. Каждое значение используется в различном конвейере в зависимости от этапа, на котором находится выпуск.
  • Ссылка на lakehouse, настроенная как lakehouse по умолчанию для записной книжки. Каждое значение используется в разных конвейерах в зависимости от стадии выпуска блокнота.

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

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

Библиотека переменных Fabric:

Примечание.

В настоящее время элемент библиотеки переменной Microsoft Fabric находится в предварительной версии.

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

  • Настройка конфигураций:

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

    • Изменение подключения элементов в зависимости от стадии процесса
    • Переход на другой облачный источник данных в зависимости от этапа
    • Настройка количества данных в запросе на основе этапа

  • Конфигурации для общего использования

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

Структура библиотеки переменных

Основные компоненты

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

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

Значение по умолчанию

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

Альтернативные наборы значений

Наборы значений определяют значения каждой переменной в библиотеке переменных. Библиотека переменных обычно содержит несколько наборов значений. Активный (или действующий) набор значений содержит значение, которое потребительские товары получают для этого рабочего пространства. В каждой рабочей области вы выбираете значение, которое будет активным. Активный набор значений рабочей области не изменяется во время развертывания или обновления из Git.

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

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

Поддерживаемые элементы

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

Рекомендации и ограничения

Ограничения размера

  • Существует до 1000 переменных и до 1000 наборов значений, если общее количество ячеек в альтернативных наборах значений составляет до 10 000 ячеек, а размер элемента не превышает 1 МБ. Это проверяется при сохранении изменений пользователем.
  • Поле заметки может содержать до 2048 символов.
  • Поле описания набора значений может содержать до 2 048 символов.

Альтернативные ограничения набора значений

  • Альтернативные наборы значений в библиотеке переменных отображаются в том порядке, в котором они были добавлены. В настоящее время вы не можете переупорядочение их в пользовательском интерфейсе. Чтобы изменить порядок, измените JSON-файл напрямую.
  • Имя каждого набора значений должно быть уникальным в библиотеке переменных.
  • Имена переменных должны быть уникальными в библиотеке переменных. Вы можете иметь две переменные с одинаковым именем в рабочей области, если они находятся в разных элементах.
  • В библиотеке переменных всегда задано одно и только одно активное значение. Не удается удалить активный набор значений. Чтобы удалить его, сначала задайте для него другое значение, которое должно быть активным. Для каждого этапа конвейера развертывания можно задать другой активный набор значений.

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