Editing data transformations

Visualizando e editando arquivos

Os arquivos SQL e de entrada são exibidos em guias. Ao abrir um arquivo SQL ou um arquivo de entrada, uma nova guia é aberta no editor de Transformações de dados. Isso permite que você abra e trabalhe com vários arquivos simultaneamente. Se houver alterações não salvas em um arquivo SQL, isso é indicado com um ponto azul na aba.

Dica:

Você pode abrir um arquivo em uma guia fixada. Isso permite que você acesse rapidamente os arquivos sem ter que reabri-los repetidamente. Depois que um arquivo é fixado, ele permanece visível no editor mesmo quando você abre outros arquivos.

Você pode clicar duas vezes no arquivo ou selecionar Fixar no menu de contexto da guia para fixar uma guia.

Observação: se houver alterações não salvas no arquivo SQL aberto atualmente, essas alterações permanecerão em sua própria guia quando o novo arquivo for aberto. Quando não houver alterações não salvas, o novo arquivo SQL será aberto na guia exibida atualmente.

Fechando arquivos

Você pode fechar rapidamente a guia atual, todas as guias ou todas as outras guias do menu de contexto de guias.

Clique com o botão direito do mouse em um nome de guia para abrir o menu de contexto de guias.

Execução das consultas

Atenção:

As atividades Executar tudo e Executar arquivo são limitadas a uma hora. Portanto, é altamente recomendável usar um pequeno conjunto de dados para o desenvolvimento e teste das transformações de dados, para garantir que suas transformações não excedam esse limite de tempo. Consulte o Portal do Process Mining para obter mais informações.

Quando você estiver editando transformações, pode selecionar Executar todos para testar suas alterações e acessar uma visualização. Isso executa as consultas que foram modificadas e todas as consultas relacionadas. Por exemplo, se cases_input.sql foi modificado. O comando Executar tudo executaria cases_input.sql e cases.sql, que utilizam os resultados de cases_input.sql.

Os dados resultantes só estarão disponíveis no editor Transformações de dados, não no editor do painel.

Há dois tipos de execuções:

• Executar todas: inicia uma execução de dados, recalculando todas as consultas modificadas e suas dependências.

• Executar arquivo: inicia uma execução para recalcular apenas o arquivo SQL atualmente selecionado e suas consultas pai. Essa opção permite testar e depurar personalizações para arquivos SQL específicos.

Dica:

É possível selecionar Cancelar execução a qualquer momento para cancelar a execução de transformações.

Os resultados são exibidos no painel Visualização.

Observação:

Executar tudo não afeta os dados no aplicativo de processo publicado.

Visualização do SQL compilado

Você pode visualizar uma versão compilada do código SQL após executar as consultas habilitando a opção de alternância SQL compilado . Isso é útil ao depurar erros de SQL, pois os números de linha relatados correspondem aos números de linha no SQL compilado.

Observação:

Apenas arquivos SQL que acabaram de ser executados mostrarão o botão de alternância SQL compilado .

Adicionando pastas e arquivos

Você pode criar novas pastas e adicionar novos arquivos em suas transformações.

Convenções de Nomes

• Para nomes de arquivos, pastas, campos e tabelas:

  • você só pode usar caracteres minúsculos (az), caracteres maiúsculos (AZ) e números (0-9);

  • você não pode usar caracteres especiais |*:?"<>\/ para nomes de arquivos, pastas, campos e tabelas.
• Para nomes de arquivos, você só pode usar _:. como caracteres especiais.
• O nome de um arquivo não pode começar com _ (underscore).

Criando uma nova pasta ou arquivo a partir do menu de transformações

Siga estas etapas para criar uma nova pasta ou arquivo.

Etapas	Ação
1	Navegue até o local nas transformações onde você deseja adicionar um novo arquivo ou pasta.
2	Acesse o painel Transformações e selecione o ícone para abrir o menu de transformações.
3	Selecione a opção aplicável no menu.
4	Insira um nome descritivo para a nova pasta ou arquivo e selecione Enter.

A nova pasta ou arquivo é criado na pasta selecionada.

Criar uma nova pasta ou arquivo a partir do menu de contexto

Siga estas etapas para criar uma nova pasta ou arquivo a partir do menu de contexto.

Etapas	Ação
1	Abra Mais ações para a pasta nas transformações onde você deseja adicionar um novo arquivo ou pasta.
2	Selecione a opção aplicável no menu.
3	Insira um nome descritivo para a nova pasta ou arquivo e selecione Enter.

A nova pasta ou arquivo é criado na pasta selecionada.

Alterações não salvas em arquivos

Ao editar um arquivo .sql , um ponto azul indica na estrutura de pasta Transformações que há alterações não salvas.

Como mover arquivos

Você pode arrastar e soltar arquivos com facilidade para movê-los para uma pasta diferente ou reordená-los dentro de uma pasta. Uma mensagem de confirmação é exibida para ajudar a evitar migrações acidentais do arquivo.

Como renomear uma pasta ou arquivo

Siga estas etapas para criar uma nova pasta ou arquivo.

Etapas	Ação
1	Abra Mais ações da pasta ou arquivo que deseja renomear para abrir o menu de contexto.
2	Selecione Renomear.
3	Edite o nome como desejar e selecione Enter.

A pasta ou arquivo é renomeado.

Como excluir uma pasta ou arquivo

Siga estas etapas para criar uma nova pasta ou arquivo.

Etapas	Ação
1	Abra Mais ações da pasta ou arquivo que deseja excluir para abrir o menu de contexto.
2	Selecione Excluir. Uma mensagem de confirmação é exibida.
3	Selecione Excluir para confirmar a exclusão.

A pasta ou arquivo foi excluído.

Duplicação de um arquivo

A duplicação de um arquivo SQL permite que você reutilize suas consultas e faça modificações sem a necessidade de criar um arquivo completamente novo. Também pode ajudar você a fazer modificações em suas consultas sem alterar ou danificar as consultas originais.

A duplicação de um arquivo cria uma cópia do arquivo original na mesma pasta diretamente abaixo do arquivo duplicado.

Siga estas etapas para duplicar um arquivo SQL.

Etapas	Ação
1	Abra Mais ações do arquivo que você deseja duplicar para abrir o menu de contexto.
2	Selecione Duplicar. O arquivo duplicado é inserido no mesmo local que o arquivo original.

Copiar e colar um arquivo

Você pode copiar um arquivo SQL e colá-lo em um local diferente. Copiar e colar um arquivo SQL permite que você reutilize suas consultas e faça modificações nas suas consultas sem a necessidade de criar um arquivo completamente novo.

Siga estas etapas para copiar e colar um arquivo SQL.

Etapas	Ação
1	Abra Mais ações do arquivo que você deseja copiar para abrir o menu.
2	Selecione Copiar.
3	Abra Mais ações selecione Colar no menu. O arquivo copiado é inserido.
4	Arraste e solte o arquivo para movê-lo para o local desejado.

Localizar/substituir em arquivos

No editor Transformações de dados , você pode localizar e substituir textos dentro de um único arquivo.

Find Text

Para encontrar um texto no editor de transformação de dados:

1. Clique em um local aleatório no editor de código ou selecione o texto no qual deseja pesquisar outras ocorrências.

2. Pressione CTRL+F.

3. Digite o teste que você deseja pesquisar no campo Encontrar.

   Todas as ocorrências do texto no arquivo atual são realçadas.

4. Selecione ENTER para pular para a próxima ocorrência.

Localizar e substituir

Para encontrar um texto no editor de transformação de dados:

1. Clique em um local aleatório no editor de código ou selecione o texto no qual deseja pesquisar outras ocorrências.

2. Pressione CTRL+H.

3. Insira o teste que deseja pesquisar no campo Localizar e insira o novo teste no campo Substituir.

   Todas as ocorrências do texto no arquivo atual são realçadas.

4. Selecione ENTER para substituir o texto e pular para a próxima ocorrência.

Para encontrar um texto no editor de transformação de dados:

1. Clique no editor de código.

2. Pressione CTRL+H.

3. Insira o teste que deseja pesquisar no campo Localizar e insira o novo teste no campo Substituir.

   Todas as ocorrências do texto no arquivo atual são realçadas.

4. Pressione Crtl+Alt+Enter.

Dica:

Você também pode usar os ícones Substituir ou Substituir todos.

Localizar/substituir em vários arquivos

Se você quiser Localizar/substituir textos em vários arquivos, você só pode fazer isso em um editor externo.

Siga estas etapas para localizar/substituir textos em vários arquivos:

1. Exporte transformações a partir de seu aplicativo de processo.

2. Descompacte as transformações.

3. Abra as transformações em seu editor de código de preferência, por exemplo, Notepad++ ou Visual Studio Code.

4. Use a funcionalidade dessas ferramentas para localizar ou substituir textos em vários arquivos.

5. Salve os arquivos.

6. Adicione os arquivos de transformação a um arquivo .zip arquivo .xaml.

7. Importe as transformações para seu app de processo.

Observação:

Quando lhe for perguntado quais dados usar para uma execução de dados, selecione Cancelar se quiser continuar editando transformações antes de fazer uma nova executação de dados.

Adição de comentários em arquivos

Se você quiser incluir comentários em seus arquivos de transformações do SQL ou comentar partes do arquivo, é altamente recomendável usar a sintaxe de comentários do Jinja, que é por padrão definida como {# ... #}. Isso também permite que você comente macros.

Sql

{# {{ pm_utils.optional(ref('Cases_base'), '"Case_status"') }} as "Case_status", #}

{# case
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 1000000 
      then {{ pm_utils.as_varchar('>= 1M') }}
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 0 
     then {{ pm_utils.as_varchar('0 - 1M') }}
   when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} is not null
     then {{ pm_utils.as_varchar('< 0') }}
  end as "Case_value_group", #}

Edição de arquivos de configuração de projeto dbt

Você também pode abrir arquivos dbt de configuração de projeto no editor Transformações de dados, por exemplo dbt_project.yml.

AVISO:

É altamente recomendável editar apenas a seção vars, se necessário. As outras partes de dbt_project.yml não devem ser alteradas para garantir que as transformações continuem funcionando corretamente.

Para obter informações detalhadas sobre dbt, consulte a documentação oficial do dbt.