Usar um projeto de banco de dados U-SQL para desenvolver o banco de dados U-SQL para o Azure Data Lake
Importante
O Azure Data Lake Analytics desativado em 29 de fevereiro de 2024. Saiba mais nesse comunicado.
Para análise de dados, sua organização pode usar o Azure Synapse Analytics ou o Microsoft Fabric.
O banco de dados U-SQL fornece modos de exibição estruturados em dados não estruturados e gerenciados dados estruturados em tabelas. Também fornece um sistema de catálogo de metadados gerais para organizar seus dados estruturados e código personalizado. O banco de dados é o conceito que agrupa esses objetos relacionados.
Saiba mais sobre o banco de dados U-SQL e a Linguagem de Definição de Dados (DDL).
O projeto de banco de dados U-SQL é um tipo de projeto do Visual Studio que ajuda os desenvolvedores a desenvolver, gerenciar e implantar seus bancos de dados U-SQL de forma simples e rápida.
Criar um projeto de banco de dados U-SQL
As Ferramentas do Azure Data Lake para Visual Studio adicionaram um novo modelo de projeto chamado projeto de banco de dados U-SQL após a versão 2.3.3000.0. Para criar um projeto U-SQL, selecione Arquivo > Novo > Projeto. O projeto de banco de dados U-SQL pode ser encontrado em Azure Data Lake > nó U-SQL.
Desenvolver objetos de banco de dados U-SQL usando o projeto banco de dados
Clique com o botão direito do mouse no projeto de banco de dados U-SQL. Selecione Adicionar > Novo item. Você pode encontrar todos os novos tipos de objeto com suporte no assistente Adicionar Novo Item.
No caso do objeto que não é assembly (por exemplo, uma função com valor de tabela), um novo script U-SQL é criado após a adição de um novo item. Você pode começar a desenvolver a instrução DDL para esse objeto no editor.
Para um objeto assembly, a ferramenta fornece um editor de interface do usuário amigável que ajuda você a registrar o assembly e implantar arquivos DLL e outros arquivos. As etapas a seguir mostram como adicionar uma definição de objeto assembly para o projeto de banco de dados U-SQL:
Adicione referências do projeto C# que inclui o UDO/UDAG/UDF para o projeto de banco de dados U-SQL.
No modo de exibição de design do assembly, escolha o assembly referenciado no menu suspenso Criar assembly de referência.
Adicione Dependências Gerenciadas e Arquivos Adicionais, se houver. Ao adicionar arquivos adicionais, a ferramenta usará o caminho relativo para garantir que encontrará os assemblies no computador local e no computador de build.
@_DeployTempDirectory é uma variável predefinida que aponta a ferramenta para a pasta de saída de build. Na pasta de saída de compilação, cada assembly possui uma subpasta nomeada com o nome do assembly. Todas as DLLs e arquivos adicionais estão na subpasta.
Compilar um projeto de banco de dados U-SQL
A saída de build do projeto de banco de dados U-SQL é um pacote de implantação do banco de dados U-SQL nomeado com o sufixo .usqldbpack. O pacote .usqldbpack é um arquivo .zip que inclui todas as instruções DDL em um único script U-SQL na pasta DDL e todas as DLLS e arquivos adicionais para assemblies na pasta Temp.
Saiba mais sobre como criar um projeto de banco de dados U-SQL com a linha de comando do MSBuild e tarefas de compilação do Azure DevOps Services.
Implantar um banco de dados U-SQL
O pacote .usqldbpack pode ser implantado na conta local ou na conta do Azure Data Lake Analytics usando o Visual Studio ou o SDK de implantação.
Implantar um banco de dados U-SQL no Visual Studio
Você pode implantar um banco de dados U-SQL por meio de um projeto de banco de dados U-SQL ou um pacote .usqldbpack no Visual Studio.
Implantar por meio do projeto de banco de dados U-SQL
Clique com o botão direito do mouse no projeto de banco de dados U-SQL e selecione Implantar.
No assistente Implantar Banco de Dados U-SQL, escolha a conta do ADLA na qual você gostaria de implantar o banco de dados. Há suporte para as contas locais e ADLA.
A Fonte do Banco de Dados é preenchida automaticamente apontando para o pacote .usqldbpack na pasta de saída de compilação do projeto.
Insira um nome em Nome do Banco de Dados para criar um banco de dados. Se houver um banco de dados com o mesmo nome na conta do Azure Data Lake Analytics de destino, todos os objetos que são definidos no projeto de banco de dados serão criados sem recriar o banco de dados.
Para implantar o banco de dados U-SQL, selecione Enviar. Todos os recursos (assemblies e arquivos adicionais) serão carregados e um trabalho do U-SQL que inclui todas as instruções DDL será enviado.
Implantar por meio do pacote de implantação do banco de dados U-SQL
Abra o Gerenciador de Servidores. Em seguida, expanda a conta Azure Data Lake Analytics, para a qual você gostaria de implantar o banco de dados.
Clique com o botão direito do mouse ou pressione e segure bancos de dados U-SQL e escolha Implantar Banco de Dados.
Defina a Fonte do Banco de Dados para o caminho (arquivo .usqldbpack) do pacote de implantação do banco de dados U-SQL.
Insira o Nome do Banco de Dados para criar um banco de dados. Se houver um banco de dados com o mesmo nome que já existe na conta de Data Lake Analytics do Azure de destino, todos os objetos definidos no projeto de banco de dados serão criados sem recriar o banco de dados.
Implantar um banco de dados U-SQL usando o SDK
O PackageDeploymentTool.exe oferece as interfaces de programação e de linha de comando que ajudam a implantar os bancos de dados U-SQL. O SDK está incluído no pacote NuGet do SDK do U-SQL, localizado em build/runtime/PackageDeploymentTool.exe.
Fazer referência a um projeto de banco de dados U-SQL
Um projeto U-SQL pode fazer referência a um projeto de banco de dados U-SQL. A referência afeta duas cargas de trabalho:
- Compilação do projeto: os ambientes do banco de dados referenciado antes de compilar os scripts U-SQL.
- A execução local na conta (projeto Local): os ambientes de banco de dados referenciados são implantados na conta (projeto Local) antes da execução do script U-SQL. Saiba mais sobre a execução local e a diferença entre a conta de (computador local) e (projeto local) aqui.
Como adicionar uma referência de banco de dados U-SQL
Clique com o botão direito do mouse no projeto U-SQL no Gerenciador de Soluções e escolha Adicionar Referência de Banco de Dados U-SQL....
Configure a referência de banco de dados de um projeto de banco de dados U-SQL na solução atual ou um arquivo de pacote do banco de dados U-SQL.
Forneça o nome do banco de dados.
