Tarefas agendadas
funcionalExecute dumps embutidos, backups nativos e exportações de consultas salvas de forma agendada enquanto o SQLly estiver aberto.
O SQLLY pode executar três tipos de tarefas por hora, diariamente ou semanalmente: um dump SQL embutido, um backup nativo com pg_dump ou
mysqldump, ou um exportação de consulta que executa uma consulta salva na biblioteca SQL e grava o resultado em um arquivo CSV ou JSON Lines. Para adicionar uma, execute
Agendar tarefa (dump, backup ou exportação de consulta)… da paleta de comandos, ou clique Adicionar… em Configurações ▸ Espaço de Trabalho ▸ Dumps agendados. Escolha o banco de dados e a tarefa, depois defina a pasta de saída, a cadência e quantos arquivos manter.
Cada tarefa grava em uma pasta de saída, nunca um único arquivo: cada execução acrescenta ali um novo arquivo com data e hora no nome, e a primeira execução cria a pasta, se ela não existir. Escolha…
abre um seletor de pastas. O padrão é uma SQLLY Backups pasta na sua pasta pessoal.
| Tarefa | Mecanismos | O que cada execução escreve |
|---|---|---|
| Dump SQL integrado | Todo mecanismo com suporte a dump | <db>_<id>_<stamp>.sql, ou uma pasta com esse nome quando você gera um dump com um arquivo por objeto. Conteúdo, DROP IF EXISTS, tamanho do lote e quais tipos de objeto incluir funcionam como em Exportar banco de dados como SQL. |
| Backup nativo | PostgreSQL, MySQL / MariaDB | <db>_native_<id>_<stamp>.dump (.tar ou .sql para aqueles formatos pg_dump), ou .sql do mysqldump. PostgreSQL adiciona o formato de saída e --no-owner; MySQL adiciona --single-transaction. |
| Exportação de consulta | Todo mecanismo SQL | <db>_query_<name>_<id>_<stamp>.csv ou .jsonl com cada linha do resultado da consulta. |

Executa apenas enquanto o SQLly estiver aberto
O SQLly verifica as tarefas programadas a cada minuto, e somente enquanto o aplicativo estiver em execução. Ele não instala um trabalho cron, um agente launchd ou uma tarefa agendada do Windows. Se uma execução estava programada enquanto o SQLly estava fechado, ela é executada na primeira verificação após você abrir o aplicativo novamente. Quando você precisar que uma tarefa seja executada com o SQLly fechado, use Copiar comando CLI (abaixo) e cole a linha no cron (no Windows, um trabalho cron no Git Bash ou WSL).
Mantendo os arquivos mais recentes
Manter define quantos arquivos de uma tarefa permanecem em sua pasta (0 mantém todos). Após cada execução completa, os arquivos mais antigos são excluídos. Uma execução cancelada ou com falha não exclui nada. Nos nomes acima, <id> é um id curto único da tarefa e
<stamp> é YYYYMMDD-HHMMSS. A limpeza apaga apenas nomes exatamente desse formato para aquela tarefa, então outras tarefas, outras conexões com um banco de dados de mesmo nome e seus próprios arquivos na pasta nunca são tocados. Uma pasta só é apagada quando não contém nada além de um dump de um arquivo por objeto. Arquivos nomeados por versões anteriores do SQLly, sem o id da tarefa, ficam onde estão.
Regras de segurança
- As exportações de consultas são somente leitura. A consulta salva deve ser um único SELECT somente leitura. Ela é executada em uma conexão bloqueada para SELECT, com o modo somente leitura do banco de dados ativado também. Qualquer outra instrução, ou uma consulta que retorne mais de um conjunto de resultados, faz com que a execução falhe, e o motivo é registrado. A consulta é lida a partir da pasta da biblioteca SQL definida em Configurações, então mover a biblioteca não quebra a tarefa.
- Conexões de produção nunca são executadas. Tarefas agendadas, incluindo Executar agora, pulam conexões marcadas como produção. A omissão é registrada como o último resultado da tarefa.
- Backups nativos precisam de uma conexão direta. pg_dump e mysqldump conectam-se ao banco de dados por conta própria, então uma conexão alcançada através de uma ponte de relay registra um erro em vez de executar.
- As partes que faltam são relatadas, não adivinhadas. Se
pg_dumpoumysqldumpnão está instalado, a execução registra o erro e tenta novamente na próxima vez disponível. Defina o caminho da ferramenta em Configurações ▸ Avançado ▸ Ferramentas de banco de dados. Se a consulta salva foi excluída ou a conexão não existir mais, a tarefa se desliga e informa o motivo. - Nenhuma senha no arquivo.
dump-schedules.jsonarmazenam o id da conexão, nunca suas credenciais. Ferramentas nativas obtêm a senha da mesma forma que um dump nativo manual. - Um arquivo de tarefa danificado é mantido. Se
dump-schedules.jsonnão puder ser lido, o painel de dumps agendados mostra o erro e o SQLly se recusa a salvar por cima do arquivo até que você o corrija ou mova. O painel relê o arquivo a cada vez que você o abre, então a correção aparece quando você volta a ele.
Gerenciando tarefas
Configurações ▸ Espaço de trabalho ▸ Dumps agendados lista cada tarefa com sua conexão, banco de dados, tarefa, cadência, quantos arquivos mantém, a próxima execução e o último resultado. Cada linha tem Executar agora, Editar… (reabre no editor de agendamento), Copiar comando CLI, e Remover. Executar agora informa na barra de status quando uma tarefa já está em execução. Tarefas salvas antes de existirem tipos de tarefa são carregadas como dumps SQL integrados.
Tarefas agendadas precisam do aplicativo de desktop. A versão do navegador não pode escrever arquivos em um agendamento.