Запланированные задачи

функциональный

Запускайте встроенные дампы, нативные резервные копии и экспорт по сохраненным запросам по расписанию, пока SQLly открыт.

SQLly может запускать три вида задач — ежечасно, ежедневно или еженедельно: встроенный SQL-дамп, нативное резервное копирование с pg_dump или mysqldump, или экспорт запроса который выполняет сохраненный запрос из библиотеки SQL и записывает результат в файл CSV или JSON Lines. Чтобы добавить задачу, выполните Запланировать задачу (дамп, резервное копирование или экспорт запроса)… из палитры команд или нажмите Добавить… в разделе Настройки ▸ Рабочее пространство ▸ Запланированные дампы. Выберите базу данных и задачу, затем задайте папку вывода, периодичность и сколько файлов хранить.

Каждая задача записывает в папку для вывода, никогда не один файл: каждый запуск добавляет туда новый файл с отметкой времени, а первый запуск создаёт папку, если её ещё нет. Выбрать… открывает выбор папки. По умолчанию это SQLLY Backups папка в вашей домашней папке.

ЗадачаДвижкиЧто пишет каждый запуск
Встроенный SQL-дампКаждый движок с поддержкой дампа<db>_<id>_<stamp>.sql, или папка с таким именем, когда вы выгружаете по одному файлу на объект. Содержимое, DROP IF EXISTS, размер пакета и набор включаемых типов объектов работают так же, как при экспорте базы данных в SQL.
Нативное резервное копированиеPostgreSQL, MySQL / MariaDB<db>_native_<id>_<stamp>.dump (.tar или .sql для тех форматов pg_dump), или .sql из mysqldump. PostgreSQL добавляет формат вывода и --no-owner; MySQL добавляет --single-transaction.
Экспорт запросаЛюбой SQL-движок<db>_query_<name>_<id>_<stamp>.csv или .jsonl с каждой строкой результата запроса.
SQLly
Запланировать задачу: выбор задачи переключается между встроенным дампом, нативным резервным копированием pg_dump и экспортом сохранённого запроса.
Запланировать задачу: выбор задачи переключается между встроенным дампом, нативным резервным копированием pg_dump и экспортом сохранённого запроса.

Выполняется только при открытом SQLly

SQLly проверяет наступление срока задач раз в минуту и только пока приложение запущено. Он не устанавливает задачу cron, агент launchd или планировщик задач Windows. Если срок наступил, пока SQLly был закрыт, задача выполнится при первой проверке после повторного открытия приложения. Когда задачу нужно выполнить при закрытом SQLly, используйте Копировать команду CLI (ниже) и вставьте строку в cron (в Windows — в cron через Git Bash или WSL).

Хранение самых свежих файлов

Оставить устанавливает, сколько файлов задачи остаются в её папке (0 сохраняет все). После каждого полного запуска старые файлы удаляются. Отменённый или неудавшийся запуск ничего не удаляет. В приведённых выше названиях, <id> — это короткий id, уникальный для задачи, а <stamp> является YYYYMMDD-HHMMSS. Очистка удаляет только имена строго определённой формы, относящиеся к этой задаче, поэтому другие задачи, другие подключения с базой данных того же имени и ваши собственные файлы в папке не затрагиваются. Папка удаляется, только если в ней нет ничего, кроме дампа «один файл на объект». Файлы, созданные старыми версиями SQLly без идентификатора задачи, остаются на месте.

Правила безопасности

  • Экспорт запросов доступен только для чтения. Сохранённый запрос должен быть единственным запросом SELECT только для чтения. Он выполняется на соединении, заблокированном для SELECT, с включённым режимом только для чтения базы данных. Любое другое выражение или запрос, возвращающий более одного набора результатов, приведёт к сбою выполнения, и причина будет зафиксирована. Запрос читается из папки библиотеки SQL, указанной в Настройках, поэтому перемещение библиотеки не нарушает работу задачи.
  • Продакшн-подключения никогда не выполняются. Запланированные задачи, включая Выполнить сейчас, пропускают подключения, помеченные как продакшн. Пропуск записывается как последний результат задачи.
  • Для нативного резервного копирования нужно прямое соединение. pg_dump и mysqldump подключаются к базе данных сами по себе, поэтому соединение, открытое через реле-мост, зафиксирует ошибку вместо выполнения.
  • Недостающее сообщается явно, а не додумывается. Если pg_dump или mysqldump не установлено, выполнение фиксирует ошибку и пытается снова в следующем слоте. Установите путь к инструменту в Настройки ▸ Дополнительно ▸ Инструменты базы данных. Если сохранённый запрос был удалён или соединение больше не существует, задача отключается и сообщает причину.
  • В файле нет паролей. dump-schedules.json сохраняет идентификатор соединения, но никогда не его учётные данные. Нативные инструменты получают пароль так же, как при ручном нативном дампе.
  • Повреждённый файл задачи сохраняется. Если dump-schedules.json не удаётся прочитать, панель запланированных дампов показывает ошибку, и SQLly не перезапишет файл, пока вы его не исправите и не перенесёте. Панель перечитывает файл при каждом открытии, так что исправление будет видно, когда вы вернётесь.

Управление задачами

Настройки ▸ Рабочее пространство ▸ Запланированные дампы показывают для каждой задачи подключение, базу данных, задачу, периодичность, сколько файлов хранится, следующий запуск и последний результат. У каждой строки есть Выполнить сейчас, Редактировать… (снова открывает её в редакторе расписания), Копировать команду CLI, и Удалить. Выполнить сейчас сообщает в строке состояния, когда задача уже выполняется. Задачи, сохраненные до появления типов задач, загружаются как встроенные SQL-дампы.

Запланированным задачам нужно настольное приложение. Браузерная версия не умеет писать файлы по расписанию.