Использование проекта базы данных 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
Начиная с версии 2.3.3000.0, в Средства Azure Data Lake для Visual Studio добавлен новый шаблон проекта базы данных U-SQL. Чтобы создать проект U-SQL, выберите Файл > Новый > проект. Проект U-База данных SQL можно найти в узле U-SQL Azure Data Lake>.
Разработка объектов базы данных U-SQL с помощью проекта базы данных
Правой кнопкой мыши выберете проект базы данных U-SQL. Выберите Добавить > новый элемент. Все новые поддерживаемые типы объектов можно найти в мастере Добавить новый элемент.
Для объекта, не являющегося сборкой, например функции с табличным значением, сценарий U-SQL создается после добавления нового элемента. Можно начать разработку инструкции DDL для этого объекта в редакторе.
Для объекта сборки средство предоставляет удобный редактор пользовательского интерфейса, который помогает регистрировать сборку и развертывать DLL-файлы и другие файлы. Чтобы добавить определение объекта сборки в проект базы данных U-SQL, выполните следующие действия.
Добавьте ссылки на проект C#, который включает UDO/UDAG/UDF для проекта базы данных U-SQL.
В представлении конструкции сборки выберите ссылочную сборку из раскрывающегося меню Создать сборку из ссылки.
При необходимости добавьте Управляемые зависимости и Дополнительные файлы. При добавлении дополнительных файлов средство будет использовать относительный путь, чтобы позже обеспечить возможность определения сборки на локальном компьютере и компьютере построения.
@_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
Щелкните правой кнопкой мыши проект базы данных U-SQL и выберите Развернуть.
В мастере развертывания Баз данных U-SQLвыберите учетную запись ADLA, для которой требуется выполнить развертывание базы данных. Поддерживаются оба типа учетных записей — локальные и ADLA.
Источники базы данных заполняются автоматически, указывая на пакет .usqldbpack в выходной папке сборки проекта.
Введите имя в раздел Имя базы данных, чтобы создать базу данных. Если база данных с этим именем уже существует в целевой учетной записи Azure Data Lake Analytics, все объекты, указанные в проекте базы данных, создаются без ее повторного создания.
Щелкните Отправить для развертывания базы данных U-SQL. Все ресурсы (сборки и дополнительные файлы) загружаются, и отправляется задание U-SQL, которое включает все заявления DDL.
Развертывание с помощью пакета развертывания базы данных U-SQL
Откройте обозреватель сервера. Затем разверните учетную запись Azure Data Lake Analytics, для которой требуется выполнить развертывание базы данных.
Щелкните правой кнопкой мыши или нажмите и удерживайте базы данных U-SQL, а затем выберите Развернуть базу данных.
Задайте в качестве пути к пакету развертывания базы данных U-SQL (файл с расширением .usqldbpack) источник базы данных.
Введите имя в раздел Имя базы данных, чтобы создать базу данных. Если в целевой учетной записи Azure Data Lake Analytics есть база данных с тем же именем, все объекты, определенные в проекте базы данных, создаются без повторного создания базы данных.
Развертывание базы данных U-SQL с помощью пакета SDK
PackageDeploymentTool.exe предоставляет программный интерфейс и интерфейс командной строки, которые позволяют развернуть базы данных U-SQL. Пакет SDK входит в пакет NuGet пакета SDK U-SQL, расположенный по адресу build/runtime/PackageDeploymentTool.exe.
См. дополнительные сведения об использовании пакета SDK и настройке конвейера CI/CD для развертывания базы данных U-SQL.
Создание ссылки на проект базы данных U-SQL
Проект U-SQL может ссылаться на проект базы данных U-SQL. Ссылка влияет на две рабочие нагрузки:
- Сборка проекта. Перед созданием сценариев U-SQL настройте связанные среды баз данных.
- Локальная учетная запись (локальный проект). Связанные среды баз данных развертываются в (локальном проекте) до выполнения сценария U-SQL. Дополнительные сведения см. в разделе Запуск скриптов U-SQL на локальном компьютере.
Добавление ссылки на базу данных U-SQL
В обозревателе решений щелкните проект U-SQL правой кнопкой мыши и выберите Добавить ссылку на Базу данных U-SQL....
Настройте ссылку на базу данных из проекта базы данных U-SQL в текущем решении или файле пакета базы данных U-SQL.
Укажите имя базы данных.
