Tâches planifiées

fonctionnel

Exécuter des dumps intégrés, des sauvegardes natives et des exports de requêtes enregistrées selon un calendrier tant que SQLly est ouvert.

SQLly peut exécuter trois types de tâches toutes les heures, tous les jours ou toutes les semaines : dump SQL intégré, un sauvegarde native avec pg_dump ou mysqldump, ou un exportation de requêtes qui exécute une requête enregistrée dans la bibliothèque SQL et écrit le résultat dans un fichier CSV ou JSON Lines. Pour en ajouter une, exécutez Planifier une tâche (Dump, sauvegarde ou export de requête)… depuis la palette de commandes, ou cliquez Ajouter… dans Paramètres ▸ Espace de travail ▸ Dumps planifiés. Choisissez la base de données et la tâche, puis définissez le dossier de sortie, la fréquence et le nombre de fichiers à conserver.

Chaque tâche écrit dans un dossier de sortie, jamais un seul fichier : chaque exécution ajoute un nouveau fichier horodaté, et la première exécution crée le dossier s'il n'existe pas. Choisir… ouvre un sélecteur de dossiers. Par défaut, il s'agit d'un SQLLY Backups dossier dans votre dossier personnel.

TâcheMoteursCe que chaque exécution écrit
Dump SQL intégréChaque moteur avec prise en charge du dump<db>_<id>_<stamp>.sql, ou un dossier avec ce nom quand vous générez un fichier par objet. Le contenu, DROP IF EXISTS, la taille du lot et les types d'objets à inclure fonctionnent de la même manière que dans Exporter la base de données en SQL.
Sauvegarde nativePostgreSQL, MySQL / MariaDB<db>_native_<id>_<stamp>.dump (.tar ou .sql pour ces formats de pg_dump), ou .sql depuis mysqldump. PostgreSQL ajoute le format de sortie et --no-owner; MySQL ajoute --single-transaction.
Export de requêteChaque moteur SQL<db>_query_<name>_<id>_<stamp>.csv ou .jsonl avec chaque ligne du résultat de la requête.
SQLly
Planifier une tâche : le sélecteur de tâches alterne entre un dump intégré, une sauvegarde pg_dump native et un export de requête sauvegardée.
Planifier une tâche : le sélecteur de tâches alterne entre un dump intégré, une sauvegarde pg_dump native et un export de requête sauvegardée.

S'exécute uniquement lorsque SQLly est ouvert

SQLly vérifie les tâches à exécuter toutes les minutes, et uniquement lorsque l’application est en cours d’exécution. Il n’installe pas de tâche cron, d’agent launchd ou de tâche planifiée Windows. Si une exécution devait avoir lieu alors que SQLly était fermé, elle s’exécute lors de la première vérification après avoir rouvert l’application. Lorsque vous avez besoin qu’une tâche s’exécute avec SQLly fermé, utilisez Copier la commande CLI (ci-dessous) et collez la ligne dans cron (sur Windows, un travail cron Git Bash ou WSL).

Conserver les fichiers les plus récents

Conserver définit combien de fichiers d'une tâche restent dans son dossier (0 les conserve tous). Après chaque exécution complète, les fichiers plus anciens sont supprimés. Une exécution annulée ou échouée ne supprime rien. Dans les noms ci-dessus, <id> est un identifiant court propre à la tâche et <stamp> est YYYYMMDD-HHMMSS. L'élagage ne supprime que les noms exactement de cette forme, pour cette tâche ; les autres tâches, les autres connexions avec une base du même nom et vos propres fichiers du dossier ne sont jamais touchés. Un dossier n'est supprimé que s'il ne contient rien d'autre qu'un dump d'un fichier par objet. Les fichiers créés par d'anciennes versions de SQLly, sans l'identifiant de tâche, restent en place.

Règles de sécurité

  • Les exports de requêtes sont en lecture seule. La requête enregistrée doit être un unique SELECT en lecture seule. Elle s'exécute sur une connexion verrouillée en SELECT, avec en plus le mode lecture seule de la base de données activé. Toute autre instruction, ou une requête qui retourne plus d'un jeu de résultats, fait échouer l'exécution, et la raison est consignée. La requête est lue depuis le dossier de la bibliothèque SQL défini dans les Paramètres, donc déplacer la bibliothèque ne casse pas la tâche.
  • Les connexions de production ne s'exécutent jamais. Les tâches planifiées, y compris Exécuter maintenant, ignorent les connexions marquées comme production. Cette omission est enregistrée comme dernier résultat de la tâche.
  • Les sauvegardes natives nécessitent une connexion directe. pg_dump et mysqldump se connectent eux-mêmes à la base de données, donc une connexion effectuée via un pont relais enregistre une erreur au lieu de s'exécuter.
  • Les éléments manquants sont signalés, pas devinés. Si pg_dump ou mysqldump n'est pas installé, l'exécution consigne l'erreur et réessaie au créneau suivant. Définissez le chemin de l'outil dans Paramètres ▸ Avancé ▸ Outils de base de données. Si la requête enregistrée a été supprimée, ou si la connexion n'existe plus, la tâche se désactive d'elle-même et explique pourquoi.
  • Aucun mot de passe dans le fichier. dump-schedules.json stocke l'identifiant de la connexion, jamais ses informations d'identification.
  • Un fichier de tâche endommagé est conservé. Si dump-schedules.json ne peut pas être lu, le volet des dumps planifiés affiche l'erreur et SQLly refuse d'écraser le fichier tant que vous ne l'avez pas corrigé ou déplacé. Le volet lit à nouveau le fichier à chaque ouverture, donc une correction apparaît lorsque vous y revenez.

Gestion des tâches

Paramètres ▸ Espace de travail ▸ Dumps planifiés répertorie chaque tâche avec sa connexion, sa base de données, sa tâche, sa cadence, le nombre de fichiers conservés, la prochaine exécution et le dernier résultat. Chaque ligne a Exécuter maintenant, Modifier… (la rouvre dans l'éditeur de planification), Copier la commande CLI, et Supprimer. Exécuter maintenant vous indique dans la barre d'état quand une tâche est déjà en cours. Les tâches enregistrées avant l'arrivée des types de tâches se chargent comme des dumps SQL intégrés.

Les tâches planifiées nécessitent l'application de bureau. La version navigateur ne peut pas écrire de fichiers de manière planifiée.