Skip to content
palmoni5 edited this page Nov 5, 2026 · 3 revisions

גיבוי ושחזור — למפתחים

BackupService אוסף את הנתונים האישיים לפורמט JSON מגרסה 2.0. השחזור תומך גם בגיבויים מגרסה 1.0. למשתמש: גיבוי והעברה למחשב אחר.

יחידת הגיבוי היא סעיף, לא העתקה של תיקיית הנתונים

לכל סעיף קיים דגל ב־includes. תוכן שלא נאסף או שלא היה ניתן לגבות מדווח ב־partial_sections; יש להעביר את המידע הזה עד לממשק.

סעיף מקורות ותוכן נלווים
הגדרות מפתחות ההגדרות הניידים, הגדרות לכל ספר, תורי דיווח ועותק עקבי של user_books.db כאשר ניתן לגבותו
סימניות סימניות וקבוצות סימניות מתוך מצב המשתמש
היסטוריה רשומות ההיסטוריה
הערות נתוני ההערות האישיות
שולחנות עבודה שולחנות, בחירת השולחן וכרטיסיות/סשני חלונות פתוחים
שמור וזכור המפתחות של הכלי בהגדרות
תוספים פרטי התקנה ותוכן הנתונים הנתמך, בכפוף למגבלות גודל ואימות

רשימות המשתמש וסשני החלונות נשמרים כיום ב־user_state.db, ולא בקופסאות Hive נפרדות. ההגדרות עדיין נשענות על ה־box שלהן.

איסוף הגדרות

המקור המועדף הוא סריקת כל מפתחות ה־box, עם החרגה של nonPortableSettingsKeys. בכך הגדרה חדשה אינה נעלמת מגיבוי רק משום שלא הוסיפו אותה לרשימה ידנית.

כשאין גישה ל־box נאספים מפתחות fallback והגיבוי מסומן חלקי. השדה settingsSource מאפשר לשחזור להבחין בין מקור מלא לבין גיבוי ישן או חלקי. נתיבי runtime מחושבים, אסימוני התחברות והסכמות ייעודיות להתקנה אינם מידע שמעבירים באופן עיוור למחשב אחר.

מה אינו כלול

backedUpStores ו־unbackedStores מתעדים את הכיסוי. קובצי הספרים בתיקיות האישיות, קובצי מסדים מצורפים, הספרייה הראשית, אינדקסים ומטמונים אינם נכנסים אוטומטית רק מפני שנתיביהם נכללים בהגדרות.

עותק user_books.db נוצר ב־VACUUM INTO לקבלת תמונת מצב עקבית. הוא כפוף לתקרת גודל; כשל או חריגה חייבים להיראות כגיבוי חלקי.

גיבוי ידני לעומת אוטומטי

  • ידני: קובץ עצמאי; נתונים בינאריים נתמכים מוטמעים בו. שם הקובץ מסומן _manual, והרוטציה אינה מוחקת אותו.
  • אוטומטי: יכול להפנות לאובייקטים ב־BackupStore. העתקת קובץ JSON לבדו אינה העברת כל הנתונים.
  • בדיקת תדירות: נעשית כשאוצריא פועלת, ובעלייה לאחר שער החשיפה. קיימים גם תנאים הנוגעים לשינויים ולמצב הנתונים; אין scheduler חיצוני שמבטיח גיבוי כשהתוכנה סגורה.
  • מובייל: לאחר יצירה, הממשק מציע ייצוא של הגיבוי הידני. אין להסתפק בפתיחת תיקייה פנימית שנמחקת עם האפליקציה.

מחסן ורוטציה

BackupStore שומר אובייקטים לפי SHA-256 תחת store/objects, עם דחיסה וניכוי כפילויות. ניקוי האובייקטים מסמן הפניות מהגיבויים ומהארכיון לפני מחיקה, וכולל תקופת חסד.

BackupRotation מיישם חלונות שמירה לפי פרופיל:

פרופיל גיבויים יומיים חלון שבועי חלון חודשי
חסכוני 3 ימים 30 ימים 90 ימים
מאוזן 7 ימים 60 ימים 365 ימים
שמור הכל ללא רוטציה ללא רוטציה ללא רוטציה

זו מדיניות בחירת נקודות זמן, לא הבטחה שכל גיבוי בתוך כל טווח יישאר כקובץ נפרד.

ארכיון מתגלגל

BackupMaintenance ממזג גיבויים המיועדים לניקוי לארכיון ורק לאחר כתיבה מאומתת מסיר את המקורות. BackupMerge מיישם זהות ומדיניות לפי סוג הפריט.

הארכיון עשוי להכיל פריטים שנמחקו מהנתונים הפעילים. הוא אינו ״כל מה שגובה אי־פעם״: קיים archiveItemMaxAge של שלוש שנים לפריטים שעליהם חלה מדיניות הגיזום, וסעיפים מסוימים מייצגים תמונת מצב ולא היסטוריה מלאה.

זהות ספר חייבת להבחין בין מקור, גרסה וסוג תוכן. איחוד שגוי של PDF וטקסט או של שתי גרסאות עלול להצמיד סימנייה למקום לא נכון.

שחזור רגיל וייבוא ממזג

השחזור קורא את includes, מאמת גרסה ונתיבים, ומחפש את מחסן האובייקטים קודם ליד קובץ הגיבוי ואחר כך בתיקיית הגיבויים המוגדרת.

  • שחזור רגיל מחליף את הסעיפים הכלולים בהתאם למימושם; יש להציג אישור והודעה על חלקים חסרים.
  • ייבוא ממזג אינו מחליף את ההגדרות והכרטיסיות הפתוחות. הוא מוסיף או מעדכן לפי כללי הזהות של כל סעיף, ושולחנות העבודה מיובאים כשולחנות חדשים.
  • תוספים משוחזרים חוזרים מושבתים. אין להפעיל הרשאות ופעולות רקע כתופעת לוואי שקטה של שחזור.
  • הערות: כאשר עיגון למילים אינו ניתן לשחזור, המידע הזה מדווח ולא מוסתר כהצלחה מלאה.
  • תיקיות ומסדים מצורפים: יש לרענן את הרישום ולדווח על נתיבים שאינם קיימים.

אין לתאר ייבוא ממזג כ״המקומי תמיד מנצח״ לכל סוג נתון: ההכרעה שונה בין סימניות, הערות, שולחנות ותוספים. בדוק את BackupImportMerge ואת פונקציות השחזור הנוגעות לסעיף שאתה משנה.

שינוי הכיסוי

כשמוסיפים מקום אחסון או סעיף חדש, עדכן את הצהרת הכיסוי ובדוק יצירה, שחזור, ייבוא ממזג, גיבוי חלקי וארכיון. קיימת בדיקת כיסוי אחסון כדי לזהות מקומות שלא קיבלו מדיניות.

מקורות ודפים קשורים

Clone this wiki locally