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

Рекомендации по управлению сборками 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# и скриптами DDL U-SQL для регистрации сборок, используйте следующий код:

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

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

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

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

    Data Lake Tools for Visual Studio--Создание проекта библиотеки классов C#

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

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

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

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

    Data Lake Tools для Visual Studio — добавление ссылки

    Data Lake Tools for Visual Studio — добавление ссылки на проект базы данных U-SQL

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

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

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

    Data Lake Tools for 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. Введите имя в поле Database Name, чтобы создать базу данных. Если база данных с таким именем уже существует в целевой учетной записи Azure Data Lake Analytics, все объекты, определенные в проекте базы данных, создаются без повторного создания базы данных.

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

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

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

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

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

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

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