Utilizar um projeto de base de dados U-SQL para desenvolver uma base de dados U-SQL para o Azure Data Lake

Importante

O Azure Data Lake Analytics descontinuado a 29 de fevereiro de 2024. Saiba mais com este anúncio.

Para análise de dados, a sua organização pode utilizar o Azure Synapse Analytics ou o Microsoft Fabric.

A base de dados U-SQL fornece vistas estruturadas sobre dados não estruturados e dados estruturados geridos em tabelas. Também fornece um sistema de catálogo de metadados geral para organizar os seus dados estruturados e código personalizado. A base de dados é o conceito que agrupa estes objetos relacionados.

Saiba mais sobre a base de dados U-SQL e a Linguagem DDL (Data Definition Language).

O projeto de base de dados U-SQL é um tipo de projeto no Visual Studio que ajuda os programadores a desenvolver, gerir e implementar as respetivas bases de dados U-SQL de forma rápida e fácil.

Criar um projeto de base de dados U-SQL

O Azure Data Lake Tools para Visual Studio adicionou um novo modelo de projeto denominado projeto de base de dados U-SQL após a versão 2.3.3000.0. Para criar um projeto U-SQL, selecione Ficheiro > Novo > Projeto. O Projeto U-Base de Dados SQL pode ser encontrado no nó U-SQL do Azure Data Lake>.

Ferramentas do Data Lake para Visual Studio – criar projeto de base de dados U-SQL

Desenvolver objetos de base de dados U-SQL com um projeto de base de dados

Clique com o botão direito do rato no projeto de base de dados U-SQL. Selecione Adicionar > Novo item. Pode encontrar todos os novos tipos de objeto suportados no Assistente para Adicionar Novo Item .

Para um objeto que não seja de assemblagem (por exemplo, uma função com valor de tabela), é criado um novo script U-SQL depois de adicionar um novo item. Pode começar a desenvolver a instrução DDL para esse objeto no editor.

Para um objeto de assemblagem, a ferramenta fornece um editor de IU amigável que o ajuda a registar a assemblagem e implementar ficheiros DLL e outros ficheiros. Os passos seguintes mostram como adicionar uma definição de objeto de assemblagem ao projeto de base de dados U-SQL:

  1. Adicione referências ao projeto C# que incluem uDO/UDAG/UDF para o projeto de base de dados U-SQL.

    Ferramentas do Data Lake para Visual Studio – Adicionar referência

    Ferramentas do Data Lake para Visual Studio – Adicionar referência de projeto de base de dados U-SQL

  2. Na vista de estrutura da assemblagem, selecione a assemblagem referenciada em Criar assemblagem no menu pendente de referência .

    Ferramentas do Data Lake para Visual Studio – criar assemblagem a partir da referência

  3. Adicione Dependências Geridas e Ficheiros Adicionais , se existirem. Quando adiciona ficheiros adicionais, a ferramenta utiliza o caminho relativo para se certificar de que consegue encontrar as assemblagens no computador local e no computador de compilação mais tarde.

@_DeployTempDirectory é uma variável predefinida que aponta a ferramenta para a pasta de saída da compilação. Na pasta de saída da compilação, cada assemblagem tem uma subpasta chamada com o nome da assemblagem. Todas as DLLs e ficheiros adicionais estão nessa subpasta.

Criar um projeto de base de dados U-SQL

O resultado da compilação de um projeto de base de dados U-SQL é um pacote de implementação de base de dados U-SQL com o nome com o sufixo .usqldbpack. O .usqldbpack pacote é um ficheiro .zip que inclui todas as instruções DDL num único script U-SQL na pasta DDL e todos os DLLs e ficheiros adicionais para assemblagens na pasta Temp .

Saiba mais sobre como criar um projeto de base de dados U-SQL com a linha de comandos MSBuild e uma tarefa de compilação dos Serviços de DevOps do Azure.

Implementar uma base de dados U-SQL

O pacote .usqldbpack pode ser implementado numa conta local ou numa conta do Azure Data Lake Analytics com o Visual Studio ou o SDK de implementação.

Implementar uma base de dados U-SQL no Visual Studio

Pode implementar uma base de dados U-SQL através de um projeto de base de dados U-SQL ou de um pacote .usqldbpack no Visual Studio.

Implementar através de um projeto de base de dados U-SQL

  1. Clique com o botão direito do rato no projeto de base de dados U-SQL e, em seguida, selecione Implementar.

  2. No Assistente para Implementar Base de Dados SQL U, selecione a conta do ADLA na qual pretende implementar a base de dados. As contas locais e as contas do ADLA são suportadas.

  3. A Origem da Base de Dados é preenchida automaticamente e aponta para o pacote .usqldbpack na pasta de saída da compilação do projeto.

  4. Introduza um nome no Nome da Base de Dados para criar uma base de dados. Se já existir uma base de dados com esse mesmo nome na conta de destino do Azure Data Lake Analytics, todos os objetos definidos no projeto de base de dados são criados sem recriar a base de dados.

  5. Para implementar a base de dados U-SQL, selecione Submeter. Todos os recursos (assemblagens e ficheiros adicionais) são carregados e é submetida uma tarefa U-SQL que inclui todas as instruções DDL.

    Ferramentas do Data Lake para Visual Studio – Implementar projeto de base de dados U-SQL

    Ferramentas do Data Lake para Visual Studio – Assistente para implementar projetos de base de dados U-SQL

Implementar através de um pacote de implementação de base de dados U-SQL

  1. Abra o Explorador de Servidores. Em seguida, expanda a conta do Azure Data Lake Analytics para a qual pretende implementar a base de dados.

  2. Clique com o botão direito do rato ou prima sem soltar Bases de Dados U-SQL e, em seguida, selecione Implementar Base de Dados.

  3. Defina a Origem da Base de Dados para o caminho do pacote de implementação da base de dados U-SQL (ficheiro .usqldbpack).

  4. Introduza o Nome da Base de Dados para criar uma base de dados. Se existir uma base de dados com o mesmo nome que já existe na conta de destino do Azure Data Lake Analytics, todos os objetos definidos no projeto de base de dados são criados sem recriar a base de dados.

    Ferramentas do Data Lake para Visual Studio – Implementar o pacote de base de dados U-SQL

    Ferramentas do Data Lake para Visual Studio – Assistente para Implementar o pacote de base de dados U-SQL

Implementar a base de dados U-SQL com o SDK

PackageDeploymentTool.exe fornece a programação e as interfaces de linha de comandos que ajudam a implementar bases de dados U-SQL. O SDK está incluído no pacote NuGet do SDK U-SQL, localizado em build/runtime/PackageDeploymentTool.exe.

Saiba mais sobre o SDK e como configurar o pipeline CI/CD para a implementação da base de dados U-SQL.

Referenciar um projeto de base de dados U-SQL

Um projeto U-SQL pode referenciar um projeto de base de dados U-SQL. A referência afeta duas cargas de trabalho:

Como adicionar uma referência de base de dados U-SQL

  1. Clique com o botão direito do rato no projeto U-SQL no Explorador de Soluções e, em seguida, selecione Adicionar Referência Base de Dados SQL U....

    Ferramentas do Data Lake para Visual Studio – adicionar referência do projeto de base de dados

  2. Configure uma referência de base de dados a partir de um projeto de base de dados U-SQL na solução atual ou num ficheiro de pacote de base de dados U-SQL.

  3. Indique o nome da base de dados.

    Assistente de referência para adicionar projetos de base de dados às Ferramentas do Data Lake para Visual Studio

Passos seguintes