Visualizar e gerenciar informações de projetos dbt existentes

Este tópico aborda como explorar a estrutura e os metadados de um objeto de projeto dbt existente. Isso inclui visualizar o DAG do projeto, inspecionar detalhes do modelo e da fonte e executar projetos dbt.

Navegar pelo DAG do projeto para ver a linhagem e as dependências do modelo

O gráfico acíclico direcionado (DAG) mostra como os modelos dbt dependem uns dos outros, visualizando a linhagem de dados para que você possa:

  • Verificar onde um modelo é criado (database.schema), como ele se materializa e quais dependências upstream e downstream ele tem.

  • Identificar e aprimorar designs de modelo ineficientes para oferecer melhor desempenho e escalabilidade.

Para procurar o projetoDAG no Snowsight, navegue até Databases » seu banco de dados » seu esquema » dbt Projects e selecione seu projeto. A página de detalhes do projeto exibe o Graph de seus modelos e relacionamentos, junto com uma Description do projeto, a dbt Project definition e os Privileges.

No Graph, clique em um nó de modelo para inspecionar detalhes de modelo, fonte ou teste (como SQL compilado e configuração) diretamente do DAG.

Dica

Se você trabalha em um espaço de trabalho, também pode acessar a página de detalhes do projeto selecionando Connect » View project no editor de espaço de trabalho. Para obter mais informações, consulte Workspaces for dbt Projects on Snowflake.

Inspecionar detalhes do modelo do DAG

Quando você seleciona um nó de modelo no DAG, a exibição de detalhes do modelo é aberta com:

  • O tipo do modelo, o caminho do arquivo, o objeto de destino, a contagem de linhas e a contagem de colunas.

  • Uma descrição do modelo (se houver uma definida no projeto dbt).

  • Linhagem do modelo, listando as dependências upstream e downstream com links para navegar entre elas.

  • A fonte e o SQL compilado para o modelo.

Executar modelos do DAG

Você pode executar um subconjunto do seu projeto dbt diretamente do DAG selecionando o menu … em um nó de modelo. As seguintes opções de execução estão disponíveis:

Opção de menu

O que ela executa

Sinalizador --select equivalente

Execute model

Somente o modelo selecionado

--select model_name

Execute model+

O modelo e todos os dependentes downstream

--select model_name+

Execute +model

O modelo e todos os pais upstream

--select +model_name

Execute +model+

O modelo, os pais e os filhos

--select +model_name+

A seleção de qualquer opção abre a caixa de diálogo Execute dbt project com o campo Additional flags pré-preenchido com o valor --select correspondente. Na caixa de diálogo, você pode:

  • Escolher a operação, como Run, Test ou Build.

  • Escolher o destino do perfil (por exemplo, dev ou prod).

  • Editar os sinalizadores antes da execução, se quiser refinar a seleção.

Você pode usar a mesma sintaxe --select com os operadores gráficos + em SQL e na Snowflake CLI:

EXECUTE DBT PROJECT my_dbt_project
  ARGS = 'build --select +stg_customers+ --target dev';

Para obter mais informações sobre os comandos e sinalizadores dbt compatíveis, consulte Comandos e sinalizadores do dbt permitidos.

Visualizar propriedades do objeto do projeto dbt

Visualize os metadados que o Snowflake armazena sobre um objeto de projeto dbt para ver o nome dele, quem é o proprietário, qual versão é a padrão e onde os arquivos estão localizados na área de preparação snow://dbt/... interna do Snowflake.

Para visualizar as propriedades (como nome, proprietário, comentário) de um projeto dbt específico, use o comando DESCRIBE DBT PROJECT, conforme mostrado no exemplo a seguir:

DESCRIBE DBT PROJECT my_dbt_project;

A saída mostra o nome do objeto, o proprietário, o comentário, os detalhes de controle de versão e a integração de acesso externo. Para obter mais informações, consulte DESCRIBE DBT PROJECT.

Exibir todos os projetos dbt

Use SHOW DBT PROJECTS quando quiser ver todos os objetos do projeto dbt aos quais você pode acessar, além dos principais metadados.

SHOW DBT PROJECTS IN DATABASE mydb;

A saída mostra o banco de dados, o esquema, o proprietário, o comentário, a data de criação e da última atualização, os detalhes de controle de versão e a integração de acesso externo de cada objeto. Para obter mais informações, consulte SHOW DBT PROJECTS.

Como alternativa, use o comando snow dbt list. Para obter mais informações, consulte Listar todos os objetos de projeto dbt disponíveis.