Usar um projeto de banco de dados U-SQL para desenvolver um banco de dados U-SQL para o Azure Data Lake

O banco de dados U-SQL fornece exibições estruturadas sobre dados não estruturados e dados estruturados gerenciados em tabelas. Ele 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 no Visual Studio que ajuda os desenvolvedores a desenvolver, gerenciar e implantar seus bancos de dados U-SQL de forma rápida e fácil.

Criar um projeto de banco de dados U-SQL

O Azure Data Lake Tools for Visual Studio adicionou 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 no nó U-SQL do Azure Data Lake>.

Desenvolver objetos de banco de dados U-SQL usando um projeto de 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 suportados no Assistente para Adicionar Novo Item .

Para um objeto que não seja assembly (por exemplo, uma função com valor de tabela), um novo script U-SQL é criado depois que você adiciona 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 ao projeto de banco de dados U-SQL:

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

   

   

2. Na visualização de design de montagem, escolha a montagem referenciada no menu suspenso Criar montagem a partir da referência .

   

3. Adicione dependências gerenciadas e arquivos adicionais , se houver. Quando você adiciona arquivos adicionais, a ferramenta usa o caminho relativo para garantir que ele possa encontrar os assemblies em sua máquina local e na máquina 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 conjunto tem uma subpasta com o mesmo nome. Todas as DLLs e arquivos adicionais estão nessa subpasta.

Criar um projeto de banco de dados U-SQL

A saída de compilação para um projeto de banco de dados U-SQL é um pacote de implantação de banco de dados U-SQL, nomeado com o sufixo .usqldbpack. O .usqldbpack pacote é 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 MSBuild e uma tarefa de compilação dos Serviços de DevOps do Azure.

Implantar um banco de dados U-SQL

O pacote .usqldbpack pode ser implantado em uma conta local ou em uma 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 de um projeto de banco de dados U-SQL

1. Clique com o botão direito do mouse no projeto de banco de dados U-SQL e selecione Implantar.

2. No Assistente para Implantar Banco de Dados U-SQL, selecione a conta ADLA na qual você deseja implantar o banco de dados. As contas locais e as contas ADLA são suportadas.

3. A origem do banco de dados é preenchida automaticamente e aponta para o pacote .usqldbpack na pasta de saída de compilação do projeto.

4. Insira um nome em Nome do Banco de Dados para criar um banco de dados. Se já existir um banco de dados com esse mesmo nome na conta de destino do Azure Data Lake Analytics, todos os objetos definidos no projeto de banco de dados serão criados sem recriar o banco de dados.

5. Para implantar o banco de dados U-SQL, selecione Enviar. Todos os recursos (assemblies e ficheiros adicionais) são carregados e um trabalho U-SQL que inclui todas as instruções DDL é submetido.

   

   

Implantar por meio de um pacote de implantação de banco de dados U-SQL

1. Abra o Gerenciador de Servidores. Em seguida, expanda a conta do Azure Data Lake Analytics na qual você deseja implantar o banco de dados.

2. Clique com o botão direito do mouse ou pressione e segure Bancos de Dados U-SQL e escolha Implantar Banco de Dados.

3. Defina a origem do banco de dados como o caminho do pacote de implantação do banco de dados U-SQL (arquivo .usqldbpack).

4. 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 destino do Azure Data Lake Analytics, todos os objetos definidos no projeto de banco de dados serão criados sem recriar o banco de dados.

   

   

Implantar o banco de dados U-SQL usando o SDK

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

Saiba mais sobre o SDK e como configurar o pipeline de CI/CD para implantação de banco de dados U-SQL.

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: configure os ambientes de banco de dados referenciados antes de criar os scripts U-SQL.
• Execução local contra (um projeto local): Os ambientes de banco de dados referenciados são implantados na conta (um projeto local) antes da execução do script U-SQL. Saiba mais sobre execuções locais e a diferença entre a conta de (a máquina local) e (um projeto local) aqui.

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

1. Clique com o botão direito do mouse no projeto U-SQL no Gerenciador de Soluções e escolha Adicionar Referência do Banco de Dados U-SQL....

   

2. Configure uma referência de banco de dados de um projeto de banco de dados U-SQL na solução atual ou em um arquivo de pacote de banco de dados U-SQL.

3. Forneça o nome para o banco de dados.

   

Próximos passos

• Como configurar um pipeline de CI/CD para o Azure Data Lake Analytics
• Como testar o código do Azure Data Lake Analytics
• Executar script U-SQL em sua máquina local