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

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

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

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

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

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

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

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

  • Совместима с процессами непрерывной интеграции и непрерывной доставки (CI/CD). Эта совместимость позволяет интегрироваться с Git и развертыванием с помощью конвейеров развертывания.
  • Поддерживает автоматизацию через общедоступные API Fabric.

Примечание.

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

Преимущества

Библиотеки переменных позволяют клиентам настраивать конфигурации и совместно использовать их.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • До 1000 переменных и до 1000 наборов значений, если вы соответствуете обоим из этих требований:

    • Общее количество ячеек в альтернативных наборах значений меньше 10 000.
    • Размер элемента не превышает 1 МБ.

    Эти требования проверяются при сохранении изменений.

  • Поле заметки может содержать до 2048 символов.

  • Поле описания набора значений может содержать до 2 048 символов.

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

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

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