Erros durante o processo de carga de dados podem ocorrer por diversos motivos. Contudo, é importante destacar que, na maioria dos casos, a identificação e correção desses erros pode ser feita de forma rápida e direta, já que geralmente estão relacionados a ações do próprio cliente — como alterações na estrutura do banco de dados ou registros incorretos (ex: vendas com dados inconsistentes).
Quando o erro ocorre
Se a carga de dados é executada e retorna um erro, é possível verificar que o BIMachine executou os processos normalmente até o ponto em que a falha foi identificada. Nesses casos, o erro costuma estar na origem dos dados, e não na plataforma.
Por outro lado, se o erro ocorre já na tentativa de conexão com a base de dados, é possível que seu sistema não está conseguindo se comunicar com o BIMachine. Saiba mais sobre como se conectar com o BIMachine.
Como identificar e corrigir erros de carga
Siga os passos abaixo para identificar e corrigir problemas de carga de dados:
- Identifique a estrutura que apresentou erro.
2. Verifique os logs da carga de dados.
3. Abra o log de erros e observe até qual etapa o processo foi executado antes da falha. Isso ajuda a entender se o erro ocorreu durante a extração, transformação ou carregamento dos dados.
4. Exemplo de erro comum: O log aponta que o arquivo CSV carregado possui menos colunas do que o arquivo anterior.
5. Solução: edite o arquivo CSV e adicione as colunas ausentes. Caso não saiba quais colunas estão faltando, edite a estrutura e verifique o campo “Origem” na etapa 4, onde a estrutura esperada estará disponível.
Esses passos geralmente são suficientes para identificar e resolver a maioria dos erros, sem a necessidade de acionar a equipe técnica.
Outras Situações e Correções
1. Tempo limite excedido na carga de dados
Se a carga atingir o tempo limite (1 hora para carga total e 30 minutos para carga incremental), a plataforma encerrará automaticamente a execução para evitar sobrecarga e filas.
Solução:
- Execute uma carga apenas de um período específico utilizando um filtro no SQL;
- Em seguida, crie cargas incrementais para atualizar os períodos restantes.
2. Erro de conversão de data
Em casos de erro de conversão de datas durante a extração, o log indicará exatamente qual campo ou valor causou o problema.
Solução:
- Ajuste o tipo de dado ou a conversão de data no processo de extração;
- Reexecute a carga de dados após a correção.
3. Erro de SQL
Quando a carga de dados depende de consultas SQL, pode ocorrer um erro relacionado diretamente à execução dessas consultas no banco de dados de origem. Nesses casos, o BIMachine apenas repassa a mensagem de erro recebida — ou seja, o problema está no próprio SQL executado, e não na plataforma.
Solução:
- Verifique o log de erro para identificar a mensagem retornada pelo banco de dados;
- Revise a consulta SQL utilizada, corrija eventuais problemas de sintaxe, referências a colunas inexistentes ou outras inconsistências;
- Após os ajustes, reexecute a carga de dados.
Conclusão
Grande parte dos erros de carga pode ser identificada e corrigida pelo próprio cliente com base nos logs e na estrutura da carga. Garantir que os arquivos estejam consistentes e respeitem a estrutura esperada é essencial para manter os processos em funcionamento.
Caso o erro persista mesmo após as correções sugeridas, recomendamos entrar em contato com o suporte técnico para uma análise mais aprofundada.