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

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

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

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

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

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

Предпосылки

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

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

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

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

  3. Создайтерабочую область. Назовите это Stage LHs.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Создайте исходные LH в рабочей области «Переменные»

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

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

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

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

Создайте озёрные хранилища SourceLH_Dev, SourceLH_Test и SourceLH_Prod

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

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

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

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

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

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

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

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

  4. На боковой панели выберите рабочую область Source LHs with Variables и убедитесь, что в ней содержатся все вновь созданные lakehouses.

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

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

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

  2. В рабочей области выберите озеро-хранилище SourceLH_Stage.

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

    Снимок экрана, показывающий, как получить идентификатор рабочей области и идентификатор объекта Lakehouse.

  4. Повторите предыдущие шаги для lakehouses SourceLH_Dev и SourceLH_Test в рабочей области Source LHs with Variables.

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

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

  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. Введите имя Test 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>
      Destination_WSID Струна <GUID рабочей области SourceLH_Prod>
      SourceTable_Name Струна TestCopiedData
      DestinationTable_Name Струна ProdCopiedData

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

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

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

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

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

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

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

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

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

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

  5. Выберите холст, чтобы убрать фокус с Copy data.

  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. В рабочей области Source LHs with Variables перейдите к 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. В рабочей области Source LHs with Variables перейдите к 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. В рабочей области Source LHs with Variables выберите Создать конвейер развертывания.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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:

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

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

    3. В обозревателе разверните Схемы>dbo>Таблицы.

    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. В обозревателе разверните Схемы>dbo>Таблицы.

    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. В обозревателе разверните Схемы>dbo>Таблицы.

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

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

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

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

  2. На панели Управление версиями выберите Зафиксировать, чтобы отправить содержимое рабочей области в репозиторий Git.

    Репозиторий Git содержит папку для каждого элемента в рабочей области. Папка с именем WS variables.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