Integrar dados do Azure Data Lake Storage Gen2

Este artigo descreve como integrar dados a um novo workspace do Azure Databricks do Azure Data Lake Storage Gen2. Você aprenderá a acessar dados de origem com segurança em um local de armazenamento de objetos de nuvem que corresponde a um volume do Catálogo do Unity (recomendado) ou a um local externo do Catálogo do Unity. Em seguida, você aprenderá a ingerir os dados incrementalmente em uma tabela gerenciada do Catálogo do Unity usando o Carregador Automático com Tabelas Dinâmicas Delta.

Observação

Para integrar dados no Databricks SQL em vez de em um notebook, confira Carregar dados usando tabelas de streaming no Databricks SQL.

Antes de começar

Se você não for um administrador, este artigo pressupõe que um administrador forneceu o seguinte:

  • Acesso a um workspace do Azure Databricks com o Catálogo do Unity habilitado. Para obter mais informações, confira Configurar e gerenciar o Catálogo do Unity.

  • A permissão READ FILES no volume externo do Catálogo do Unity ou no local externo do Catálogo do Unity que corresponde ao local de armazenamento em nuvem que contém seus dados de origem. Para obter mais informações, veja Criar um local externo para conectar o armazenamento em nuvem ao Azure Databricks.

  • O caminho para os dados de origem.

    Exemplo de caminho de volume: /Volumes/<catalog>/<schema>/<volume>/<path>/<folder>

    Exemplo de caminho de local externo: abfss://<container>@<storage-account>.dfs.core.windows.net/<folder>

  • O USE SCHEMA e CREATE TABLE os privilégios no esquema em que você deseja carregar dados.

  • Permissão de criação de cluster ou acesso a uma política de cluster que define um cluster de pipeline do Delta Live Tables (campo cluster_type definido como dlt).

    Se o caminho para os dados de origem for um caminho de volume, o cluster deverá executar o Databricks Runtime 13.3 LTS ou versões superiores.

Importante

Se você tiver dúvidas sobre esses pré-requisitos, entre em contato com o administrador da conta.

Etapa 1: criar um cluster

Para criar um cluster, faça o seguinte:

  1. Entre no workspace do Azure Databricks.
  2. Na barra lateral, clique em Novo>Cluster.
  3. Na interface do usuário dos clusters, especifique um nome exclusivo para o cluster.
  4. Se o caminho para os dados de origem for um caminho de volume, para a versão de runtime do Databricks Runtime, selecione 13.2 ou superior.
  5. Clique em Criar cluster.

Etapa 2: criar um notebook de exploração de dados

Esta seção descreve como criar um notebook de exploração de dados para que você possa entender seus dados antes de criar seu pipeline de dados.

  1. Na barra lateral, clique em +Novo>Notebook.

    O notebook é anexado automaticamente ao último cluster usado (nesse caso, o cluster que você criou na Etapa 1: criar um cluster).

  2. Insira um nome para o notebook.

  3. Clique no botão de idioma e selecione Python ou SQL no menu suspenso. Python é selecionado por padrão.

  4. Para confirmar o acesso aos dados de origem no ADLS Gen2, cole o código a seguir em uma célula do notebook, clique em Menu Executar e clique em Executar célula.

    SQL

    LIST '<path-to-source-data>'
    

    Python

    %fs ls '<path-to-source-data>'
    

    Substitua <path-to-source-data> pelo caminho para o diretório que contém seus dados.

    Isso exibe o conteúdo do diretório que contém o conjunto de dados.

  5. Para exibir um exemplo dos registros para entender melhor o conteúdo e o formato de cada registro, cole o seguinte em uma célula do notebook, clique em Menu Executar e clique em Executar célula.

    SQL

    SELECT * from read_files('<path-to-source-data>', format => '<file-format>') LIMIT 10
    

    Python

    spark.read.format('<file-format>').load('<path-to-source-data>').limit(10).display()
    

    Substitua os seguintes valores:

    • <file-format>: um formato de arquivo com suporte. Confira Opções de formato de arquivo.
    • <path to source data>: o caminho para um arquivo no diretório que contém seus dados.

    Isso exibe os dez primeiros registros do arquivo especificado.

Etapa 3: ingerir dados brutos

Para ingerir dados brutos, faça o seguinte:

  1. Na barra lateral, clique em Novo>Notebook.

    O notebook é anexado automaticamente ao último cluster usado (nesse caso, o cluster criado anteriormente neste artigo).

  2. Insira um nome para o notebook.

  3. Clique no botão de idioma e selecione Python ou SQL no menu suspenso. Python é selecionado por padrão.

  4. Insira o código a seguir em uma célula do bloco de anotações:

    SQL

    CREATE OR REFRESH STREAMING TABLE
      <table-name>
    AS SELECT
      *
    FROM
      STREAM read_files(
        '<path-to-source-data>',
        format => '<file-format>'
      )
    

    Python

    @dlt.table(table_properties={'quality': 'bronze'})
    def <table-name>():
      return (
         spark.readStream.format('cloudFiles')
         .option('cloudFiles.format', '<file-format>')
         .load(f'{<path-to-source-data>}')
     )
    

    Substitua os seguintes valores:

    • <table-name>: um nome para a tabela que conterá os registros ingeridos.
    • <path-to-source-data>: o caminho para os dados de origem.
    • <file-format>: um formato de arquivo com suporte. Confira Opções de formato de arquivo.

Observação

O Delta Live Tables não foi projetado para ser executado interativamente em células de notebook. Executar uma célula que contém a sintaxe Delta Live Tables em um notebook retorna uma mensagem sobre se a consulta é sintaticamente válida, mas não executa a lógica de consulta. A etapa a seguir descreve como criar um pipeline com base no notebook de ingestão que você acabou de criar.

Etapa 4: criar e publicar um pipeline

Para criar um pipeline e publicá-lo no Catálogo do Unity, faça o seguinte:

  1. Na barra lateral, clique em Fluxos de trabalho, clique na guia Tabelas Dinâmicas Delta e clique em Criar pipeline.
  2. Insira um nome para seu pipeline.
  3. Para o Modo de pipeline, selecione Com gatilho.
  4. Para o código-fonte, selecione o notebook que contém o código-fonte do pipeline.
  5. Para Destino, selecione Catálogo do Unity.
  6. Para garantir que sua tabela seja gerenciada pelo Catálogo do Unity e qualquer usuário com acesso ao esquema pai possa consultá-la, selecione um catálogo e um esquema de destino nas listas suspensas.
  7. Se você não tiver permissão de criação de cluster, selecione uma política de cluster que dê suporte a Tabelas Dinâmicas Delta na lista suspensa.
  8. Para Avançado, defina o Canal como Visualização.
  9. Aceite todos os outros valores padrão e clique em Criar.

Etapa 5: Agendamento do pipeline

Para agendar o pipeline, faça o seguinte:

  1. Na barra lateral, clique em Tabelas Dinâmicas Delta.
  2. Clique no nome do pipeline que você deseja agendar.
  3. Clique em Agendar>Adicionar um agendamento.
  4. Em Nome do trabalho, insira um nome para o trabalho.
  5. Defina o Agendamento como Agendado.
  6. Especifique o período, a hora de início e o fuso horário.
  7. Configure um ou mais endereços de email para receber alertas sobre início, êxito ou falha de pipeline.
  8. Clique em Criar.

Próximas etapas