09. Erros e recuperação de Dataflow Gen2

Um Dataflow pode falhar antes de ler a primeira linha, durante uma conversão ou ao validar o destino. Recuperar exige identificar essa fase e compreender o que já foi persistido. Aumentar recursos ou repetir o refresh sem essa distinção pode manter a falha e ampliar seus efeitos.

Definição, publicação e destino

Validações podem ocorrer na publicação e no início da atualização. Uma configuração inválida pode impedir o processamento antes de qualquer transformação. Confira consultas de saída, esquema, tipos e regras do destino. Na experiência padrão, cada consulta de saída admite um destino; distribuir resultados pode exigir consultas separadas.

Uma lista ou outro valor não tabular pode precisar ser convertido em tabela antes de configurar o destino. Mudanças de esquema também podem invalidar mapeamentos. Não assuma que publicar a consulta no editor demonstra que o contrato completo de destino foi atendido.

Um destino por consulta de saída não impede que o mesmo Dataflow contenha saídas distintas, mas exige expressar a distribuição pelo desenho suportado. Antes de duplicar consultas, avalie dependências e custo de recomputação. A configuração precisa produzir estruturas tabulares compatíveis e mapeamentos válidos. Se a validação falha antes da execução, aumentar timeout ou capacidade não altera o contrato. Corrija a definição e confirme sua publicação antes de investigar o desempenho de uma transformação que ainda não começou.

Erros específicos de destino

DestinationQueryNotFound indica verificar a definição interna de navegação do destino; a tabela física existir não reconstitui essa consulta. MultipleDestinationQueries pede examinar a multiplicidade de configurações. DestinationQueryHasUnsupportedScript orienta a validar o retorno e o script, por exemplo uma lista onde se exige uma estrutura suportada. DestinationTransformQueryNotFound aponta para a transformação de destino ausente. DestinationQueryChallenge pode exigir corrigir autenticação da conexão. Leia a mensagem completa de DestinationQueryException para identificar a causa, sem transformar todos esses códigos em um problema da fonte.

Folding, staging e execução