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

Это важно

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

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

База данных U-SQL предоставляет структурированные представления по неструктурированным данным и управляемым структурированным данным в таблицах. Она также предоставляет общую систему каталога метаданных для организации структурированных данных и пользовательского кода. База данных — это концепция, которая объединяет эти связанные объекты вместе.

Дополнительные сведения о базе данных U-SQL и языке определения данных (DDL).

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

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

Средства Azure Data Lake для Visual Studio добавили новый шаблон проекта под названием проект базы данных U-SQL после версии 2.3.3000.0. Чтобы создать проект U-SQL, выберите "Файл > нового > проекта". Проект базы данных U-SQL можно найти в узле Azure Data Lake > U-SQL.

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

Щелкните правой кнопкой мыши проект базы данных U-SQL. Выберите Добавить > новый элемент. Все новые поддерживаемые типы объектов можно найти в мастере добавления нового элемента .

Для объекта, отличного от сборки (например, табличная функция), создается новый скрипт U-SQL после того, как вы добавите новый элемент. Вы можете начать разработку инструкции DDL для этого объекта в редакторе.

Для объекта сборки средство предоставляет удобный для пользователя редактор пользовательского интерфейса, который помогает зарегистрировать сборку и развернуть файлы DLL и другие файлы. Ниже показано, как добавить определение объекта сборки в проект базы данных U-SQL:

1. Добавьте ссылки на проект C#, включающий UDO/UDAG/UDF для проекта базы данных U-SQL.

   

   

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

   

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

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

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

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

Дополнительные сведения о создании проекта базы данных U-SQL с помощью командной строки MSBuild и задачи сборки Azure DevOps Services.

Развертывание базы данных 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.

   

   

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

1. Откройте обозреватель серверов. Затем разверните учетную запись Azure Data Lake Analytics , в которую необходимо развернуть базу данных.

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

3. Задайте источнику базы данных путь к пакету развертывания базы данных U-SQL (usqldbpack-файл).

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

   

   

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

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

Узнайте больше о пакете SDK и настройке конвейера CI/CD для развертывания базы данных U-SQL.

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

Проект U-SQL может ссылаться на проект базы данных U-SQL. Ссылка влияет на две задачи:

• Сборка проекта: настройте среды баз данных, на которые ссылается ссылка, прежде чем создавать скрипты U-SQL.
• Локальный запуск с учетной записью (локального проекта): среды баз данных, на которые ссылается ссылка, развертываются в учетной записи (локального проекта) перед выполнением скрипта U-SQL. Узнайте больше о локальных запусках и различиях между учетной записью локального компьютера и учетной записью локального проекта.

Добавление ссылки на базу данных U-SQL

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

   

2. Настройте ссылку на базу данных из проекта базы данных U-SQL в текущем решении или в файле пакета базы данных U-SQL.

3. Укажите имя базы данных.

   

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

• Настройка конвейера CI/CD для Azure Data Lake Analytics
• Тестирование кода Azure Data Lake Analytics
• запустить скрипт U-SQL на локальном компьютере