Linux

Логический бэкап PostgreSQL

Создаёт pg_dump или pg_dumpall, проверяет архив и считает SHA-256.

Shell Linux Средний
Скачать postgres_backup.sh
Описание

Что делает скрипт

Скрипт делает логическую резервную копию базы или всего кластера, по умолчанию в custom-формате. Сначала показывается план и размер базы, запись выполняется с --apply. После дампа проверяется читаемость через pg_restore или gzip и сохраняется контрольная сумма.

Перед запуском
  • Бэкап содержит данные и метаданные ролей. Храните файл с правами 0600 и не передавайте его в открытом виде.
Запуск

Быстрый старт

bash postgres_backup.sh --database app --output /var/backups/postgres

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

Другие варианты

  • bash postgres_backup.sh --database app --output /var/backups/postgres
  • bash postgres_backup.sh --database app --output /var/backups/postgres --format plain --apply
  • bash postgres_backup.sh --all --host db.example.com --user backup --output /srv/backups --apply
Зависимости

Что понадобится

Bash 4+ Стандартные утилиты
Linux sudo apt install bash
PostgreSQL client pg_dump, pg_dumpall, pg_restore, psql
Linux sudo apt install postgresql-client
gzip Сжатие pg_dumpall
Linux sudo apt install gzip
Исходник

postgres_backup.sh

#!/usr/bin/env bash
set -euo pipefail

usage() {
    cat <<'EOF'
Использование: postgres_backup.sh (--database NAME | --all) --output DIR
                                    [--host HOST] [--port PORT] [--user USER]
                                    [--format custom|plain] [--apply]

Создаёт логический бэкап PostgreSQL. Без --apply только показывает план.
Пароль не передаётся в командной строке, используйте .pgpass или peer-аутентификацию.
EOF
}

database=""
output_dir=""
host=""
port="5432"
user=""
format="custom"
all=0
apply=0

while [[ $# -gt 0 ]]; do
    case "$1" in
        --database|-d) [[ $# -ge 2 ]] || exit 2; database="$2"; shift 2 ;;
        --output|-o) [[ $# -ge 2 ]] || exit 2; output_dir="$2"; shift 2 ;;
        --host) [[ $# -ge 2 ]] || exit 2; host="$2"; shift 2 ;;
        --port) [[ $# -ge 2 ]] || exit 2; port="$2"; shift 2 ;;
        --user) [[ $# -ge 2 ]] || exit 2; user="$2"; shift 2 ;;
        --format) [[ $# -ge 2 ]] || exit 2; format="$2"; shift 2 ;;
        --all) all=1; shift ;;
        --apply) apply=1; shift ;;
        -h|--help) usage; exit 0 ;;
        *) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
    esac
done

[[ -n "$output_dir" ]] || { echo "Укажите каталог через --output" >&2; exit 2; }
[[ -n "$database" || "$all" -eq 1 ]] || { echo "Укажите --database или --all" >&2; exit 2; }
[[ "$format" == "custom" || "$format" == "plain" ]] || { echo "--format: custom или plain" >&2; exit 2; }
[[ "$port" =~ ^[0-9]+$ ]] || { echo "--port должен быть числом" >&2; exit 2; }

command -v pg_dump >/dev/null 2>&1 || { echo "pg_dump не найден. Установите postgresql-client." >&2; exit 2; }
if ((all == 1)); then
    command -v pg_dumpall >/dev/null 2>&1 || { echo "pg_dumpall не найден." >&2; exit 2; }
    command -v gzip >/dev/null 2>&1 || { echo "gzip не найден." >&2; exit 2; }
fi

conn=()
[[ -n "$host" ]] && conn+=(-h "$host")
[[ -n "$port" ]] && conn+=(-p "$port")
[[ -n "$user" ]] && conn+=(-U "$user")

if command -v pg_isready >/dev/null 2>&1; then
    if pg_isready "${conn[@]}" >/dev/null 2>&1; then
        echo "PostgreSQL доступен."
    else
        echo "[WARN] pg_isready не подтвердил доступ к серверу." >&2
    fi
fi

if ((all == 0)) && command -v psql >/dev/null 2>&1; then
    size="$(psql "${conn[@]}" -d "$database" -tAc 'select pg_size_pretty(pg_database_size(current_database()))' 2>/dev/null || true)"
    [[ -n "$size" ]] && echo "Размер базы $database: $size"
fi

timestamp="$(date +%Y%m%d-%H%M%S)"
if ((all == 1)); then
    target="$output_dir/all-$timestamp.sql.gz"
elif [[ "$format" == "custom" ]]; then
    target="$output_dir/$database-$timestamp.dump"
else
    target="$output_dir/$database-$timestamp.sql"
fi

cmd=()
if ((all == 1)); then
    echo "Режим: pg_dumpall | gzip"
else
    if [[ "$format" == "custom" ]]; then
        cmd=(pg_dump "${conn[@]}" -Fc -Z 6 -f "$target" "$database")
    else
        cmd=(pg_dump "${conn[@]}" -Fp -f "$target" "$database")
    fi
    printf 'Команда: '
    printf '%q ' "${cmd[@]}"
    echo
fi

echo "Архив: $target"
if ((apply == 0)); then
    echo
    echo "Это предпросмотр. Для создания бэкапа добавьте --apply."
    exit 0
fi

mkdir -p "$output_dir"
[[ -w "$output_dir" ]] || { echo "Каталог недоступен для записи: $output_dir" >&2; exit 2; }
umask 077

if ((all == 1)); then
    pg_dumpall "${conn[@]}" | gzip -9 > "$target"
else
    "${cmd[@]}"
fi
chmod 0600 "$target"

if ((all == 1)); then
    gzip -t "$target"
elif [[ "$format" == "custom" ]]; then
    command -v pg_restore >/dev/null 2>&1 || { echo "pg_restore не найден, проверка пропущена." >&2; }
    if command -v pg_restore >/dev/null 2>&1; then
        pg_restore --list "$target" >/dev/null
    fi
else
    [[ -s "$target" ]] || { echo "Дамп пуст: $target" >&2; exit 1; }
fi

sha256sum "$target" | tee "$target.sha256"
echo "Бэкап готов: $target"
if ((all == 1)); then
    echo "Восстановление: gunzip -c \"$target\" | psql"
elif [[ "$format" == "custom" ]]; then
    echo "Восстановление: pg_restore -d \"$database\" \"$target\""
else
    echo "Восстановление: psql -d \"$database\" -f \"$target\""
fi

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get linux-postgres-backup
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Linux

Bash и Python для серверов, рабочих станций и повседневных задач Linux.