Banco de Dados
Banco de Dados
O Runner utiliza um banco de dados local para armazenar a fila de execuções, registros de agendamentos e mensagens do WhatsApp. A aba Banco de Dados permite configurar qual banco de dados será usado e realizar a limpeza de dados acumulados.
Tipos de banco de dados
Interno
O Runner usa um banco de dados embutido, gerenciado automaticamente. Não é necessária nenhuma configuração adicional — é a opção mais simples e recomendada para a maioria dos casos.
Externo
O Runner se conecta a um banco de dados externo já instalado na máquina ou em outro servidor. Use esta opção quando:
- Sua organização já possui uma infraestrutura de banco de dados gerenciada
- Você precisa de maior controle sobre os dados (backup, monitoramento, etc.)
- O ambiente exige um banco de dados compartilhado entre múltiplos serviços
Os bancos de dados suportados para modo externo são:
| Banco de Dados | Porta padrão |
|---|---|
| MySQL | 3306 |
| MariaDB | 3306 |
| PostgreSQL | 5432 |
| SQL Server | 1433 |
O que é armazenado
Independente do tipo escolhido (interno ou externo), o Runner sempre usa um banco chamado roberty, com três tabelas:
runs — histórico de execuções
| Coluna | Descrição |
|---|---|
id | Identificador da execução |
robotKey | Robô executado |
instanceId | Instância/configuração do robô que rodou |
status | Não iniciado, Em andamento ou Concluído |
scheduled | Se foi disparada por agendamento (true) ou manualmente (false) |
exitCode | Código de saída do processo (0 = sucesso) |
error | Mensagem de erro, se a execução falhou |
startedAt / finishedAt | Início e fim da execução |
stdout / stderr | Saída padrão e de erro durante a execução |
stdoutFilePath / stderrFilePath | Caminho do arquivo com o log completo |
errorScreenshotPath | Print de tela tirado no momento do erro |
argsFilePath | Caminho do arquivo com os argumentos usados na execução |
uploadStatus | Controla o envio da execução para o Roberty Studio: Não enviado, Enviando ou Enviado |
uploadError | Erro ocorrido ao tentar enviar os dados para o Studio |
createdAt / updatedAt | Data de criação e última atualização do registro |
schedules — regras de agendamento
| Coluna | Descrição |
|---|---|
id | Identificador da regra |
robotKey | Robô ao qual a regra pertence |
instanceId | Instância à qual a regra pertence |
rules | Lista de regras — dias (semana, mês ou datas específicas) e horário (período, intervalo fixo ou horários específicos) |
createdAt / updatedAt | Data de criação e última atualização |
whatsapp_messages — fila de mensagens WhatsApp
| Coluna | Descrição |
|---|---|
id | Identificador da mensagem |
to | Número de destino |
type | text ou media |
content | Texto da mensagem (ou legenda, se for mídia) |
mediaPath | Caminho do arquivo de mídia, quando type é media |
instanceName | Instância/conexão de WhatsApp que enviou |
status | Pendente, Na fila ou Processada |
error | Erro no envio, se houver |
sentAt | Data/hora em que foi enviada |
createdAt / updatedAt | Data de criação e última atualização |
Registros removidos — manualmente ou pela limpeza do banco — não são apagados de fato: ficam marcados como excluídos, mas continuam armazenados.
Configurando o banco de dados
Banco interno
- No Painel de Admin, acesse a aba Banco de Dados.
- Em Tipo de Banco, selecione Interno.
- Clique em Salvar.
Banco externo
- Em Tipo de Banco, selecione Externo.
- Selecione o banco de dados desejado no dropdown (MySQL, MariaDB, PostgreSQL ou SQL Server).
- Preencha os campos de conexão:
| Campo | Descrição |
|---|---|
| Porta | Porta de conexão com o banco |
| Usuário | Usuário com acesso ao banco |
| Senha | Senha do usuário |
| Host | Endereço do servidor (ex.: localhost ou IP) |
- Clique em Salvar.
Alterações no banco de dados só terão efeito após reiniciar o Runner.
Conectando diretamente ao banco de dados
As tabelas listadas acima podem ser consultadas diretamente, com qualquer cliente de banco de dados (DBeaver, HeidiSQL, MySQL Workbench, SQL Server Management Studio, etc.) ou até por um robô Roberty — útil para relatórios personalizados ou para cruzar esses dados com outros sistemas, sem depender do Roberty Studio.
Banco externo
Use os mesmos dados de conexão configurados na aba Banco de Dados (host, porta, usuário e senha) e o nome do banco roberty.
Banco interno
Mesmo no modo Interno, o Runner roda um servidor MariaDB de verdade na própria máquina — não é uma caixa-preta inacessível. Os dados de conexão são:
| Campo | Valor |
|---|---|
| Host | localhost (só acessível na própria máquina onde o Runner está instalado) |
| Porta | A porta exibida no campo Porta da aba Banco de Dados |
| Usuário | root |
| Senha | Em branco (sem senha) |
| Banco | roberty |
A leitura direta é segura, mas evite editar ou apagar registros pelas tabelas. Os campos status e uploadStatus são controlados internamente pelo Runner — alterá-los manualmente pode travar a fila de execuções ou impedir o envio dos dados para o Studio. Para remover dados antigos, use a função Limpar banco de dados descrita abaixo.
Tamanho atual do banco
O painel exibe o tamanho atual do banco de dados em tempo real (B, KB, MB ou GB). Use essa informação para monitorar o crescimento dos dados ao longo do tempo.
Limpando o banco de dados
Se o banco de dados crescer muito ou você quiser remover dados desnecessários, use a função de limpeza.
- Clique em Limpar banco de dados.
- No modal de confirmação, selecione o que deseja limpar:
- Fila de execuções (registros concluídos) — remove registros de execuções já finalizadas
- Fila de mensagens WhatsApp — remove mensagens processadas do WhatsApp
- Clique em Sim, limpar para confirmar.
Os dados removidos na limpeza são excluídos permanentemente. Certifique-se de que não precisa mais desses registros antes de confirmar. Considere exportar ou verificar o Histórico de execuções no Designer antes de limpar.
Próximos passos
- Proxy — configure um proxy para as conexões de rede do Runner
- Fila de Execuções — monitore as execuções em andamento