Editing data transformations

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 costuma ser muito mais rápido do que Aplicar a painéis, o que inicia uma executação completa de dados.

Observação:

Executar tudo 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 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. 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 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. Clique no 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.

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.