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 será aberta no editor 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. Você pode abrir um arquivo em uma guia fixada, o que permite que você acesse rapidamente os arquivos sem precisar 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

Observação:

Executar tudo e Executar arquivo estão limitados a uma hora. Portanto, é altamente recomendável usar um pequeno conjunto de dados para o desenvolvimento e teste de 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 todas 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 usa 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:

  Você pode selecionar Cancelar execução a qualquer momento para cancelar a execução das 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 a 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 o Mais ações para a pasta nas transformações em que 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 da 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 o 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 o Mais ações da pasta ou arquivo que você 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 o Mais ações para o arquivo que você deseja duplicar para abrir o menu de contexto.
2	Selecione Duplicar. O arquivo duplicado é inserido no mesmo local do 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 o Mais ações para o arquivo que você deseja copiar para abrir o menu.
2	Selecione Copiar.
3	Abra o 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. Selecione um lugar aleatório no editor de código ou selecione o texto que você quer pesquisar para outras ocorrências.
2. Pressione CTRL+F.
3. Digite o texto que deseja pesquisar no campo Localizar. Todas as ocorrências do texto no arquivo atual são destacadas.
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. Selecione um lugar aleatório no editor de código ou selecione o texto que você quer pesquisar para outras ocorrências.
2. Pressione CTRL+H.
3. Insira o texto que você deseja pesquisar para o campo Localizar e insira o novo teste no campo Substituir. Todas as ocorrências do texto no arquivo atual são destacadas.
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. Selecione o editor de código.
2. Pressione CTRL+H.
3. Insira o texto que você deseja pesquisar para o campo Localizar e insira o novo teste no campo Substituir. Todas as ocorrências do texto no arquivo atual são destacadas.
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 você for perguntado quais dados usar para uma execução de dados, selecione Cancelar se você quiser continuar editando transformações antes de fazer uma nova execuçã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.