Michael Johnsonهل حذفت قاعدة بيانات Cloudflare D1 عن طريق الخطأ؟ أصبح أمامك الآن سبعة أيام من وقت الحذف لاستعادتها عبر واجهة API. نُشر التغيير في 23 أكتوبر 2026: وتُرفض الطلبات المقدمة لقواعد حُذفت منذ أكثر من سبعة أيام. عند وقوع حادث، تحقّق من معرّف القاعدة وأرسل طلب undelete في أسرع وقت ممكن.
ما الذي تغيّر
تتطلب طريقة الاستعادة معرّف الحساب والـUUID الخاص بقاعدة البيانات المحذوفة؛ ويمكن تضمين اسم جديد في متن الطلب. تُستعاد القاعدة باسمها السابق افتراضيًا. وإذا كان هناك بالفعل قاعدة أخرى في الحساب تستخدم الاسم نفسه، فيجب تحديد new_name لاستعادة القاعدة. وترد هذه الشروط في مرجع واجهة D1 undelete API.
المهلة سبعة أيام، أي 7 × 24 ساعة. لذلك لا يكفي الاعتماد على التاريخ التقويمي وحده: سجّل وقت الحذف وقارنه بوقت إرسال الطلب. وإذا أوشكت المهلة على الانتهاء، فأرسل طلب الاستعادة أولًا، ثم تحقّق من الاسم والبيانات.
خطوات العمل
- اعثر على قاعدة البيانات المحذوفة. تحقّق من معرّف الحساب ومعرّف قاعدة البيانات بالرجوع إلى السجلات أو شيفرة البنية التحتية أو تفاصيل الحادث. يستخدم مسار واجهة API المعرّف UUID للقاعدة؛ ولا يكفي اسمها الظاهر لإرسال الطلب.
- تحقّق من المهلة. تأكّد من أن أقل من سبعة أيام قد مضت على الحذف. وتنصح Cloudflare بإرسال الطلب فور اكتشاف الحذف بالخطأ.
- حلّ تعارض الاسم. إذا كان الاسم السابق مستخدمًا بالفعل، فأرسل قيمة متاحة عبر
new_name؛ وإلا فلا حاجة إلى تغيير الاسم. - استدعِ الطريقة الموثّقة. تستخدم واجهة API المسار
POST /accounts/{account_id}/d1/database/{database_id}/undelete. صادِق الطلب باستخدام رمز API ذي الصلاحيات اللازمة، ولا تضع السر في السجلات. - تحقّق من النتيجة. بعد نجاح الاستجابة، تأكّد من ظهور القاعدة في الحساب بالاسم المتوقع، ومن اتصال التطبيق بالمثيل الصحيح.
يؤدي Undelete وTime Travel مهمتين مختلفتين
يعيد Undelete قاعدة بيانات محذوفة، بينما يستعيد Time Travel حالة قاعدة موجودة وفقًا لوقت أو إشارة مرجعية. وتشير وثائق Cloudflare إلى أن السجل متاح للأيام الثلاثين السابقة؛ وتعتمد المدة الفعلية على الخطة. وبعد استخدام undelete، لا يستطيع Time Travel إعادة القاعدة إلى نقطة أو وقت يسبق الاستعادة. عند حدوث خطأ في بيانات قاعدة عاملة، استخدم Time Travel؛ أما الكائن المحذوف، فاستخدم معه undelete ضمن المهلة المحددة.
لأغراض التشغيل، أدرج التحقق من مهلة الأيام السبعة في إجراءات الاستجابة للحوادث، واحتفظ بمعرّف القاعدة ووقت حذفها في سجل الحادث. سيساعد ذلك على إرسال طلب صحيح بسرعة، وتجنّب إضاعة الوقت في البحث عن المعرّفات أو التحقق من تعارض الاسم.
