Tutorial: Praticar com um projeto dbt de exemplo no Microsoft Fabric (versão prévia)

O trabalho dbt no Fabric permite executar transformações de dbt sem configuração complexa. Você pode orquestrar compilações de modelos, testes e implantações diretamente no Fabric usando funcionalidades integradas para agendamento e monitoramento. Este tutorial orienta você a trabalhar com um projeto de exemplo para aprender as funcionalidades de trabalho do dbt.

Neste tutorial, você:

  • Criar uma tarefa dbt com um projeto de exemplo
  • Executar transformações de dbt
  • Monitorar e verificar os resultados

Se você não tiver uma assinatura do Fabric, crie uma conta de avaliação gratuita.

Pré-requisitos

Antes de começar este tutorial, você precisa:

  • Acesso a um workspace do Fabric
  • Permissões para criar itens na área de trabalho
  • Familiaridade básica com conceitos de dbt (modelos, testes e transformações)

Criar uma tarefa dbt com um projeto de exemplo

Crie um novo item de trabalho dbt em seu workspace usando arquivos de projeto de exemplo.

  1. Acesse seu espaço de trabalho do Fabric.

  2. Selecione +Novo item e, em seguida, pesquise e selecione dbt job no menu de criação do item.

  3. Insira um nome, selecione um local e selecione Criar.

    Captura de tela da caixa de diálogo criar trabalho na interface do usuário do Fabric.

  4. Você verá três opções para iniciar um projeto dbt. Selecione Prática com Projeto de Exemplo para explorar e trabalhar com um exemplo predefinido.

    Captura de tela mostrando três opções para iniciar um projeto dbt.

  5. Selecione o projeto de exemplo do Jaffle Shop, que permite trabalhar com dados que incluem pedidos, pagamentos e conjuntos de dados do cliente.

    Captura de tela mostrando a opção de projeto de exemplo do Jaffle Shop.

  6. Selecione Selecionar um perfil para selecionar um perfil de adaptador para executar seu projeto dbt.

    Captura de tela mostrando a seleção de perfil para o projeto jaffle Shop.

  7. Crie um novo warehouse para armazenar seus dados de exemplo selecionando a opção Warehouse .

    Captura de tela mostrando a seleção de armazéns do Fabric.

  8. Insira um nome para o warehouse e selecione Criar e conectar.

    Captura de tela mostrando a caixa de diálogo de nomeação do armazém.

  9. Por padrão, o esquema é definido como jaffle_shop, e a opção para semear dados está selecionada. Essa opção carrega dados de exemplo no esquema dentro do armazém que você criou. Selecione Conectar.

    Captura de tela mostrando o esquema e opções de dados de semente da Jaffle Shop.

  10. A instalação do projeto é concluída em alguns minutos, pois os arquivos são importados. Depois de concluir, verifique se os dados de exemplo foram propagados selecionando o botão Abrir Warehouse na parte de cima da página e verificando o armazém e o esquema. Você também pode confirmar os dados de exemplo no painel de saída na parte inferior da tela.

    Captura de tela mostrando a importação bem-sucedida do projeto Jaffle Shop e dos dados iniciais.

Executar o trabalho de dbt

Execute as transformações de dbt para criar modelos, executar testes e criar instantâneos.

  1. O painel superior fornece opções para Criar, Compilar ou Executar seu projeto. Por padrão, a operação é definida como Build, que executa todos os modelos, testes e instantâneos juntos para um fluxo de trabalho completo.

  2. Selecione Compilar e, em seguida, selecione Executar.

    Captura de tela mostrando o comando Build e os botões Executar comando.

  3. (Opcional) Execute ou exclua modelos específicos usando seletores avançados. Vá para Configurações Avançadas no painel superior, selecione Executar Configurações e, em seguida, selecione Executar com Seletores Avançados.

    dbt run --select my_model
    dbt build --select staging.*
    dbt build --exclude deprecated_models
    

    Os seletores permitem que você direcione partes do pipeline para iteração mais rápida durante o desenvolvimento ou teste.

    Captura de tela mostrando a opção seletores avançados.

Monitorar e verificar os resultados

Examine os resultados da execução e verifique se as transformações foram concluídas com êxito.

  1. Depois que o trabalho dbt for iniciado, monitore seu progresso na guia Saída na parte inferior da tela. O processo de execução normalmente é concluído em alguns minutos.

  2. Confirme uma execução bem-sucedida verificando a guia Saída . O status é mostrado como bem-sucedido quando a execução é concluída com êxito.

    Captura de tela mostrando uma execução de comando de build bem-sucedida.

  3. Verifique a saída verificando os dados transformados no Fabric Warehouse. Selecione o botão Abrir Warehouse na parte superior da página de trabalho do dbt e, em seguida, examine o esquema sample_dbt_project → jaffle_shop.

    Captura de tela mostrando os dados transformados no armazém do Fabric.

  4. Abra a guia SQL compilado na parte inferior da página de trabalho dbt para examinar o código SQL renderizado que o dbt executou. Essa guia ajuda você a depurar problemas ou otimizar consultas.

    Captura de tela mostrando o SQL compilado no painel inferior.

  5. Abra o modo de exibição Linhagem para visualizar o grafo de dependência de seus modelos. Essa exibição mostra como os dados fluem entre fontes e transformações, ajudando você a entender relações, avaliar o impacto downstream e solucionar problemas.

    Captura de tela que mostra a visão de linhagem no painel inferior.

Limpar os recursos

Ao concluir o tutorial, exclua o trabalho dbt e o warehouse para evitar custos extras.

  1. Abra o workspace do Fabric no qual você criou o trabalho dbt.

  2. Passe o mouse sobre o trabalho dbt que você criou, selecione as reticências Mais opções (...) e selecione Excluir.

    Captura de tela mostrando o menu

  3. Para excluir o armazém, pesquise o armazém no espaço de trabalho em que você criou sua tarefa de dbt. Passe o mouse sobre o armazém que você criou, em seguida selecione as reticências Mais opções (...) e selecione Excluir.

    Captura de tela mostrando o menu de mais opções para excluir o armazém da sua área de trabalho.