Michael Johnsonמחקתם בטעות מסד נתונים של Cloudflare D1? כעת עומדים לרשותכם שבעה ימים ממועד המחיקה כדי לשחזר אותו דרך ה־API. השינוי פורסם ב־23 באוקטובר 2026: בקשות למסדי נתונים שנמחקו לפני יותר משבעה ימים ייכשלו. במקרה חירום, ודאו את מזהה מסד הנתונים ושלחו בקשת undelete בהקדם האפשרי.
מה השתנה
שיטת השחזור מקבלת את מזהה החשבון ואת UUID של מסד הנתונים שנמחק; אפשר להעביר בגוף הבקשה שם חדש. כברירת מחדל, מסד הנתונים משוחזר בשם הקודם. אם מסד נתונים אחר בחשבון כבר משתמש בשם הזה, יש לציין new_name כדי לשחזר את מסד הנתונים. התנאים האלה מופיעים בתיעוד ה־API של D1 undelete.
החלון הוא שבעה ימים, כלומר 7 × 24 שעות. לכן לא מספיק להסתמך על התאריך בלוח השנה: תעדו את שעת המחיקה והשוו אותה לשעת שליחת הבקשה. אם אתם קרובים למגבלה, שלחו תחילה את בקשת השחזור, ואז בדקו את השם ואת הנתונים.
שלבי הפעולה
- אתרו את מסד הנתונים שנמחק. ודאו את מזהה החשבון ואת מזהה מסד הנתונים לפי יומנים, קוד תשתית או פרטי האירוע. נתיב ה־API משתמש ב־UUID של מסד הנתונים; שם התצוגה שלו אינו מספיק לצורך הבקשה.
- בדקו את חלון הזמן. ודאו שחלפו פחות משבעה ימים מאז המחיקה. Cloudflare ממליצה לשלוח את הבקשה מיד לאחר גילוי המחיקה השגויה.
- פתרו התנגשות בשם. אם השם הקודם כבר בשימוש, העבירו ערך פנוי באמצעות
new_name; אחרת אין צורך לשנות את השם. - הפעילו את השיטה המתועדת. ה־API משתמש ב־
POST /accounts/{account_id}/d1/database/{database_id}/undelete. אשרו את הבקשה באמצעות אסימון API בעל ההרשאות הנדרשות, ואל תכללו סודות ביומנים. - בדקו את התוצאה. לאחר קבלת תשובה מוצלחת, ודאו שמסד הנתונים מופיע בחשבון בשם הצפוי, ושהיישום מתחבר למופע הנכון.
Undelete ו־Time Travel מיועדים למשימות שונות
Undelete משחזר מסד נתונים שנמחק. Time Travel משחזר את מצב מסד הנתונים הקיים לנקודת זמן או ל־bookmark. לפי תיעוד Cloudflare, ההיסטוריה זמינה במשך 30 הימים האחרונים; התקופה בפועל תלויה בתוכנית. לאחר undelete, Time Travel אינו יכול להחזיר את מסד הנתונים לנקודת זמן או לסימנייה שקדמו לשחזור. אם יש שגיאה בנתונים של מסד נתונים פעיל, השתמשו ב־Time Travel; אם האובייקט נמחק, השתמשו ב־undelete בתוך פרק הזמן שנקבע.
כדי להיערך לתפעול, הוסיפו בדיקה של חלון שבעת הימים לנוהל התגובה, ושמרו ביומן האירוע את מזהה מסד הנתונים ואת שעת המחיקה. כך תוכלו לשלוח במהירות בקשה תקינה, בלי לבזבז זמן על איתור מזהים או בירור התנגשות בשם.