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

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

Изучив это руководство, вы:

  • Создайте библиотеку переменных.
  • Добавьте переменные в библиотеку.
  • Определите дополнительные наборы значений для переменных.
  • Используйте переменные в другом элементе рабочей среды (например, конвейере).
  • Измените переменные в репозитории Git.
  • Создайте конвейер развертывания и разверните библиотеку переменных.
  • Измените активное значение, заданное на целевом этапе конвейера развертывания.
  • Показывает, что значение переменной соответствует активному набору значений на каждом этапе.

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

Схема макета рабочей области.

Предпосылки

Создание рабочей области Stage LHs, SourceLH_Stage lakehouse с примерами данных и конвейером Pipeline_Stage

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

  1. Перейдите в Power BI.

  2. На боковой панели выберите рабочую область.

  3. Создайтерабочую область. Вызовите его этап LHs.

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

  4. Создайте lakehouse:

    1. В верхней части рабочей области выберите новый элемент.

    2. В разделе "Хранилище данных" выберите Lakehouse.

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

    3. Введите имя SourceLH_Stage и нажмите кнопку "Создать".

  5. Создание конвейера:

    1. В lakehouse выберите Новый конвейер.

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

    2. Введите имя Pipeline_Stage и нажмите кнопку "Создать".

    3. В мастере копирования данных в Lakehouse на странице выбора источника данных выберите пример данных.

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

    4. Выберите общедоступные праздники.

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

    5. После завершения загрузки примера данных нажмите кнопку "Далее".

    6. На странице "Подключение к назначению данных" нажмите кнопку "Далее".

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

    7. На странице "Рецензирование и сохранение " нажмите кнопку "Сохранить и запустить".

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

Создание исходных LHs с помощью рабочей области "Переменные"

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

  1. Перейдите в Power BI.

  2. На боковой панели выберите рабочую область.

  3. Создайтерабочую область. Вызовите исходные LHS с переменными.

Создание SourceLH_Dev, SourceLH_Test и SourceLH_Prod lakehouses

Затем создайте три озера для использования с библиотекой переменных:

  1. Создайте первый лейкхаус:

    1. На боковой панели выберите исходные LHs с рабочей областью "Переменные ".

    2. Выберите Новый элемент.

    3. В разделе "Хранилище данных" выберите Lakehouse.

    4. Введите имя SourceLH_Dev и нажмите кнопку "Создать".

  2. Создайте второй lakehouse, выполнив описанные выше действия. Назовите его SourceLH_Test.

  3. Создайте третье озеро, выполнив описанные выше действия. Назовите его SourceLH_Prod.

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

Получение идентификаторов рабочих областей и идентификаторов объектов для lakehouses

В следующих шагах вы получите уникальные идентификаторы для использования в библиотеке переменных:

  1. В Power BI на боковой панели выберите рабочую область Stage LHs .

  2. В рабочей области выберите SourceLH_Stage lakehouse.

  3. Скопируйте идентификатор рабочей области и идентификатор объекта Lakehouse в URL-адресе.

    Снимок экрана: получение идентификатора рабочей области и идентификатора объекта Lakehouse.

  4. Повторите предыдущие шаги для SourceLH_Dev и SourceLH_Testlakehouses в исходном LHs с рабочей областью "Переменные ".

Создание библиотеки переменных с переменными

Теперь создайте библиотеку переменных:

  1. В исходной рабочей области LHs с переменными выберите новый элемент.

  2. В разделе "Разработка данных" выберите **Библиотека переменных **.

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

  3. Присвойте библиотеке переменные WS и нажмите кнопку "Создать".

  4. Выберите новую переменную.

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

  5. Создайте следующие переменные:

    Имя Тип Набор значений по умолчанию
    Source_LH Струна <GUID SourceLH_Stage lakehouse>
    Source_WSID Струна <GUID рабочей области SourceLH_Stage>
    Destination_LH Струна <GUID SourceLH_Dev lakehouse>
    Destination_WSID Струна <GUID рабочей области SourceLH_Dev>
    SourceTable_Name Струна Processed
    DestinationTable_Name Струна DevCopiedData

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

  6. Нажмите кнопку "Сохранить".

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

В следующих шагах вы добавите альтернативные наборы значений в библиотеку переменных:

  1. Создайте первый набор значений:

    1. В библиотеке переменных переменных WS выберите "Добавить значение".

    2. Введите тест VS для имени и нажмите кнопку "Создать".

    3. Создайте следующие переменные:

      Имя Тип Набор значений по умолчанию
      Source_LH Струна <GUID SourceLH_Dev lakehouse>
      Source_WSID Струна <GUID рабочей области SourceLH_Dev>
      Destination_LH Струна <GUID SourceLH_Test lakehouse>
      Destination_WSID Струна <GUID рабочей области SourceLH_Test>
      SourceTable_Name Струна DevCopiedData
      DestinationTable_Name Струна TestCopiedData

    4. Нажмите кнопку "Сохранить>согласие".

  2. Создайте второй набор значений:

    1. Выберите "Добавить набор значений".

    2. Введите prod VS для имени и нажмите кнопку "Создать".

    3. Создайте следующие переменные:

      Имя Тип Набор значений по умолчанию
      Source_LH Струна <GUID SourceLH_Test lakehouse>
      Source_WSID Струна <GUID рабочей области SourceLH_Test>
      Destination_LH Струна <GUID SourceLH_Prod lakehouse>
      Destination_WSID Струна <GUID рабочей области SourceLH_Prod>
      SourceTable_Name Струна TestCopiedData
      DestinationTable_Name Струна ProdCopiedData

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

    4. Нажмите кнопку "Сохранить>согласие".

Создание конвейера Pipeline_Deploy и объявление переменных

В следующих шагах вы создадите конвейер и объявите переменные:

  1. В исходной рабочей области LHs с переменными выберите новый элемент.

  2. В разделе "Получение данных" выберите "Конвейер".

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

  3. Введите имя Pipeline_Deploy и нажмите кнопку "Создать".

  4. Выберите "Копировать данные>" на холст.

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

  5. Выберите холст, чтобы фокус был отключен от копирования данных.

  6. Выберите **Переменные библиотеки**.

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

  7. Выберите "Создать", а затем добавьте следующие переменные:

    Имя Библиотека Имя переменной Тип
    SourceLH Переменные WS Source_LH Струна
    SourceWSID Переменные WS Source_WSID Струна
    DestinationLH Переменные WS Destination_LH Струна
    DestinationWSID Переменные WS Destination_WSID Струна
    SourceTableName Переменные WS SourceTable_Name Струна
    DestinationTableName Переменные WS DestinationTable_Name Струна

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

  8. Нажмите кнопку "Сохранить".

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

В следующих шагах вы настроите исходное подключение для конвейера:

  1. В исходной рабочей области LHs с переменными перейдите к Pipeline_Deploy.

  2. На холсте выберите " Копировать данные ", чтобы сосредоточиться на копировании данных.

  3. Выберите источник.

  4. Настройка SourceLH:

    1. В разделе "Исходное>подключение" выберите "Добавить динамическое содержимое".

    2. Выберите многоточие (...), а затем выберите **Переменные библиотеки**.

    3. Выберите SourceLH. Он заполняет поле с @pipeline().libraryVariables.SourceLHпомощью . Нажмите ОК.

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

  5. Настройка SourceWSID:

    1. В разделе "Идентификатор исходной>рабочей области" выберите "Добавить динамическое содержимое".

    2. Выберите многоточие (...), а затем выберите **Переменные библиотеки**.

    3. Выберите SourceWSID. Он заполняет поле с @pipeline().libraryVariables.SourceWSIDпомощью . Нажмите ОК.

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

  6. Настройка SourceTableName:

    1. В разделе "Исходная>таблица" нажмите клавишу ВВОД вручную, выберите имя таблицы и выберите " Добавить динамическое содержимое".

    2. Выберите многоточие (...), а затем выберите **Переменные библиотеки**.

    3. Выберите SourceTableName. Он заполняет поле с @pipeline().libraryVariables.SourceTableNameпомощью . Нажмите ОК.

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

  7. Теперь, когда настроено исходное подключение, его можно протестировать. Выберите предварительный просмотр данных и нажмите кнопку "ОК " во всплывающем элементе. После заполнения данных можно закрыть предварительный просмотр данных.

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

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

В следующих шагах вы настроите целевое подключение для конвейера:

  1. В исходной рабочей области LHs с переменными перейдите к Pipeline_Deploy.

  2. На холсте выберите " Копировать данные ", чтобы сосредоточиться на копировании данных.

  3. Выберите назначение.

  4. Настройка SourceLH:

    1. В разделе "Подключение назначения>" выберите "Добавить динамическое содержимое".

    2. Выберите многоточие (...), а затем выберите **Переменные библиотеки**.

    3. Выберите SourceLH. Он заполняет поле с @pipeline().libraryVariables.DestinationLHпомощью . Нажмите ОК.

      Снимок экрана: панель добавления динамического содержимого для назначения подключения.

  5. Настройка DestinationWSID:

    1. В разделе "Идентификатор целевой>рабочей области" выберите "Добавить динамическое содержимое".

    2. Выберите многоточие (...), а затем выберите **Переменные библиотеки**.

    3. Выберите DestinationWSID. Он заполняет поле с @pipeline().libraryVariables.DestinationWSIDпомощью . Нажмите ОК.

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

  6. Настройка DestinationTableName:

    1. В разделе "Целевая>таблица" нажмите клавишу ВВОД вручную, выберите имя таблицы и выберите "Добавить динамическое содержимое".

    2. Выберите многоточие (...), а затем выберите **Переменные библиотеки**.

    3. Выберите DestinationTableName. Он заполняет поле с @pipeline().libraryVariables.DestinationTableNameпомощью . Нажмите ОК.

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

  7. Теперь, когда целевое подключение настроено, сохраните конвейер и нажмите кнопку "Выполнить". Убедитесь, что он успешно выполняется.

    Снимок экрана: запуск конвейера.

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

Теперь создайте конвейер развертывания:

  1. В исходном LHs с рабочей областью "Переменные" выберите "Создать конвейер развертывания".

  2. Присвойте конвейеру имя Deployment_Pipeline_Var и нажмите кнопку "Далее".

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

  3. В конвейере развертывания нажмите кнопку "Создать" и продолжить.

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

  4. На этапе разработки :

    1. В раскрывающемся списке выберите исходные LHs с переменными для рабочей области. Затем установите флажок "Назначить ".

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

    2. Выберите Продолжить. Теперь этап должен быть заполнен элементами из рабочей области.

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

  5. На этапе тестирования :

    1. Установите флажок в верхней части, чтобы выбрать все элементы. Затем снимите флажок для SourceLH_Dev lakehouse.

    2. Нажмите кнопку "Развернуть ". Снова нажмите кнопку "Развернуть ". Теперь этап тестирования должен быть заполнен.

      Снимок экрана: тестовая часть нового конвейера развертывания.

  6. Для этапа производства :

    1. Установите флажок в верхней части, чтобы выбрать все элементы. Затем снимите флажок для SourceLH_Test lakehouse.

    2. Нажмите кнопку "Развернуть ". Снова нажмите кнопку "Развернуть ". Теперь этап рабочей среды должен быть заполнен.

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

Установка активного набора библиотеки переменных для каждого этапа

В следующих шагах вы настроите активный набор для каждого этапа в конвейере развертывания:

  1. Настройте активный набор для этапа тестирования :

    1. На боковой панели выберите конвейер Deployment_Pipeline_Var .

    2. Выберите этап тестирования .

      Снимок экрана: этап тестирования.

    3. Выберите переменные WS.

    4. Выберите многоточие (...), а затем выберите "Задать как активный". Нажмите кнопку "Задать как активный ".

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

      Активный набор теперь настроен.

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

    5. Нажмите кнопку "Сохранить>согласие".

  2. Настройте активный набор для этапа Prod :

    1. На боковой панели выберите конвейер Deployment_Pipeline_Var .

    2. Выберите этап Prod .

    3. Выберите переменные WS.

    4. Выберите многоточие (...), а затем выберите "Задать как активный". Нажмите кнопку "Задать как активный ".

    5. Нажмите кнопку "Сохранить>согласие".

Проверка и проверка библиотеки переменных

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

  1. Проверьте SourceLHs_Dev lakehouse:

    1. В исходной рабочей области LHs с переменными выберите SourceLHs_Dev lakehouse.

    2. Измените подключение из Lakehouse в конечную точку аналитики SQL.

    3. В обозревателе развернитетаблицы>>.

    4. Убедитесь, что появится таблица DevCopiedData .

      Снимок экрана: область для таблиц в обозревателе.

  2. Перейдите в SourceLHs_Test lakehouse и повторите предыдущие шаги.

    Таблица TestCopiedData не должна отображаться, так как вы еще не выполняли конвейер с активным набором Test VS .

  3. Перейдите в SourceLHs_Prod lakehouse и повторите предыдущие шаги.

    Таблица ProdCopiedData не должна отображаться, так как вы еще не выполняли конвейер с активным набором Prod VS .

  4. Проверьте этап тестирования конвейера Deployment_Pipeline_Var :

    1. Перейдите к конвейеру Deployment_Pipeline_Var и выберите этап тестирования .

    2. Выберите конвейер Pipeline_Deploy .

    3. Выберите Выполнить. Этот процесс должен завершиться успешно.

  5. Снова проверьте SourceLHs_Test lakehouse:

    1. Перейдите в SourceLHs_Test lakehouse.

    2. Измените подключение из Lakehouse в конечную точку аналитики SQL.

    3. В обозревателе развернитетаблицы>>.

    4. Убедитесь, что появится таблица TestCopiedData .

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

  6. Проверьте этап рабочей среды конвейера Deployment_Pipeline_Var :

    1. Перейдите к конвейеру Deployment_Pipeline_Var и выберите этап "Рабочая среда ".

    2. Выберите конвейер Pipeline_Deploy .

    3. Выберите Выполнить. Этот процесс должен завершиться успешно.

  7. Снова проверьте SourceLHs_Prod lakehouse:

    1. Перейдите в SourceLHs_Prod lakehouse.

    2. Измените подключение из Lakehouse в конечную точку аналитики SQL.

    3. В обозревателе развернитетаблицы>>.

    4. Убедитесь, что появится таблица ProdCopiedData .

Настройка значений переменных в Git (необязательно)

Чтобы узнать, как библиотека переменных представлена в Git, или изменить переменные из репозитория Git:

  1. В рабочей области выберите элемент управления версиями и подключите рабочую область к репозиторию Git.

  2. На панели управления версиями выберите "Фиксация ", чтобы отправить содержимое рабочей области в репозиторий Git.

    Репозиторий Git содержит папку для каждого элемента в рабочей области. Папка с именем переменных WS. VariableLibrary представляет элемент библиотеки переменных. Дополнительные сведения о содержимом этой папки см. в разделе Ci/CD библиотеки переменных.

  3. Сравните файлыProdVS.json и TestVS.json в папке valueSets . Убедитесь, что overrides переменная имеет разные значения. Эти значения можно изменить непосредственно в пользовательском интерфейсе или изменить этот файл в Git и обновить его в рабочей области.

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

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

  • Last updated on