Бөлісу құралы:

Рекомендации по управлению сборками U-SQL в конвейере CI/CD

  • Мақала

В этой статье вы узнаете, как управлять исходным кодом сборки U-SQL с помощью нового проекта базы данных U-SQL. Здесь вы также узнаете, как настроить конвейер непрерывной интеграции и развертывания (CI/CD) для регистрации сборки с помощью Azure DevOps.

Важно!

Поддержка Azure Data Lake Analytics прекращена 29 февраля 2024 г. Дополнительные сведения см. в этом объявлении.

Для аналитики данных ваша организация может использовать Azure Synapse Analytics или Microsoft Fabric.

Использование проекта базы данных U-SQL для управления исходным кодом сборки

Проект базы данных U-SQL — это тип проекта в Visual Studio, который помогает разработчикам быстро и легко разрабатывать, развертывать и администрировать свои базы данных U-SQL. Всеми объектами базы данных U-SQL (за исключением учетных данных) можно управлять с помощью проекта базы данных U-SQL.

Для управления исходным кодом сборки C# и сценариями U-SQL на языке DDL для регистрации сборки используйте следующие компоненты:

  • проект базы данных U-SQL — для управления сценариями U-SQL регистрации сборки;
  • библиотека классов (для приложения U-SQL) — для управления исходным кодом C# и зависимостями для операторов, функций и агрегаторов, определяемых пользователем (UDO/UDF/UDAG);
  • проект базы данных U-SQL — для ссылки на проект библиотеки классов.

Проект базы данных U-SQL может ссылаться на проект библиотеки классов (для приложения U-SQL). Сборки, зарегистрированные в базе данных U-SQL, можно создать с помощью исходного кода C#, на который есть ссылка, из этого проекта библиотеки классов (для приложения U-SQL).

Чтобы создать проекты и добавить ссылки, выполните следующие действия.

  1. Создайте проект библиотеки классов (для приложения U-SQL), последовательно выбрав Файл>Создать>Проект. Проект находится в узле U-SQL Azure Data Lake>.

    Создание проекта библиотеки классов C# с помощью средств Azure Data Lake для Visual Studio

  2. Добавьте свой код C#, определяемый пользователем, в проект библиотеки классов (для приложения U-SQL).

  3. Создайте проект U-SQL, последовательно выбрав Файл>Создать>Проект. Проект находится в узле Azure Data Lake>U-SQL.

    Создание проекта базы данных U-SQL с помощью средств Azure Data Lake для Visual Studio

  4. Добавьте ссылку на проект библиотеки классов C# для проекта базы данных U-SQL.

    Инструменты Data Lake для Visual Studio: добавить ссылку

    Инструменты Data Lake для Visual Studio: Добавить ссылку на проект базы данных U-SQL

  5. Создайте сценарий сборки в проекте базы данных U-SQL. Для этого щелкните проект правой кнопкой мыши, а затем выберите пункт Добавить новый элемент.

    Добавление сценария сборки с помощью средств Azure Data Lake для Visual Studio

  6. Откройте сценарий сборки в представлении конструктора сборки. В раскрывающемся меню Создать сборку из ссылки выберите сборку, на которую указывает ссылка.

    Создание сборки из ссылки с помощью Средств Data Lake для Visual Studio

  7. При необходимости добавьте Управляемые зависимости и Дополнительные файлы. При добавлении дополнительных файлов средство будет использовать относительный путь, чтобы позже обеспечить возможность определения сборок на локальном компьютере и компьютере сборки.

@_DeployTempDirectory в окне редактора в нижней части окна — это предопределенная переменная, указывающая средство на выходную папку сборки. В выходной папке сборки каждая сборка имеет вложенную папку с именем сборки. Все библиотеки DLL, а также дополнительные файлы, находятся в этой вложенной папке.

Создание проекта базы данных U-SQL

Выходные данные сборки для проекта базы данных U-SQL представляют собой пакет развертывания базы данных U-SQL. У него есть суффикс .usqldbpack. Пакет .usqldbpack представляет собой ZIP-файл, который содержит все инструкции DDL в едином сценарии U-SQL в папке DDL. Все созданные DLL-файлы и дополнительные файлы для сборок находятся в папке Temp.

Развертывание базы данных U-SQL

Пакет .usqldbpack можно развернуть для локальной учетной записи или учетной записи Azure Data Lake Analytics. Используйте Visual Studio или пакет SDK для развертывания.

Развертывание базы данных U-SQL в Visual Studio

Вы можете развернуть базу данных U-SQL, используя проект базы данных U-SQL или пакет .usqldbpack в среде Visual Studio.

Развертывание с помощью проекта базы данных U-SQL

  1. Щелкните правой кнопкой мыши проект базы данных U-SQL и выберите Развернуть.

  2. В мастере развертывания баз данных U-SQL выберите учетную запись ADLA, для которой требуется развернуть базу данных. Поддерживаются оба типа учетных записей — локальные и ADLA.

  3. Поле Источник базы данных будет заполнено автоматически. Значение указывает на пакет .usqldbpack в выходной папке сборки проекта.

  4. Введите имя в раздел Имя базы данных, чтобы создать базу данных. Если база данных с этим именем уже существует в целевой учетной записи Azure Data Lake Analytics, все объекты, указанные в проекте базы данных, создаются без ее повторного создания.

  5. Щелкните Отправить для развертывания базы данных U-SQL. Загружаются все ресурсы (сборки и дополнительные файлы). Отправляется задание U-SQL, которое включает все инструкции DDL.

    Развертывание проекта базы данных U-SQL с помощью Средств Data Lake для Visual Studio

    Мастер развертывания проекта базы данных U-SQL с помощью Средств Data Lake для Visual Studio

Развертывание базы данных U-SQL в Azure DevOps

PackageDeploymentTool.exe предоставляет программный интерфейс и интерфейс командной строки, которые позволяют развернуть базы данных U-SQL. Пакет SDK входит в пакет NuGet пакета SDK U-SQL, расположенный по адресу build/runtime/PackageDeploymentTool.exe.

В Azure DevOps вы можете использовать задачу командной строки и этот пакет SDK, чтобы настроить конвейер автоматизации для обновления базы данных U-SQL. См. дополнительные сведения об использовании пакета SDK и настройке конвейера CI/CD для развертывания базы данных U-SQL.

Дальнейшие действия