Introdução ao desenvolvimento em um espaço de trabalho

Neste documento, você verá o conceito de espaços de trabalho no Dataform e os recursos deles.

No Dataform, você interage com o código do fluxo de trabalho SQL em um espaço de trabalho de desenvolvimento. Um espaço de trabalho de desenvolvimento é sua própria cópia editável de um repositório. Em um espaço de trabalho, você cria, edita ou exclui o conteúdo do repositório sem afetar outras pessoas que trabalham no mesmo repositório. Em seguida, confirma e envia suas alterações para o repositório.

É possível desenvolver seu fluxo de trabalho SQL com o Dataform Core ou o JavaScript. O Dataform compila o código em consultas SQL em tempo real.

Em um espaço de trabalho de desenvolvimento, é possível executar as seguintes tarefas:

Componentes de um espaço de trabalho de desenvolvimento

Um espaço de trabalho de desenvolvimento do Dataform tem estas guias:

Código
Contém um ambiente de desenvolvimento em que é possível explorar arquivos, desenvolver consultas, controlar versões e acionar a execução no BigQuery.
Gráfico compilado
Exibe o fluxo de trabalho SQL compilado definido no seu espaço de trabalho como um gráfico acíclico dirigido interativo (DAG). Se houver erros de compilação no fluxo de trabalho SQL, a guia exibirá uma mensagem de erro em vez do gráfico.
Execuções
Exibe registros de todas as execuções acionadas no espaço de trabalho. Também é possível conferir as ações e os detalhes de uma execução selecionada. Para mais informações, consulte Inspecionar registros de execução do espaço de trabalho.

Componentes da guia "Código"

A guia Código de um espaço de trabalho de desenvolvimento contém os seguintes componentes que permitem desenvolver fluxos de trabalho SQL:

Painel de arquivos
Exibe a estrutura de arquivos do seu espaço de trabalho. Salva automaticamente suas edições na estrutura do arquivo. Os arquivos selecionados são abertos em guias no painel de desenvolvimento. No campo Digite para pesquisar, pesquise arquivos ou diretórios no espaço de trabalho pelo caminho deles.
Painel de controle de versões
Exibe o status do controle de versões do espaço de trabalho e as opções de controle de versões.
Painel de desenvolvimento
Exibe os arquivos abertos em guias. As mudanças feitas nos arquivos editados são salvas automaticamente.
Botão "Run"
Executa uma prévia da consulta SQL compilada.
Botão "Formatar"
Formata seu código principal do Dataform ou JavaScript.
Status da compilação
Exibe o status de compilação do código no espaço de trabalho.
Painel de metadados
Exibe os metadados do arquivo editado no momento.
Painel de consultas compiladas
Compila as consultas no arquivo atualmente editado para SQL. Se a compilação da consulta falhar, exibe os erros de compilação. Se a compilação da consulta for bem-sucedida, exibe as consultas compiladas e as valida por meio de simulações no BigQuery. Se a validação da consulta falhar, exibe os erros de validação. Se a validação da consulta for bem-sucedida, mostra quantos bytes a execução das consultas ao BigQuery usaria.
Menu suspenso "Iniciar execução"
Exibe opções para acionar a execução de todo o fluxo de trabalho no espaço de trabalho ou dos elementos selecionados.

Componentes da guia do gráfico compilado

A guia "Gráfico compilado" exibe um gráfico interativo do fluxo de trabalho SQL compilado. O gráfico mostra todas as ações no fluxo de trabalho SQL e as relações entre elas.

É possível aumentar e diminuir o zoom e usar o recurso de arrastar para navegar no gráfico.

É possível filtrar o gráfico pelas seguintes propriedades:

  • Nome
  • Tag
  • Tipo
    • Declaração
    • Declaração
    • Tabela incremental
    • Visualização materializada
    • Operações
    • Tabela
    • Desconhecido
    • View

É possível selecionar vários filtros de uma só vez. O Dataform vai aplicá-las com a condição OR.

É possível clicar em uma ação no gráfico para ver os detalhes nos seguintes painéis:

Painel de metadados
Exibe o nome completo, o tipo, as dependências e os dependentes da ação selecionada.
Painel de consulta
Exibe a consulta SQL compilada da ação selecionada.

Controle de versões em um espaço de trabalho

Em um espaço de trabalho, você interage com o repositório por meio do controle de versão baseado em Git. As edições feitas nos arquivos no espaço de trabalho começam como alterações locais não confirmadas que você pode confirmar e, em seguida, as enviam ao seu repositório para que fiquem disponíveis a todos os usuários do repositório.

Se o repositório estiver conectado a um provedor Git remoto, você enviará as alterações do espaço de trabalho para a ramificação de desenvolvimento principal. Você seleciona a ramificação principal ao conectar seu repositório ao provedor Git remoto. Em um repositório do Dataform não conectado, você envia as alterações para a ramificação padrão.

Também é possível extrair as alterações do repositório do Dataform ou do repositório remoto e mesclá-las com as alterações locais no espaço de trabalho de desenvolvimento. Para mais informações sobre o controle de versões no Dataform, consulte Controle de versões do código.

A seguir