Edição e teste de transformações de dados

Editing transformations

Consulte as páginas listadas abaixo para obter mais informações sobre edição de transformações de dados.

• Structure of transformations
• Designing an event log
• Tips for writing SQL

Execução das consultas

Observação:

Para versões anteriores à 2023.10.7, Executar tudo e Executar arquivo estão limitados a 10 minutos. A partir da 2023.10.7, Executar tudo e Executar arquivo estão limitados a 1 hora. É altamente recomendável usar um pequeno conjunto de dados para o desenvolvimento e testes de transformações de dados, para garantir que suas transformações não excedam esse limite de tempo. Consulte oPortal do Process Mining para obter mais informações sobre o upload de um conjunto de dados de desenvolvimento.

Quando você estiver editando transformações, pode selecionar Executar consultas 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 consultas 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 consultas: 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 consultas costuma ser muito mais rápido do que Aplicar a painéis, o que inicia uma executação completa de dados.

Observação:

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

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	Clique com o botão direito do mouse na 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 renomear uma pasta ou arquivo

Siga estas etapas para criar uma nova pasta ou arquivo.

Etapas	Ação
1	Clique com o botão direito do mouse na 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	Clique com o botão direito do mouse na 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.

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", #}

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 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. 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 você deseja pesquisar no 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. Clique no editor de código.
2. Pressione CTRL+H.
3. Insira o teste que você deseja pesquisar no 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.
   Observação:

   Se você tiver alterações pendentes no editor Transformações de dados, use Aplicar a painéis e exporte as transformações após a conclusão da executação de dados.

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.

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.

Disponibilização das transformações em painéis

Para tornar as alterações disponíveis nos painéis, você deve realizar uma execução de dados completa para carregar os dados e executar as transformações. Selecione o botão Aplicar a painéis para iniciar uma executação de dados.

Observação:

Dependendo do tamanho de seu conjunto de dados, isso levará algum tempo.

Após uma execução de dados bem-sucedida, as novas transformações ficam disponíveis no editor de painéis e podem ser usadas para ajustar os painéis.

Observação:

Se você tiver uma versão publicada do aplicativo de processo, os usuários comerciais verão instantaneamente os novos dados. Se você quiser garantir que seu aplicativo publicado continue sendo executado corretamente ao editar transformações, é altamente recomendável usar um aplicativo de desenvolvimento. Siga estas etapas.

1. Clonar seu aplicativo para criar um aplicativo de desenvolvimento.
2. Edite e teste as transformações.
3. Exporte as transformações do aplicativo de desenvolvimento.
4. Importe as transformações em seu aplicativo de processo publicado.