Pular para o conteúdo principal

Primeiros passos com o Conversor DDF

Siga estes 5 passos para converter seu fluxo Tableau Prep ou job DataStage em SQL validado.

Passo 1: envie seu fluxo ou job​

Envie seu fluxo Tableau Prep ou job IBM DataStage para o sistema.

  • Clique no botão Enviar na página de fluxos de trabalho
  • Selecione seu arquivo (máximo de 100 MB)
    • Tableau Prep: arquivos .tfl ou .zip
    • DataStage: arquivos .dsx
  • O sistema fará a leitura e análise do arquivo
  • Você verá os detalhes do fluxo de trabalho e as saídas disponíveis

O que acontece a seguir: O sistema extrai a estrutura do fluxo de trabalho, identifica todos os nós e prepara as opções de conversão.

Passo 2: crie uma sessão de conversão​

Selecione um nó de saída e inicialize a conversão para esse destino específico.

  • Escolha qual nó de saída converter
  • Configure os mapeamentos de entrada, se necessário
    • Referências a tabelas Excel (Tableau Prep)
    • Conjuntos de dados DataStage
  • Revise a quantidade de estágios e a ordem de execução
  • Clique em Iniciar sessão para começar a conversão

O que acontece a seguir: O sistema cria uma sessão direcionada à saída selecionada e se prepara para gerar SQL estágio por estágio.

Dica: Se o fluxo de trabalho tiver múltiplas saídas, crie uma sessão separada para cada uma.

Passo 3: processe os estágios sequencialmente​

O sistema orienta você pelos estágios, bloqueando automaticamente o trabalho posterior até que as dependências anteriores estejam concluídas.

Para cada estágio:​

  1. Comece pelo primeiro estágio (geralmente a entrada)
  2. Gere o SQL de cada estágio (com IA ou manualmente)
  3. Use os 6 painéis de validação para revisar seu trabalho:
    • SQL gerado
    • Configuração do nó
    • Consulta intermediária
    • Esquema
    • Histórico de feedback
    • Conversa com LLM (futuro)
  4. Aprove, edite ou solicite alterações
  5. Avance para o próximo estágio (estágios bloqueados são desbloqueados automaticamente)

Fluxo de validação:​

For each stage:
├─ Review Generated SQL
├─ Check Node Configuration
├─ Test Intermediate Query
├─ Verify Schema
├─ Check Feedback History
└─ Approve or Request Changes

Conceito principal: Estágios posteriores permanecem bloqueados até que você aprove os anteriores. Isso garante a consistência do fluxo de dados.

Passo 4: use operações em lote (opcional)​

Acelere a conversão com operações de geração e redefinição em lote.

Geração em lote:​

  • Gere múltiplos estágios elegíveis de uma só vez
  • Apenas estágios com dependências atendidas serão efetivamente gerados
  • Economiza tempo em fluxos de trabalho grandes

Redefinição em lote:​

  • Redefina múltiplos estágios para o status pendente
  • Útil quando você precisa revisar múltiplos estágios
  • As regras de dependência se aplicam automaticamente

Dica: Use operações em lote após editar o SQL para gerar novamente todos os estágios dependentes de uma só vez.

Passo 5: exporte seu SQL​

Quando todos os estágios estiverem validados, exporte seu script SQL completo para uso no data warehouse.

  • Revise o estágio final com todas as CTEs anteriores
  • Exporte o script SQL completo
  • Use no seu data warehouse
  • Mantenha seu SQL em controle de versão junto com seus fluxos de trabalho

O que você receberá: Um único arquivo SQL contendo todas as expressões de tabela comuns (CTEs) e a instrução SELECT final, pronto para uso em produção.

Conceitos principais​

📊 Fluxos de trabalho​

Seus fluxos Tableau ou jobs DataStage enviados. Cada fluxo de trabalho pode ter múltiplas versões, que você pode atualizar sem perder o histórico de conversão.

🎯 Sessões​

Uma sessão de conversão tem como destino um nó de saída específico. Se o fluxo de trabalho tiver 3 nós de saída, crie 3 sessões para gerar SQL para cada saída.

📋 Estágios​

Cada nó do seu fluxo se torna um estágio. Você valida e aprova o SQL de cada estágio individualmente. Os estágios são processados sequencialmente, com gerenciamento de dependências.

🔗 Dependências​

Estágios posteriores são bloqueados automaticamente até que suas dependências anteriores sejam geradas e validadas. Isso evita consultas inválidas e garante a consistência dos dados.

Dicas​

💬 Use o painel de consulta intermediária​

A consulta intermediária mostra seu SQL completo até o estágio atual. Teste-o no seu banco de dados para validar o fluxo de dados e identificar problemas antecipadamente.

🔄 Use operações em lote para maior eficiência​

Gere múltiplos estágios de uma só vez, mas lembre-se de que apenas estágios elegíveis (com dependências atendidas) serão efetivamente gerados. Estágios não elegíveis são ignorados automaticamente.

✏️ Não hesite em editar o SQL​

O SQL gerado por IA é um ponto de partida. Edite livremente para atender aos seus requisitos. Suas edições são preservadas e não serão sobrescritas em gerações posteriores.

📊 Verifique o painel de esquema para os estágios posteriores​

Os nomes de colunas no esquema são essenciais. Estágios posteriores referenciarão esses nomes exatos nas transformações. Confira-os com atenção!

📝 Revise a configuração do nó​

Entender a configuração do nó original ajuda a validar o SQL gerado. Ela mostra entradas, parâmetros e configurações do seu fluxo original.

Próximos passos​