الأرق وفقدان البيانات: خطوات الاستعادة وخيارات النقل

ملخص سريع

إذا قمت بالترقية إلى Insomnia 8.0 وفقدت الوصول إلى مجموعاتك، فمن المحتمل أن بياناتك لا تزال موجودة على القرص. يوضح لك هذا الدليل كيفية العثور عليها، واستعادتها من قاعدة بيانات SQLite، والترحيل بسلاسة إلى Apidog أو بديل آخر. تصرف قبل تثبيت أي تحديثات أخرى قد تقوم بالكتابة فوق ملفات النسخ الاحتياطي الخاصة بك.

مقدمة

صدر تحديث Insomnia 8.0 في سبتمبر 2023 مع تسجيل دخول إلزامي عبر السحابة. بالنسبة للعديد من المستخدمين، أدت الترقية إلى نتيجة مربكة: فتح التطبيق على شاشة تسجيل الدخول، وبدت المجموعات التي بنوها على مدار شهور أو سنوات وكأنها اختفت.

كانت بعض حالات فقدان البيانات حقيقية – خاصة في الحالات التي أدت فيها مساحة التخزين المؤقتة (scratch storage) إلى تلف البيانات على أنظمة معينة. ولكن في كثير من الحالات، ظلت ملفات قاعدة بيانات SQLite الأساسية سليمة على القرص، ولكنها غير قابلة للوصول إليها عبر واجهة المستخدم الجديدة بدون حساب Kong.

هذا الدليل مخصص لكلتا الحالتين. إذا كانت بياناتك لا تزال موجودة، فسوف تكتشف كيفية استعادتها. وإذا فقدت مساحة التخزين المؤقتة بياناتك بالفعل، فسوف تكتشف خيارات الاسترداد المتاحة وكيفية تجنب نفس المشكلة في المستقبل عن طريق الترحيل إلى أداة بنموذج "محلي أولاً" أكثر موثوقية.

الخطوة 1: العثور على ملفات قاعدة بيانات Insomnia الموجودة لديك

قبل القيام بأي شيء آخر – قبل إعادة التثبيت، قبل إنشاء حساب Kong، قبل فتح Insomnia مرة أخرى – حدد موقع ملفات قاعدة البيانات الموجودة لديك وانسخها إلى مكان آمن.

قام Insomnia بتخزين البيانات في مواقع مختلفة اعتمادًا على الإصدار ونظام التشغيل.

نظام macOS:

~/Library/Application Support/Insomnia/

نظام Windows:

C:\Users\[Username]\AppData\Roaming\Insomnia\

نظام Linux:

~/.config/Insomnia/

داخل هذا الدليل، ابحث عن هذه الملفات:

• insomnia.db – قاعدة البيانات الرئيسية (الإصدارات القديمة)
• دليل يسمى core/ يحتوي على ملفات .db – شائع في الإصدارات التي سبقت 8.0
• workspaces/ – قد يحتوي على ملفات JSON المصدرة من عمليات تصدير سابقة

انسخ دليل دعم تطبيق Insomnia بالكامل إلى موقع احتياطي الآن. لا تتخطى هذه الخطوة. إذا قمت بتشغيل أي ترقيات أخرى أو إلغاء تثبيت/إعادة تثبيت Insomnia، فهناك خطر أن يتم الكتابة فوق هذه الملفات أو حذفها.

الخطوة 2: محاولة الاسترداد عبر واجهة مستخدم Insomnia

إذا لم تكن قد سجلت الدخول إلى حساب Kong بعد، فجرّب مسار التخزين المؤقت أولاً. عندما يعرض Insomnia شاشة تسجيل الدخول، ابحث عن رابط أو زر يقول شيئًا مثل "الاستخدام بدون حساب" أو "المتابعة باستخدام التخزين المحلي". لقد تغيرت الصياغة الدقيقة عبر الإصدارات.

إذا تمكنت من الدخول إلى التطبيق دون تسجيل الدخول، فقم بتصدير كل مساحة عمل على الفور:

1. انقر فوق اسم مساحة عمل في الشريط الجانبي الأيسر
2. انتقل إلى قائمة مساحة العمل (ثلاث نقاط أو أيقونة الترس)
3. اختر "تصدير"
4. حدد تنسيق "Insomnia v4 (JSON)"
5. احفظ الملف في مكان آمن
6. كرر ذلك لكل مساحة عمل

إذا كان لديك بالفعل حساب Kong ويمكنك تسجيل الدخول، فقم بنفس عملية التصدير. تمنحك تجربة تسجيل الدخول الوصول إلى مساحات العمل المتزامنة الخاصة بك، والتي قد تكون أكثر اكتمالًا مما هو موجود على القرص إذا كنت تقوم بالمزامنة مسبقًا.

الخطوة 3: استرداد البيانات مباشرة من قاعدة بيانات SQLite

إذا لم تمنحك واجهة المستخدم الوصول إلى بياناتك، يمكنك استخراجها مباشرة من ملف قاعدة البيانات. يتطلب هذا أداة متصفح SQLite مجانية.

تثبيت DB Browser for SQLite. قم بتنزيله من sqlitebrowser.org. إنه مجاني ومفتوح المصدر ومتاح لأنظمة macOS و Windows و Linux.

افتح ملف قاعدة البيانات الخاص بك. في DB Browser، انتقل إلى ملف > فتح قاعدة بيانات (File > Open Database) وتصفح إلى دليل دعم تطبيق Insomnia. افتح insomnia.db أو أي ملف .db تجده هناك.

استكشف المخطط. تحتوي قاعدة بيانات Insomnia على عدة جداول تهمك:

• Workspace – مساحات العمل ذات المستوى الأعلى
• RequestGroup – المجلدات داخل مساحات العمل
• Request – الطلبات الفردية
• Environment – مجموعات المتغيرات البيئية
• Response – سجل الاستجابات المخزنة (اختياري للاسترداد)

تصدير البيانات. في علامة التبويب "استعراض البيانات" (Browse Data)، حدد كل جدول واستخدم ملف > تصدير > جدول كملف CSV (File > Export > Table as CSV) لحفظ البيانات الخام. بالنسبة للطلبات، الحقول الرئيسية هي name، url، method، headers (المخزنة بتنسيق JSON)، و body.

إعادة بناء المجموعات. يمنحك نهج CSV البيانات الخام لإعادة البناء منها. إنه أمر ممل ولكنه موثوق. لاتباع نهج برمجي، يمكنك استخدام وحدة sqlite3 في بايثون للاستعلام عن قاعدة البيانات وكتابة نص برمجي للتصدير.

إليك نص برمجي بايثون بسيط لاستخراج الطلبات من قاعدة بيانات Insomnia أقدم:

import sqlite3
import json

conn = sqlite3.connect('/path/to/insomnia.db') # الاتصال بقاعدة البيانات الخاصة بك
cursor = conn.cursor()

cursor.execute("SELECT name, url, method, headers, body FROM Request") # تنفيذ استعلام لاسترداد بيانات الطلبات
rows = cursor.fetchall()

for row in rows:
    print(f"Name: {row[0]}") # طباعة اسم الطلب
    print(f"Method: {row[2]} {row[1]}") # طباعة طريقة الطلب وعنوان URL
    if row[3]:
        headers = json.loads(row[3]) # تحليل رؤوس الطلبات المخزنة كـ JSON
        for h in headers:
            print(f"  Header: {h.get('name')}: {h.get('value')}") # طباعة كل رأس
    print() # طباعة سطر فارغ للفصل بين الطلبات

conn.close() # إغلاق الاتصال بقاعدة البيانات

قم بتعديل أسماء الحقول بناءً على ما تراه في DB Browser – فقد اختلف المخطط الدقيق عبر إصدارات Insomnia.

الخطوة 4: الاسترداد من النسخ الاحتياطية في حال تلف قاعدة البيانات

إذا كان ملف قاعدة البيانات نفسه تالفًا، فإن الخيارات تكون أكثر محدودية.

تحقق من Time Machine أو النسخ الاحتياطية للنظام. قد تحتوي ميزة Time Machine في macOS، وسجل الملفات في Windows، ومعظم خدمات النسخ الاحتياطي السحابية (مثل Backblaze، iCloud Drive، إلخ) على لقطات (snapshots) لدليل Insomnia الخاص بك من قبل الترقية. قم باستعادة إصدار ما قبل 8.0 من دليل دعم التطبيق إلى موقع منفصل، ثم استخدم DB Browser لقراءة تلك الملفات.

تحقق من سجل Git. تقوم بعض الفرق بإصدار صادرات Insomnia الخاصة بهم في مستودع Git. إذا كانت مؤسستك تفعل ذلك، يمكن استرداد ملفات التصدير من سجل Git.

ابحث عن ملفات تصدير Insomnia. إذا كنت قد قمت بتصدير المجموعات يدويًا في الماضي، فقد تكون ملفات JSON هذه موجودة في مجلد التنزيلات الخاص بك أو دليل المشروع. ابحث في نظام الملفات الخاص بك عن الملفات التي تنتهي بـ .json والتي تحتوي على "insomnia" أو "_collection" في الاسم.

الخطوة 5: الترحيل إلى Apidog

بمجرد أن تكون بياناتك بتنسيق Insomnia v4 JSON (إما من تصدير واجهة المستخدم أو المعاد بناؤها يدويًا)، يستغرق الترحيل إلى Apidog بضع دقائق.

استيراد مجموعاتك.

1. افتح Apidog وأنشئ مشروعًا جديدًا
2. انتقل إلى إعدادات المشروع أو خيار الاستيراد في الشريط الجانبي
3. اختر "استيراد" وحدد "Insomnia"
4. قم بتحميل ملف JSON المُصدَّر
5. سيقوم Apidog بتحليل مساحات العمل والمجلدات والطلبات والبيئات

ما يتم نقله بسلاسة:

• طلبات HTTP (GET, POST, PUT, DELETE, PATCH)
• رؤوس الطلبات (Request headers)
• هيئات الطلبات (JSON, form data, multipart)
• معلمات عنوان URL والمتغيرات المسارية
• المتغيرات البيئية وقيمها
• هيكل المجلدات

ما يتطلب مراجعة يدوية:

• البرامج النصية قبل الطلب وبعده (JavaScript). يستخدم Apidog نموذجًا برمجيًا مشابهًا ولكن قد تحتاج الصياغة إلى تعديل.
• تدفقات المصادقة المخصصة التي اعتمدت على إضافات Insomnia
• تأكيدات اختبار الاستجابة – يجب إعادة إدخال هذه في تنسيق اختبار Apidog

إعداد بيئاتك. بعد الاستيراد، تحقق من أن المتغيرات البيئية تم استيرادها بشكل صحيح. انتقل إلى لوحة البيئات وتحقق من عناوين URL الأساسية ومفاتيح API وأي رموز تم نقلها.

التحقق من وصول الفريق. إذا كنت تقوم بترحيل مساحة عمل فريق، يدعم Apidog مساحات العمل المشتركة مع مزامنة سحابية اختيارية. يمكنك التحكم فيما إذا كانت البيانات تتم مزامنتها مع سحابة Apidog. بالنسبة للفرق، فإن تمكين المزامنة مرة واحدة هو أسهل طريقة لمشاركة المجموعات التي تم ترحيلها.

اختبر بعض الطلبات. اختر خمسة أو ستة طلبات تمثيلية من مجموعتك وقم بتشغيلها لتأكيد أنها تعمل كما هو متوقع. انتبه إلى رؤوس المصادقة واستبدال المتغيرات البيئية.

تجنب هذه المشكلة في المستقبل

الدرس الأساسي من وضع Insomnia 8.0 هو أن الثقة في بيانات عملك الهامة لأداة واحدة بدون استراتيجية نسخ احتياطي أمر محفوف بالمخاطر – بغض النظر عن الأداة التي تستخدمها.

بعض العادات التي تحميك في المستقبل:

• التصدير بانتظام. قم بجدولة تصدير شهري لمجموعاتك إلى مجلد احتياطي أو مستودع Git. يستغرق هذا دقيقتين ويوفر لك مسار استرداد مهما حدث.
• اختر الأدوات ذات التخزين المحلي أولاً. يخزن Apidog البيانات محليًا بشكل افتراضي. يخزن Bruno المجموعات كملفات عادية على القرص. كلاهما يسمح لك برؤية بياناتك ونسخها احتياطيًا دون الاعتماد على سحابة بائع.
• تحقق من نموذج البيانات قبل الترقية. عندما يتم إصدار إصدار رئيسي، اقرأ ملاحظات الترحيل قبل التحديث. إذا غيّر الإصدار مكان أو كيفية تخزين البيانات، فافهم الآثار المترتبة قبل النقر على زر التثبيت.

الأسئلة الشائعة

هل يمكنني استعادة بيانات Insomnia دون تسجيل الدخول إلى Kong؟نعم، إذا كانت ملفات قاعدة البيانات الخاصة بك لا تزال على القرص. استخدم DB Browser for SQLite لفتح ملف .db في دليل دعم تطبيق Insomnia الخاص بك وتصدير البيانات من الجداول مباشرة.

ما التنسيق الذي يجب أن أستخدمه عند تصدير بيانات Insomnia؟استخدم تنسيق Insomnia v4 JSON. هذا هو التنسيق الأكثر دعمًا ويمكن استيراده بواسطة Apidog و Postman وأدوات أخرى.

هل سيتم نقل متغيراتي البيئية إلى Apidog؟في معظم الحالات نعم. يتم تصدير بيئات Insomnia كجزء من تنسيق v4 JSON ويقوم Apidog باستيرادها. راجع البيئات المستوردة للتأكد من صحة القيم، خاصةً بالنسبة للرموز الحساسة.

ما الفرق بين التخزين المؤقت (scratch storage) في Insomnia والتخزين المحلي في الأدوات الأخرى؟كان التخزين المؤقت (scratch storage) في Insomnia وضعًا احتياطيًا يعاني من مشاكل في الموثوقية. يتعامل Apidog و Bruno مع التخزين المحلي كنموذج أساسي، وليس كخيار احتياطي. تتم كتابة البيانات على القرص عند كل حفظ، ولا يتم الاحتفاظ بها في الذاكرة.

هل يمكنني استخدام DB Browser for SQLite على نظام macOS؟نعم. يتوفر DB Browser for SQLite لنظام macOS عبر موقع المشروع وعبر Homebrew (brew install db-browser-for-sqlite).

كم يستغرق الترحيل من Insomnia إلى Apidog؟بالنسبة لمجموعة نموذجية تتكون من 50-200 طلب، يستغرق الاستيراد أقل من خمس دقائق. قد يستغرق مراجعة وتعديل البرامج النصية وتدفقات المصادقة وقتًا أطول اعتمادًا على التعقيد.