Цю сторінку перекладено машинним перекладом. Читайте англійський оригінал. English

Резервні копії Firebird

Заплановані gbak і nbackup — для однієї бази даних або для всіх баз у папці. Для gbak можна ввімкнути тестове відновлення після кожної резервної копії. База даних оновлюється з резервної копії автоматично, і жоден збій посередині не залишає її в невідомому стані.

  • 6 типів завдань резервного копіювання
  • nbackup рівні 0…4
  • zip · gz · zstd з перевіркою архіву
  • S3 без проміжного файлу
  • тестове відновлення

Два інструменти

gbak чи nbackup

HQbird підтримує обидва типи резервного копіювання Firebird, і ви можете використовувати обидва для однієї бази даних. gbak створює логічну копію: вона менша за базу даних, і відновлення її перевіряє. nbackup копіює сторінки бази даних: це швидко, і інкременти займають мало місця.

gbak (перевірена резервна копія)nbackup (інкрементальний)
Що копіюєДані та метадані. Сміття та старі версії записів не потрапляють до копії.Сторінки файлу бази даних. Рівень 0 — повний; рівні 1…N містять лише змінені сторінки.
РозмірЗазвичай набагато менший за базу даних; добре стискається.Рівень 0 — розмір бази даних; інкременти малі.
ВідновленняСтворює нову базу даних і будує індекси заново. Для великих баз даних це займає багато часу.Об'єднує ланцюжок рівнів. Швидко.
ПеревіркаТестове відновлення після кожної резервної копії, якщо це ввімкнено в завданні.Перевірка ланцюжка за GUID. Немає рівня 0 — агент створює його одразу.
Використовуйте дляНадійна копія, перенесення між версіями та серверами, Backup-Restore-Replace.Часті точки відновлення протягом дня без навантаження на сервер.

Якщо gbak і nbackup однієї бази даних мають стартувати в одну й ту саму хвилину, gbak зміщується на 15 хвилин пізніше. Поки nbackup використовує базу даних, gbak чекає (за замовчуванням до 60 хвилин) і не завершується помилкою.

Типи завдань

Індивідуальні та групові завдання

Індивідуальне завдання охоплює одну базу даних і має власні налаштування. Використовуйте його для головної бази даних компанії: власний розклад, власна папка, власне зберігання.

Групове завдання охоплює папки з базами даних. Один набір налаштувань для всіх баз даних групи. У кожному циклі агент знову сканує папки за масками, тому нова база даних автоматично потрапляє до резервного копіювання без зміни налаштувань.

Одна база данихУсі бази даних у папках
gbak з перевіркоюvbackupgrpvbackup
nbackup з рівнямиnbackupgrpnbackup
nbackup dumpnbackup_dumpgrpnbackup_dump

Що групове завдання бере, а що пропускає

Агент проходить папки й перевіряє кожен файл за масками включення та виключення. За бажанням він також перевіряє мінімальний розмір і початок файлу. Файли резервних копій (.fbk, .nbk, .delta, архіви) ніколи не потрапляють до резервної копії.

База даних, яка має власне індивідуальне завдання, автоматично виключається з групи, навіть якщо це завдання вимкнено. Група gbak не бере бази даних індивідуальних завдань gbak. Група nbackup не бере бази даних завдань nbackup і dump.

Системні бази даних (назви, що починаються з security та examples) завжди пропускаються. Попередній перегляд сканування показує причину кожного пропуску.

D:\data\ · маска *.fdb

  1. sales.fdbу групі
  2. stock.fdbу групі
  3. branch_new.fdb
    нова база даних: починається з рівня 0
    у групі
  4. erp.fdb
    має власне індивідуальне завдання
    пропустити
  5. security5.fdb
    системна база даних
    пропустити
  6. bck_sales_20261107.fbk
    файл резервної копії
    пропустити
  7. orders.fdb.delta
    дельта-файл nbackup
    пропустити
  • Базу даних видалено з папкиВона стає «осиротілою». Її резервні копії зберігаються за правилом: N днів або завжди. Або вони одразу переходять до папки _orphaned і видаляються через 7 днів.
  • Базу даних перейменованоНова назва починає новий ланцюжок з рівня 0. Старі резервні копії зберігаються за правилом для осиротілих баз даних.
  • Повторні збоїПісля 5 збоїв поспіль база даних призупиняється на 6 годин, а потім спроба повторюється.
  • Помилка в одній базі даних не зупиняє групуГрупа продовжує з наступною базою даних. Це налаштування «Продовжувати з наступними базами даних після помилки»; воно ввімкнене за замовчуванням для груп gbak, nbackup, dump і sweep.
  • Результат групи в рядку завдання«Знайдено N баз даних · успішно M · помилок X · загальний час». У деталях є таблиця баз даних з помилкою: назва, шлях і початок тексту помилки.
  • Бюджет часуЦикл не починає нові бази даних, коли час вичерпано. Для груп nbackup можна ввімкнути продовження з наступної бази даних у наступному циклі.
  • ПаралельністьСкільки баз даних групи обробляти одночасно. Спільний ліміт для довгих завдань на сервері: за замовчуванням одночасно виконується не більше двох.
  • Одна операція на базу данихІндивідуальні та групові завдання, gbak і nbackup бачать блокування одне одного.
  • Дерево каталогів як у джереліПрапорець «Повторювати дерево каталогів джерела»: резервна копія бази даних x/y/EMPLOYEE.FDB потрапляє до <backup folder>/x/y/EMPLOYEE.FDB/. Бази даних з однаковими назвами з різних каталогів не заважають одна одній.
Завдання в HQ Monitor. Шість типів резервного копіювання та інвентаризація. Завдання відновлення — в окремій групі: їх потрібно дозволити явно, бо вони змінюють бази даних.

vbackup · grpvbackup

gbak: резервне копіювання з перевіркою

Перед кожним кроком агент перевіряє вільне місце: для резервної копії, для тестового відновлення, для архіву. Якщо місця для відновлення недостатньо, агент пропускає його з причиною no_space, а резервна копія залишається. gbak пише в тимчасовий файл. Файл отримує ім'я .fbk лише якщо розмір і журнал gbak правильні. Тож неповна резервна копія зі звичайним ім'ям ніколи не з'являється в каталозі.

  1. 1Перевірка місцядля резервної копії; знову перед відновленням і стисненням
  2. 2gbakу тимчасовий .gbaktmp; на Firebird 5 — на N ядрах
  3. 3Перевіркарозмір і журнал; потім ім'я .fbk
  4. 4Тестове відновленняякщо ввімкнено; окремий файл, не робоча база даних
  5. 5Стисненняархів розпаковано й порівняно за SHA-256
  6. 6✓ Зберіганнякопіювання до іншого каталогу; старі копії видаляються
Форма завдання gbak. Розклад із підказкою часового поясу, каталог і назва резервної копії, параметри gbak в одному рядку, тайм-аути та коефіцієнти розрахунку місця.
  • Зрозумілі назвиbck_sales_20261107_02-00.fbk: початок назви бази даних і час. Дві бази даних в одному каталозі не пишуть однакових назв.
  • Попередження про збігЯкщо два завдання починають писати файли з однаковою назвою в один каталог, агент і редактор показують попередження.
  • Результат тестового відновленняok, failed, skipped із причиною або not_run. Ви бачите його в результаті останнього завдання та в інвентаризації. У редакторі кожне відновлення показує обидві команди: резервне копіювання та відновлення.
  • Стара тестова база данихНове завдання запускає тестове відновлення з -rep: gbak перезаписує копію з попереднього запуску. Агент спершу від'єднує клієнтів цієї копії. Якщо шлях тестової бази даних збігається з робочою базою даних або базою даних іншого завдання, відновлення пропускається.
  • Журнали та команди gbakОстанні рядки помилок видно в консолі; журнал можна завантажити. Журнали видаляються разом із їхньою резервною копією. Агент зберігає історію виконаних команд: до 50 для кожного кроку завдання, паролі приховані.
  • Перемикачі, що ламають перевірку-Y спрямовує вивід gbak у файл, але агент перевіряє резервну копію за цим виводом. Тому -Y не дозволено. Потокове завдання також не приймає -SE у рядку відновлення. Редактор позначає ці перемикачі.
  • Тайм-аутиМ'який: попередження. Жорсткий: gbak зупиняється.
  • Час gbak за крокомАгент сам додає перемикач -ST TDRW до кожного резервного копіювання та відновлення й бере час gbak із виводу. Вам не потрібен власний -ST у параметрах завдання: редактор його не приймає.
  • Агент задає логінПеремикачі -user, -password, -fetch_password і -trusted не дозволені в параметрах. Тестове відновлення виконується від імені власника бази даних, якщо власника записано в налаштуваннях доступу до бази даних. Рядок відновлення показує, від імені якого користувача воно виконувалося.
  • Зрозумілі повідомленняМісце й час у звичних одиницях: «8.1 GiB free, 11.8 GiB needed», «timed out after 60 s».

nbackup · grpnbackup

nbackup: рівні та точки відновлення

Рівень 0 копіює всю базу даних. Рівень 1 копіює сторінки, змінені після останнього рівня 0. Рівень 2 копіює зміни після останнього рівня 1. Щоб відновити базу даних до потрібного моменту, достатньо трьох файлів.

Приклад розкладу: рівень 0 раз на тиждень, рівень 1 щоночі, рівень 2 чотири рази на день. Це дає 36 точок відновлення на тиждень: 1 + 7 + 28. Зберігається 5 копій рівня 0, 7 рівня 1 і 24 рівня 2.

Тиждень nbackup: рівень 0 у неділю, рівень 1 щоночі, рівень 2 чотири рази на день; відновлення бере по одному файлу кожного рівня
рівень 0 рівень 1 рівень 2 файли для відновлення
  • Ланцюг без прогалинНемає рівня 0 — агент створює його одразу. Для інших рівнів це налаштування «Негайно створювати відсутні нижчі рівні». Без нього запуск пропускається, поки нижчий рівень відсутній.
  • Перевірка за GUIDКожен рівень прив'язаний до свого нижчого рівня; сторонній файл не потрапляє до ланцюга.
  • Три режими розкладуПростий — за днями та годинами. Розширений — cron для кожного рівня, до рівня 4. План — правила з рівнем, днями та часом.
  • Дамп nbackupПовна копія файлу бази даних поза ланцюгом рівнів, за власним розкладом.
  • База даних у стані дельтиЯкщо база даних залишається заблокованою після перерваного nbackup, агент намагається об'єднати дельту.

Режим плану

План — це набір правил: рівень, дні та час. Дні можуть бути щодня, днями тижня або днями місяця. Якщо два правила збігаються в одну хвилину, запускається нижчий рівень. План може самостійно створити рівень 0, коли останній рівень 0 старший за задану кількість днів. Він запускає нижчий рівень раніше запланованого, коли інкременти зростають понад задану частку розміру бази даних. У груповому завданні кожна база даних будує власний ланцюжок рівнів.

Редактор показує план у календарі на кілька тижнів уперед: який рівень запускається і коли. Одна кнопка перетворює простий або розширений розклад у план, і ви можете скасувати це до збереження.

  • Збереження за цикламиЦикл — це рівень 0 з усіма його інкрементами. Агент зберігає або видаляє цілий цикл: за кількістю циклів, за днями або за загальним розміром. Найновіший повний цикл ніколи не видаляється. Редактор заздалегідь показує, скільки місця займуть резервні копії.
  • Статус плануОстання копія кожного рівня, використане місце та те, що видалить наступне очищення. Агент оновлює статус після кожного запуску плану.

Стиснення · S3 · сховище

Де зберігаються резервні копії

Резервна копія може надходити безпосередньо до S3: gbak або nbackup пише в потік, а потік іде до бакета. Проміжного файлу на диску сервера немає, тому вам не потрібно місце для резервної копії на сервері.

Стиснення zip, gz або zstd працює як для локальних, так і для потокових резервних копій. Для локальної резервної копії агент розпаковує готовий архів і порівнює його з джерелом за розміром і SHA-256. Лише після цього вихідний файл видаляється. Якщо перевірка не вдається, нічого не видаляється.

  • Збереження за кількістюgbak: скільки файлів зберігати. nbackup: скільки копій кожного рівня.
  • Копії в інші місцяКопія до другої папки або мережевого шляху. Вивантаження до S3, FTP або FTPS — окремим завданням file_sync.
  • Ваш власний скрипт після резервного копіюванняДля gbak. Він отримує шляхи до резервної копії, тестової бази даних і журналів gbak.
  • Шифрування архівуЗавдання gbak може зашифрувати zip-архів (AES-256) паролем із ключів агента, на диску та в потоці S3. 7-Zip відкриває архів. Відновлення саме знаходить правильний ключ.
  • Відновлення з архівуФормат визначається за вмістом файлу, локально та з S3.
  • Відновлення з S3Завдання відновлення читає резервну копію безпосередньо з бакета.
  • АнтивірусВиключіть папки резервного копіювання та відновлення зі сканування в реальному часі.
  • Ви обираєте стисненняНове завдання створюється без стиснення. zstd стоїть першим у списку форматів. Ви можете задати власне розширення файлу для архіву будь-якого формату.
  • Посібник з Amazon S3Покрокове налаштування бакета, ключів і завдання. Доступний англійською та португальською.

Amazon S3 · сумісне сховище

Резервні копії до S3

Агент надсилає резервні копії до бакета в Amazon S3 або в сумісному сховищі. Це працює для завдань gbak і nbackup. Вам не потрібна для цього інша програма.

Налаштування має три частини: підготувати бакет і ключ доступу, створити ціль s3 у налаштуваннях агента, увімкнути вивантаження в завданні резервного копіювання. Кожне завдання використовує один із двох режимів.

Копіювання файлуПотік до S3
Файл на диску сервераТак. Резервна копія записується на диск, потім надсилається.Ні. Резервна копія надходить безпосередньо до бакета.
Місце на диску для резервної копіїПотрібне.Не потрібне.
КудиS3, FTP, FTPSЛише S3
Видалення старих копій у бакетіНі. Використовуйте правило життєвого циклу бакета.Так, за правилом збереження завдання.
Збій вивантаженняЛокальна резервна копія залишається чинною.Резервної копії немає: жоден об'єкт не залишається в бакеті.
  • Як обратиКопіювання файлу: коли вам потрібні і локальна копія, і копія в S3. Потік: коли диск сервера малий або S3 є єдиним місцем для резервних копій.
  • Відновлення з S3Завдання відновлення читає потокову резервну копію безпосередньо з бакета: найновіший об'єкт або той, який ви вкажете. Агент перевіряє розмір і SHA-256 кожного об'єкта.
  • ШифруванняШифрування бакета захищає об'єкт на боці сховища. Шифрування архіву в завданні захищає файл паролем, перш ніж він залишить сервер.
  • БакетТримайте публічний доступ заблокованим. Додайте правило, яке видаляє незавершені багаточастинні вивантаження через одну добу.
  • Ключ лише для резервних копійСтворіть окремого користувача. Надайте йому лише потрібні права: записувати, читати та видаляти об'єкти, переривати вивантаження та перелічувати незавершені вивантаження бакета. Якщо бакет зашифровано ключем KMS, потрібні також права на цей ключ. На сервері Amazon EC2 можна працювати без ключа: агент використовує IAM-роль сервера.
  • ПеревіркаЗапустіть завдання кнопкою «Запустити зараз», подивіться на результат і виконайте тестове відновлення, перш ніж покладатися на резервну копію.

Поширені помилки

ПомилкаПричинаЩо робити
AccessDeniedБракує права, або шлях у правах інший.Перевірте права користувача.
SignatureDoesNotMatchНеправильний ключ або пробіли в його значенні.Скопіюйте ключ ще раз.
PermanentRedirectРегіон у налаштуваннях не збігається з регіоном бакета.Виправте регіон.
NoSuchBucketНеправильна назва бакета.Виправте назву.
RequestTimeTooSkewedНеправильний годинник сервера.Синхронізуйте годинник через NTP.

restore.replace_cycle

Backup-Restore-Replace

Цикл перебудовує робочу базу даних. Агент робить резервну копію gbak, відновлює її в новий файл і ставить новий файл на місце старого. Нова база даних не має сміття, її індекси свіжі, і зазвичай вона значно менша. Робоча база даних від'єднується та безпечно перейменовується: агент спершу переводить її в shutdown full, усі з'єднання закриваються, і лише потім файл отримує нову назву.

За замовчуванням цикл запускається в суботу о 02:00; розклад можна змінити. Запустити зараз запускає цикл негайно, але спершу просить ввести ім'я файлу бази даних. Базу даних можна задати шляхом або псевдонімом з databases.conf.

    Клієнти

    підключення sales.fdb

    Файли на диску

    Від вимкнення до заміни клієнти отримують «database not found» або «database shutdown». Плануйте цикл на час, коли база даних може бути недоступною протягом резервного копіювання та відновлення. У режимі pipe резервне копіювання та відновлення виконуються одночасно, і файл резервної копії не записується.

    Цикл не запускається, якщо

    • «Дозволити заміну» (allow_replace) не увімкнено в завданні;
    • база даних перебуває у стані вимкнення, зашифрована або є реплікою;
    • база даних є базою безпеки — власною або для інших баз даних;
    • поруч із нею є файли незавершеного циклу;
    • недостатньо місця на диску.

    Місце обчислюється заздалегідь: файл резервної копії та відновлена копія перебувають на диску одночасно, кожна приблизно розміром із базу даних. Оригінал перейменовується, а не копіюється, тому місця не займає. Якщо місця мало, цикл зупиняється до вимкнення: база даних не змінюється, і клієнти продовжують працювати.

    Що залишається на диску

    Оригінали. Останні оригінали у стані вимкнення (shutdown full) зберігаються поруч із базою даних, від 1 до 10, за замовчуванням 1. Зайві видаляються на початку наступного циклу, тож база даних у стані перед останнім циклом завжди є.

    Файл резервної копії видаляється після заміни. Якщо відновлення не вдалося, файл зберігається як .restore-failed.fbk для аналізу.

    Щоб повернутися до оригіналу: зупиніть робочу базу даних, перейменуйте файли та виконайте gfix -online для оригіналу.

    Коли цикл переривається

    Хтось може зупинити агента, сервер може перезавантажитися, живлення може зникнути. У разі звичайної зупинки служби до заміни агент дає gbak завершити роботу та відкочує цикл. На випадок збою перед кожним кроком агент записує свої дії у файл намірів. Під час запуску й далі щохвилини агент читає ці файли та приводить цикл до відомого стану.

    До перейменування

    База даних повертається в онлайн

    Агент переводить базу даних в онлайн і відновлює затримку вимкнення.

    До заміни

    Відкат

    Проміжна копія та незавершена резервна копія видаляються, оригінал отримує стару назву та переходить в онлайн.

    Після заміни

    Завершення

    Нова база даних залишається в роботі, оригінал зберігається у стані вимкнення. Скрипт «після» не виконався: виконайте його самостійно, якщо це важливо.

    Якщо файли на диску не відповідають жодному відомому стану, агент нічого не змінює, і результат завдання починається з «потрібен оператор». Файл намірів містить назви всіх файлів циклу. Розмістіть правильну базу даних за її шляхом, і агент завершить відновлення самостійно.

    Ваші власні скрипти до та після

    Скрипт «перед резервним копіюванням» виконується перед вимкненням. Якщо він завершується помилкою, цикл зупиняється, і база даних не змінюється. Скрипт «після відновлення» виконується після заміни. Приклад: скопіюйте файл резервної копії до архіву, перш ніж агент його видалить.

    ЗміннаПеред резервним копіюваннямПісля відновлення
    FBAGENT_HOOK_PHASEprepost
    FBAGENT_JOB_IDідентифікатор завдання
    FBAGENT_DB_NAMEназва в завданні: псевдонім або шлях
    FBAGENT_DB_PATHфайл бази даних: оригінал, онлайнтой самий шлях: нова база даних, онлайн
    FBAGENT_ORIG_PATHпорожньошлях до оригіналу
    FBAGENT_FBK_PATHмайбутній файл резервної копії; порожньо в режимі pipeфайл резервної копії, видаляється після скрипта; порожньо в режимі pipe

    Інвентаризація · звіт про стан

    Контроль: у якої бази даних немає резервної копії

    Інвентаризація показує всі файли резервних копій на сервері, зокрема створені іншими програмами. Агент оновлює її після кожного резервного копіювання та повністю кожні 2 години. Поруч розміщено таблицю відновлень: тестових і робочих, за 14 днів.

    Кожна резервна копія має стовпець Перевірено: тестове відновлення пройшло, не вдалося або не виконувалося. Поруч — розмір відновленої бази даних і час gbak. Таблиця відновлень показує розмір бази даних і тривалість.

    Звіт про стан сервера позначає базу даних без зареєстрованих резервних копій і вказує причину: завдання не вдалося, ще виконується, відкладено або в папках немає файлу. Кнопка поруч із виявленням одразу відкриває форму для нового завдання.

    Інвентаризація. Тестове відновлення кожної копії не вдається, і ви бачите це одразу. Файли без власного завдання позначено ORPHANED.
    Виявлення у звіті. «Немає резервних копій для бази даних»: додайте завдання nbackup або gbak однією кнопкою.

    ← Повернутися до огляду HQbird 2027