HandyCafe Docs
it-admin owner

Maintenance ng Database

Ang Database Maintenance page ang sentro ng backup at pangangalaga para sa lokal na HandyCafe database. Mula sa page na ito maaari mong suriin ang kalusugan ng database, magpatakbo ng mga one-off na maintenance task, mag-iskedyul ng awtomatikong maintenance at backup, at ibalik ang server mula sa nakaraang snapshot.

Database Health

Ipinapakita ng Database Health section ang kasalukuyang estado ng database. Gamitin ang Refresh button para muling i-load ang mga halagang ito kahit anong oras.

Inuulat ng health dashboard ang sumusunod:

  • Database size: Kabuuang laki ng pangunahing database file.
  • Write-ahead log: Laki ng write-ahead log (WAL) file.
  • Page count: Bilang ng mga page na hawak ng database file.
  • Free pages: Bilang ng mga hindi nagagamit na page sa freelist na maaaring bawiin ng isang vacuum.
  • Last backup: Timestamp ng pinakahuling backup. Ipinapakita ang Never run kung wala pang backup na nakuha.
  • Last maintenance: Timestamp ng pinakahuling vacuum.
  • Last integrity check: Timestamp ng pinakahuling integrity check, na may status indicator na nagpapakita kung malusog ang database o kung may natuklasang problema.
  • Log entries: Bilang ng mga row na kasalukuyang naka-store sa audit log.

Sa ilalim ng mga numerong ito, inililista din ng section ang Journal mode, Auto-vacuum setting, Page size, at ang bilang ng Backups on disk.

I-expand ang Tables entry para makita ang per-table row count para sa bawat table sa database.

Manual Actions

Nagpapatakbo ang Manual Actions section ng isang one-off na maintenance task kaagad. Isang action lamang ang maaaring tumakbo sa isang pagkakataon. Nagpapakita ang bawat action ng confirmation toast kapag natapos ito, at may ilang action na nagpapakita ng result summary sa itaas ng section na ito.

  • Back up now: Gumagawa ng atomic snapshot ng kasalukuyang database. Lumalabas ang bagong snapshot sa Backup History list.
  • Vacuum: Binabawi ang mga hindi nagagamit na page at dini-defragment ang database file. Iniuulat ng result summary ang laki bago, ang laki pagkatapos, ang naibalik na espasyo, at ang tagal.
  • Integrity check: Nagpapatakbo ng buong corruption check. Mas mabagal ito ngunit masusi. Bumubukas ang resulta sa Integrity Report dialog.
  • Quick check: Nagpapatakbo ng mabilis na structural sanity check. Bumubukas din ang resulta sa Integrity Report dialog.
  • Analyze: Ina-update ang query planner statistics.
  • Optimize: Nagpapatakbo ng incremental optimizer ng SQLite.
  • Truncate WAL: Ini-flush at pinaiikli ang write-ahead log file. Iniuulat ng result summary ang WAL frame count, ang bilang ng mga checkpointed frame, at ang tagal.
  • Clean old logs: Binubura ang mga log entry na mas matanda sa naka-configure na retention window. Iniuulat ng result summary ang mga row na nabura, ang mga row na natira, at ang tagal.

Integrity Report

Pagkatapos ng integrity check o quick check, bumubukas ang Integrity Report dialog. Kapag malusog ang database, kinukumpirma nito na napatunayan ang integridad ng database. Kapag nag-ulat ng problema ang SQLite, inililista ng dialog ang mga isyu at inirerekomenda na ibalik mula sa kilalang-maganda na backup. Ipinapakita rin ng dialog ang tagal ng pagsusuri.

Auto Maintenance

Ini-iskedyul ng Auto Maintenance section ang vacuum, integrity check, at logs cleanup para tumakbo nang awtomatiko.

  • Enable scheduled maintenance: Ino-on o ino-off ang scheduled maintenance cycle.
  • Frequency: Pumili ng Daily, Weekly, o Monthly.
  • Hour of day: Piliin ang lokal na oras kung kailan tumatakbo ang cycle.

Auto Backup

Kumukuha ang Auto Backup settings ng regular na snapshot para hindi kailanman mabura ng isang corruption ang isang araw na data.

  • Enable scheduled backups: Ino-on o ino-off ang scheduled backups.
  • Frequency: Pumili ng Daily, Weekly, o Monthly.
  • Hour of day: Piliin ang lokal na oras kung kailan tumatakbo ang backup.
  • Keep most recent: Ang bilang ng mga snapshot na pananatilihin, sa pagitan ng 1 at 365. Inaalis ang mga mas lumang snapshot na lampas sa bilang na ito.
  • Backup folder: Ang direktoryo kung saan naka-store ang mga snapshot. Iwanang blangko ito para gamitin ang default folder sa loob ng application data directory.

Log Retention

Kinokontrol ng Log Retention setting kung gaano katagal pinananatili ang mga audit log entry bago alisin sa panahon ng maintenance. Itakda ang Retention (days) value gamit ang slider. Ang suportadong hanay ay 7 hanggang 730 araw.

Gamitin ang Save button sa ibaba ng section na ito para i-store ang mga setting ng Auto Maintenance, Auto Backup, at Log Retention.

Backup History

Inililista ng Backup History section ang mga snapshot na naka-store nang lokal. Para sa bawat backup, ipinapakita ng table ang:

  • File: Ang pangalan ng snapshot file.
  • Created: Ang petsa at oras na kinuha ang snapshot.
  • Size: Ang laki ng snapshot file.
  • Source: Kung paano na-trigger ang backup. Scheduled para sa awtomatikong backup, Startup para sa mga backup na kinuha kapag nagsisimula ang application, at Manual para sa mga backup na ginawa gamit ang Back up now.

May dalawang action ang bawat row:

  • Restore: Pinapalitan ang tumatakbong database ng napiling snapshot. Bago ang pagpapalit, awtomatikong nasi-save ang isang pre-restore safety copy ng kasalukuyang database. Pagkatapos ay nagsasara at nagre-restart ang application para mag-take effect ang snapshot. Hihingin sa iyong kumpirmahin bago magsimula ang restore.
  • Delete: Inaalis ang snapshot file mula sa disk. Hihingin sa iyong kumpirmahin bago burahin ang file. Hindi ito mababawi.

Kung wala pang snapshot, hinihikayat ka ng section na patakbuhin ang Back up now o maghintay sa susunod na scheduled cycle.

Cloud Backup

Inilalarawan ng Cloud Backup section ang mga off-site na naka-encrypt na snapshot na naka-store sa mga HandyCafe server, na maibabalik mula sa anumang HandyCafe install.

Naka-marka ang feature na ito bilang Coming soon at hindi pa available. Ang toggle at configuration fields ay nasi-save nang lokal kaya handa na ang mga setting kapag nabuksan ang feature para sa iyong account. Ang mga available na field ay Enable cloud backup, isang opsyon na i-back up din ang media assets tulad ng mga logo, poster, at idle screen, ang Endpoint, at ang Bucket / storage zone.

Mahahalagang Tala

  • Ang restore ay nagsasara at nagre-restart sa server application. Ipaalam sa anumang aktibong session bago ka mag-restore.
  • Palaging nagse-save muna ang restore ng pre-restore safety copy ng kasalukuyang database, kaya maaaring ibalik ang isang restore sa pamamagitan ng pagbabalik ng safety copy na iyon.
  • Panatilihin ang backup folder sa storage na may sapat na libreng espasyo para sa bilang ng mga snapshot na nakatakda sa Keep most recent.
  • Ang pagpapatakbo ng integrity check o vacuum sa isang malaking database ay maaaring umubos ng oras. Isang manual action lamang ang tumatakbo sa isang pagkakataon.