feat: Phase 3A - Incremental backup scaffolding (types, interfaces, metadata)

Added foundational types for PostgreSQL incremental backups:

Types & Interfaces (internal/backup/incremental.go):
- BackupType enum: full vs incremental
- IncrementalMetadata struct with base backup reference
- ChangedFile struct for tracking modifications
- BackupChainResolver interface for restore chain logic
- IncrementalBackupEngine interface

PostgreSQL Implementation (internal/backup/incremental_postgres.go):
- PostgresIncrementalEngine for file-level incrementals
- FindChangedFiles() - mtime-based change detection
- shouldSkipFile() - exclude temp/lock/socket files
- loadBackupInfo() - read base backup metadata
- Stubs for CreateIncrementalBackup() and RestoreIncremental()

Metadata Extension (internal/metadata/metadata.go):
- Added IncrementalMetadata to BackupMetadata
- Fields: base_backup_id, backup_chain, incremental_files
- Tracks parent backup and restore dependencies

Next Steps:
- Add --backup-type incremental flag to CLI
- Implement backup chain resolution
- Write integration tests

Status: SCAFFOLDING ONLY - not functional yet
This commit is contained in:
2025-11-26 06:22:54 +00:00
parent b460a709a7
commit 1d4aa24817
3 changed files with 316 additions and 1 deletions

View File

@@ -25,10 +25,23 @@ type BackupMetadata struct {
SizeBytes int64 `json:"size_bytes"`
SHA256 string `json:"sha256"`
Compression string `json:"compression"` // none, gzip, pigz
BackupType string `json:"backup_type"` // full, incremental (for v2.0)
BackupType string `json:"backup_type"` // full, incremental (for v2.2)
BaseBackup string `json:"base_backup,omitempty"`
Duration float64 `json:"duration_seconds"`
ExtraInfo map[string]string `json:"extra_info,omitempty"`
// Incremental backup fields (v2.2+)
Incremental *IncrementalMetadata `json:"incremental,omitempty"` // Only present for incremental backups
}
// IncrementalMetadata contains metadata specific to incremental backups
type IncrementalMetadata struct {
BaseBackupID string `json:"base_backup_id"` // SHA-256 of base backup
BaseBackupPath string `json:"base_backup_path"` // Filename of base backup
BaseBackupTimestamp time.Time `json:"base_backup_timestamp"` // When base backup was created
IncrementalFiles int `json:"incremental_files"` // Number of changed files
TotalSize int64 `json:"total_size"` // Total size of changed files (bytes)
BackupChain []string `json:"backup_chain"` // Chain: [base, incr1, incr2, ...]
}
// ClusterMetadata contains metadata for cluster backups