HandyCafe Docs
it-admin owner

데이터베이스 유지 관리

데이터베이스 유지 관리 페이지는 로컬 HandyCafe 데이터베이스의 백업 및 관리 센터입니다. 이 페이지에서 데이터베이스 상태를 점검하고, 일회성 유지 관리 작업을 실행하며, 자동 유지 관리와 백업을 예약하고, 이전 스냅샷에서 서버를 복원할 수 있습니다.

데이터베이스 상태

데이터베이스 상태 섹션은 데이터베이스의 현재 상태를 보여줍니다. 새로 고침 버튼을 사용하여 언제든지 이 값들을 다시 불러올 수 있습니다.

상태 대시보드는 다음 항목을 보고합니다.

  • 데이터베이스 크기: 메인 데이터베이스 파일의 총 크기.
  • 선행 기록 로그: 선행 기록 로그(WAL) 파일의 크기.
  • 페이지 수: 데이터베이스 파일이 보유한 페이지 수.
  • 여유 페이지: vacuum으로 회수할 수 있는 freelist상의 미사용 페이지 수.
  • 마지막 백업: 가장 최근 백업의 타임스탬프. 백업을 한 적이 없으면 실행한 적 없음으로 표시됩니다.
  • 마지막 유지 관리: 가장 최근 vacuum의 타임스탬프.
  • 마지막 무결성 검사: 가장 최근 무결성 검사의 타임스탬프와 함께, 데이터베이스가 정상이었는지 또는 문제가 발견되었는지를 보여주는 상태 표시기가 표시됩니다.
  • 로그 항목: 감사 로그에 현재 저장된 행 수.

이 수치 아래에서 섹션은 저널 모드, 자동 vacuum 설정, 페이지 크기, 디스크상 백업 수도 함께 나열합니다.

테이블 항목을 펼치면 데이터베이스의 모든 테이블에 대한 테이블별 행 수를 볼 수 있습니다.

수동 작업

수동 작업 섹션은 일회성 유지 관리 작업을 즉시 실행합니다. 한 번에 하나의 작업만 실행할 수 있습니다. 각 작업은 완료되면 확인 토스트를 표시하며, 일부 작업은 이 섹션 위에 결과 요약을 표시합니다.

  • 지금 백업: 현재 데이터베이스의 원자적 스냅샷을 생성합니다. 새 스냅샷은 백업 기록 목록에 나타납니다.
  • Vacuum: 미사용 페이지를 회수하고 데이터베이스 파일을 조각 모음합니다. 결과 요약은 작업 전 크기, 작업 후 크기, 회수된 공간, 소요 시간을 보고합니다.
  • 무결성 검사: 전체 손상 검사를 실행합니다. 느리지만 철저합니다. 결과는 무결성 보고서 대화 상자에 열립니다.
  • 빠른 검사: 빠른 구조 점검을 실행합니다. 결과는 마찬가지로 무결성 보고서 대화 상자에 열립니다.
  • 분석: 쿼리 플래너 통계를 업데이트합니다.
  • 최적화: SQLite의 점진적 최적화기를 실행합니다.
  • WAL 자르기: 선행 기록 로그 파일을 플러시하고 자릅니다. 결과 요약은 WAL 프레임 수, 체크포인트된 프레임 수, 소요 시간을 보고합니다.
  • 오래된 로그 정리: 구성된 보존 기간보다 오래된 로그 항목을 삭제합니다. 결과 요약은 삭제된 행 수, 남은 행 수, 소요 시간을 보고합니다.

무결성 보고서

무결성 검사 또는 빠른 검사 후에 무결성 보고서 대화 상자가 열립니다. 데이터베이스가 정상이면 데이터베이스 무결성이 검증되었음을 확인해 줍니다. SQLite가 문제를 보고하면 대화 상자에 문제 목록이 표시되고 정상 상태로 알려진 백업에서 복원할 것을 권장합니다. 대화 상자에는 검사 소요 시간도 표시됩니다.

자동 유지 관리

자동 유지 관리 섹션은 vacuum, 무결성 검사, 로그 정리가 자동으로 실행되도록 예약합니다.

  • 예약 유지 관리 활성화: 예약된 유지 관리 주기를 켜거나 끕니다.
  • 빈도: 매일, 매주, 매월 중에서 선택합니다.
  • 실행 시각: 주기가 실행되는 현지 시각을 선택합니다.

자동 백업

자동 백업 설정은 정기적으로 스냅샷을 생성하여 한 번의 손상으로 하루치 데이터가 모두 사라지는 일이 없도록 합니다.

  • 예약 백업 활성화: 예약된 백업을 켜거나 끕니다.
  • 빈도: 매일, 매주, 매월 중에서 선택합니다.
  • 실행 시각: 백업이 실행되는 현지 시각을 선택합니다.
  • 최근 보관 개수: 보관할 스냅샷 수로, 1에서 365 사이입니다. 이 개수를 초과하는 오래된 스냅샷은 제거됩니다.
  • 백업 폴더: 스냅샷이 저장되는 디렉터리. 애플리케이션 데이터 디렉터리 내의 기본 폴더를 사용하려면 비워 둡니다.

로그 보존

로그 보존 설정은 감사 로그 항목이 유지 관리 중에 제거되기 전까지 얼마나 오래 보관되는지를 제어합니다. 슬라이더로 보존(일) 값을 설정합니다. 지원되는 범위는 7일에서 730일입니다.

이 섹션 하단의 저장 버튼을 사용하여 자동 유지 관리, 자동 백업, 로그 보존 설정을 저장합니다.

백업 기록

백업 기록 섹션은 로컬에 저장된 스냅샷을 나열합니다. 각 백업에 대해 표는 다음을 보여줍니다.

  • 파일: 스냅샷 파일 이름.
  • 생성됨: 스냅샷을 생성한 날짜와 시간.
  • 크기: 스냅샷 파일의 크기.
  • 출처: 백업이 어떻게 실행되었는지. 자동 백업은 예약됨, 애플리케이션 시작 시 생성된 백업은 시작 시, 지금 백업으로 생성된 백업은 수동으로 표시됩니다.

각 행은 두 가지 작업을 제공합니다.

  • 복원: 실행 중인 데이터베이스를 선택한 스냅샷으로 교체합니다. 교체 전에 현재 데이터베이스의 복원 전 안전 사본이 자동으로 저장됩니다. 그런 다음 스냅샷이 적용되도록 애플리케이션이 종료되고 재시작됩니다. 복원이 시작되기 전에 확인을 요청합니다.
  • 삭제: 스냅샷 파일을 디스크에서 제거합니다. 파일이 삭제되기 전에 확인을 요청합니다. 이 작업은 되돌릴 수 없습니다.

아직 스냅샷이 없으면 섹션은 지금 백업을 실행하거나 다음 예약 주기를 기다리도록 안내합니다.

클라우드 백업

클라우드 백업 섹션은 HandyCafe 서버에 저장되어 어떤 HandyCafe 설치본에서든 복원할 수 있는 오프사이트 암호화 스냅샷을 설명합니다.

이 기능은 곧 제공으로 표시되어 있으며 아직 사용할 수 없습니다. 토글과 구성 필드는 로컬에 저장되어, 이 기능이 사용자 계정에 열리면 설정이 바로 준비되어 있도록 합니다. 사용 가능한 필드는 클라우드 백업 활성화, 로고, 포스터, 대기 화면 같은 미디어 자산도 함께 백업하는 옵션, 엔드포인트, 버킷 / 스토리지 영역입니다.

중요 사항

  • 복원은 서버 애플리케이션을 종료하고 재시작합니다. 복원하기 전에 활성 세션에 알리세요.
  • 복원 시 항상 현재 데이터베이스의 복원 전 안전 사본이 먼저 저장되므로, 그 안전 사본을 복원하면 복원을 되돌릴 수 있습니다.
  • 최근 보관 개수에 설정한 스냅샷 수를 보관하기에 충분한 여유 공간이 있는 저장소에 백업 폴더를 두세요.
  • 대용량 데이터베이스에서 무결성 검사나 vacuum을 실행하면 시간이 걸릴 수 있습니다. 한 번에 하나의 수동 작업만 실행됩니다.