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 geral de catálogo de metadados 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 DDL (Linguagem de Definição de Dados).

O projeto do 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

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 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 do banco de dados U-SQL. Selecione Adicionar > Novo item. Você pode encontrar todos os novos tipos de objeto com suporte no Assistente para Adicionar Novo Item .

Para um objeto não 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 de montagem, a ferramenta fornece um editor de interface do usuário intuitivo que ajuda você a registrar a montagem e implantar arquivos DLL e outros arquivos. As etapas a seguir mostram como adicionar uma definição de objeto assembly ao projeto do banco de dados U-SQL:

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

   

   

2. No modo de exibição de design do assembly, escolha o assembly referenciado em Criar assembly de referência do menu suspenso.

   

3. Adicione dependências gerenciadas e arquivos adicionais se houver algum. Quando você adiciona arquivos adicionais, a ferramenta usa o caminho relativo para garantir que ele possa encontrar os assemblies no computador local e no computador de build mais tarde.

@_DeployTempDirectory é uma variável predefinida que aponta a ferramenta para a pasta de saída de build. Na pasta de saída de build, cada assembly tem uma subpasta nomeada pelo nome do assembly. Todas as DLLs e arquivos adicionais estão nessa subpasta.

Criar um projeto de banco de dados U-SQL

A saída de build para um projeto de banco de dados U-SQL é um pacote de implantação do 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 do MSBuild e uma tarefa de build do Azure DevOps Services.

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 do banco de dados U-SQL e selecione Implantar.

2. No Assistente para Implantar Banco de Dados U-SQL, selecione a conta do ADLA na qual você deseja implantar o banco de dados. Há suporte para contas locais e contas do ADLA.

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

4. Insira um nome no Nome do Banco de Dados para criar um banco de dados. Se um banco de dados com esse mesmo nome já existir 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 arquivos adicionais) são carregados, e uma tarefa U-SQL que inclui todas as instruções DDL é enviada.

   

   

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 para a 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 para 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 do banco de dados U-SQL.

Referenciar 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 em uma conta (um projeto local): os ambientes de banco de dados referenciados são implantados em uma conta (um projeto local) antes da execução do script U-SQL. Saiba mais sobre as execuções locais e a diferença entre (o computador local) e (uma conta de 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 do banco de dados U-SQL.

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

   

Próximas etapas

• 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 seu computador local