Что такое библиотека переменных?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для поддержки динамической конфигурации каждая переменная может иметь несколько наборов значений или альтернативных наборов значений, адаптированных для разных сред (например, dev, test, prod). Один набор значений обозначается как "активный" для каждой рабочей области, определяя значения, используемые во время выполнения.

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

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

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

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

Соглашения об именах

Имя элемента библиотеки переменной должно соответствовать следующим соглашениям:

  • Не пуст
  • Не имеет начальных или конечных пробелов
  • Начинается с буквы
  • Может включать буквы, цифры, подчеркивания, дефисы и пробелы
  • Длина не превышает 256 символов

Имя библиотеки переменных не чувствительно к регистру.

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

Ограничения для переменных

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

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

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

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

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

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

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

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

  • Last updated on