Documentação HorusBI
Buscar K

Aparência

Primeiros Passos com HorusETL ​

Este guia levará você do zero à execução do seu primeiro fluxo de dados no HorusETL. Você aprenderá a configurar um Agente, conectá-lo à plataforma e criar um pipeline simples.

1. 📋 Pré-requisitos ​

O HorusETL utiliza um Agente (Engine) que roda na sua infraestrutura para processar os dados. Escolha o ambiente onde deseja instalá-lo:

Ambiente Windows ​

  • Sistema Operacional: Windows 10/11 ou Server 2016+ (x64)
  • Runtime: .NET 8 Runtime instalado

Ambiente Linux (Docker) ​

  • Docker instalado e rodando
  • Conectividade de saída para a internet (HTTPS)

TIP

Quanto de CPU e RAM? Para a maioria dos cenários, 2 vCPU / 4 GB RAM é o suficiente. Consulte Requisitos de Hardware do Agente para dimensionar conforme paralelismo, volume e uso de Python.

2. 🔑 Criando um Agente (Token) ​

Antes de instalar o software, você precisa gerar um Token na plataforma. Esse token serve como a chave de identidade do seu Agente.

  1. No menu lateral, navegue até Agentes
  2. Clique no botão Novo Agente
  3. Preencha as configurações iniciais:
    • Descrição — Um nome para identificar onde este agente está rodando (Servidor-Producao ou Meu-PC-Local)
    • Agendamentos Simultâneos — Define quantos fluxos podem rodar ao mesmo tempo (Padrão: 4)
  4. Clique em Salvar
  5. Após salvar, um campo Token do Agente será exibido
  6. Copie este Token e guarde-o em local seguro (você precisará dele no próximo passo)

3. 💻 Instalação e Conexão ​

Agora vamos colocar o Agente para rodar.

Opção A: Windows (Instalador MSI) ​

  1. Faça o download do instalador HorusETL (o link geralmente está disponível na tela de detalhes do Agente)
  2. Execute o instalador e siga os passos (Next, Next, Finish)
  3. Após a instalação, abra o Configurador do HorusETL (atalho criado no Desktop ou Menu Iniciar)
  4. Cole o Token copiado anteriormente no campo solicitado
  5. Inicie o serviço

Opção B: Linux (Docker) ​

Execute o seguinte comando no seu terminal, substituindo SEU_TOKEN_AQUI pelo token copiado:

bash
docker run -d \
  --name horus-etl \
  --restart=always \
  -e TOKEN=SEU_TOKEN_AQUI \
  horusbi/etl:latest

TIP

Verificação: Volte para a tela de Agentes no navegador. Em alguns instantes, o indicador de status do seu agente deve ficar Verde (Online).

4. 🎨 Criando seu Primeiro Dataflow ​

Com o agente online, vamos criar um fluxo simples que consulta uma API pública e salva o resultado.

  1. Navegue até Dataflows
  2. Clique em Novo Flow
  3. Dê um nome ao seu fluxo (Teste API GitHub)
  4. Certifique-se de que o Agente correto está selecionado (caso tenha mais de um)

Desenhando o Fluxo ​

O editor funciona com "arrastar e soltar". Vamos usar dois nós:

  1. Origem:

    • No menu de ferramentas à esquerda, abra a categoria Conexões
    • Arraste o nó Requisição HTTP para a área de desenho
    • Clique no nó para configurá-lo
    • URL: Digite https://api.github.com/zen (uma API simples que retorna uma frase de texto)

  2. Destino:

    • Abra a categoria Destinos
    • Arraste o nó Inserir Datawarehouse
    • Conecte a saída (bolinha direita) do nó Requisição HTTP na entrada (bolinha esquerda) do nó Inserir Datawarehouse
    • Dependendo da configuração do seu ambiente, pode ser necessário selecionar uma tabela de destino válida nas propriedades deste nó

  3. Salvar: Clique no botão Salvar Flow (ícone de disquete) na barra superior

5. ▶️ Executando e Monitorando ​

  1. Na barra superior, clique no botão Executar Tudo
  2. Aguarde a execução — você verá indicadores de status nos nós (rodando, sucesso ou erro)
  3. Verificando o Resultado:
    • Clique no nó Inserir Datawarehouse
    • Verifique os logs na aba inferior (ou lateral) para confirmar se os dados foram processados
    • Se houver erro (tabela não configurada), o nó ficará vermelho. Clique nele para ver a mensagem de erro detalhada

🔗 Próximos Passos ​

Agora que você já sabe o básico, explore a documentação completa dos Processadores para criar fluxos mais complexos com Banco de Dados, Excel e transformações Python.