الحفظ والتثبيت في DBeaver: دليل أوضاع المعاملات

يُرسل إجراء الحفظ في DBeaver تعديلات الشبكة غير المحفوظة للتنفيذ. ويُنهي إجراء التثبيت العمل المعلّق المدعوم في المعاملة المرتبطة. ويعتمد ما إذا كان الحفظ يثبّت التغييرات أيضًا على وضع المعاملة الفعلي وسلوك قاعدة البيانات، كما يوضح مرجع محرّر البيانات ومرجع أوضاع المعاملات.

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

يشرح هذا الدليل كيفية التمييز بين هذه الحالات قبل الإبلاغ عن إنجاز العمل. ويفترض امتلاك صلاحية الوصول إلى قاعدة بيانات تطوير مخصّصة للتجربة يمكن الاستغناء عنها. لم يُنفَّذ التمرين أدناه لأغراض هذا المقال.

تعرّف على الحالات الثلاث للتعديل في DBeaver

تغييرات غير محفوظة في الشبكة

قد يظل تعديل الخلية عملًا محليًا غير محفوظ. يُرسل الحفظ الإضافات والتعديلات وعمليات الحذف غير المحفوظة للتنفيذ، بينما يتخلّص الإلغاء من التعديلات غير المحفوظة. وتُميّز عناصر التحكّم الموثّقة بين هذين الإجراءين. فتغيّر الخلية وحده لا يثبت إرسال التعديل ولا تثبيته.

للمطوّرين الذين يبنون مؤشرات حالة مماثلة، يتناول دليلنا لحفظ الحالة في Tiptap الفجوة بين التعديلات المحلية وإقرارات الاستلام من الواجهة الخلفية. ونموذج تخزين المستندات فيه منفصل عن التحكّم في معاملات SQL.

تغييرات نُفّذت ضمن معاملة مفتوحة

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

تغييرات مثبّتة وما يبقى للتحقّق منه

يُنهي التثبيت العمل المعلّق المدعوم. ويثبّت وضع التثبيت التلقائي العادي العبارات بعد تنفيذها، وفقًا لقواعد أوضاع المعاملات. ومع ذلك، عليك التحقّق من تغيّر السجل المقصود في الوجهة المقصودة.

يغطي المخطّط تغييرات الصفوف الناجحة والمدعومة. ولا يشمل أخطاء التنفيذ والعبارات ذات السلوك المختلف في المعاملات.

الحفظ والتثبيت والإلغاء والتراجع: اختر الإجراء المناسب

تعمل عناصر التحكّم في نقاط مختلفة من دورة التعديل. يجمع هذا الجدول بين عناصر التحكّم في محرّر البيانات ودلالات المعاملات في DBeaver.

في وضع التثبيت التلقائي العادي، يثبّت الحفظ العبارات الناتجة. ويترك الوضع اليدوي التغييرات المدعومة معلّقة. وعند تفعيل التثبيت الذكي، يمكنه التحويل إلى الوضع اليدوي قبل الإرسال. لذا فإن تعطيل زر الحفظ لا يوفّر معلومات كافية للإبلاغ عن تثبيت التغيير.

عاين SQL قبل الحفظ

بعد تعديل خلية، انقل التركيز إلى خلية أخرى. يوضح مرجع التحرير أن الحفظ والإلغاء يصبحان مفعّلين بعد هذا الانتقال. افتح القائمة المنسدلة للحفظ، واختر إنشاء نص برمجي، ثم راجع معاينة التغييرات.

دقّق في كيفية تحديد العبارة للسجل. هل تستهدف الصف المقصود، وهل يطابق التغيير مهمتك؟ تساعد المعاينة في المراجعة، لكنها لا تثبت امتلاك الصلاحية ولا نجاح التنفيذ. وإذا احتاج الزملاء إلى سير عمل لتحرير السجلات بدلًا من الوصول إلى SQL، فإن دليل الإنشاء والتحرير والعرض في Baserow يقارن إجراءات المشاركة هذه.

اختر وضع المعاملة قبل التحرير

توثّق DBeaver التثبيت التلقائي والتثبيت اليدوي بوصفهما وضعين للمعاملات. ويغيّر التثبيت الذكي السلوك حين يكون التثبيت التلقائي مفعّلًا. حدّد النقطة التي تنوي إنهاء العمل عندها، واستعن بمرجع أوضاع المعاملات للتحقّق من الإعدادات.

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

قد يغيّر التثبيت الذكي الإجابة أثناء سير العمل

عندما يكون التثبيت التلقائي مفعّلًا، يحوّل التثبيت الذكي الوضع إلى يدوي قبل العبارات المعدِّلة التي يتعرّف عليها، مثل UPDATE وINSERT وDELETE وUPSERT وMERGE. ويخضع حفظ تعديلات بيانات الجدول للقاعدة الموثّقة نفسها. ولا تؤدّي معالجة SELECT المعتادة إلى هذا التحويل عادةً. راجع وثائق التثبيت الذكي.

لا يوفّر هذا التصنيف ضمانًا شاملًا بشأن الإجراءات أو تعبيرات الجدول الشائعة أو جميع لهجات SQL. كما أنه لا يثبت أن كل عبارة SELECT للقراءة فقط أو خالية من الأقفال على الخادم.

يُعيد الإعداد الاختياري للعودة إلى التثبيت التلقائي عند انتهاء المعاملة الوضع إلى تلقائي بعد التثبيت أو التراجع. تحقّق مرة أخرى قبل العملية التالية. وتُظهر المقارنة بين أنواع الاتصال المضمّنة أن التثبيت الذكي معطّل، لذا فإن توافره لا يثبت أن اتصالك يستخدمه.

تحقّق من الاتصال وراء التسمية

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

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

علامة التبويب ليست حدًا فاصلًا للمعاملة

راجع العمل المعلّق على الاتصال المرتبط. تصف DBeaver التثبيت بأنه تطبيق جميع التغييرات المعلّقة في المعاملة الحالية، لذا قد يتجاوز نطاقه الخلية الظاهرة. ولا يعني وجود علامة تبويب أخرى وجود معاملة مستقلّة؛ راجع وثائق المعاملات قبل افتراض ذلك.

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

الشبكة الخالية من التعديلات ليست معيارًا كافيًا للإنجاز. أبلغ عن نتيجة المعاملة ونتيجة إعادة القراءة بدلًا من ذلك.

طبّق قائمة التحقّق: الوجهة، الحالة، الإنهاء، التحقّق

الوجهة، الحالة، الإنهاء، التحقّق هي قائمة تحقّق وضعها هذا الدليل. وتجمع السلوكيات الموثّقة في تسلسل للمراجعة، وليست ميزة في DBeaver أو أسلوب نشر اختُبر عمليًا.

الوجهة: حدّد بيانات التجربة التي يمكن الاستغناء عنها

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

تحقّق من كل نقطة قبل التعامل مع الشبكة.

سجّل القيمة الأصلية للتسمية. وإذا لم تستطع تفسير العمل المعلّق الموجود، فتوقّف عند هذا الحد. إن تبديل الأوضاع لجعل الواجهة تبدو جاهزة لا يحسم هذا الغموض.

الحالة: افحص ما أرسله الحفظ

عدّل الخلية المقصودة، وانقل التركيز، وعاين SQL المُنشأ. تحقّق من شرط تحديد السجل والتغيير المقترح قبل الحفظ. أنت في هذه المرحلة تراجع تعديلًا غير محفوظ في الشبكة.

بعد الحفظ في الوضع اليدوي الفعلي، افحص رسائل نتيجة التنفيذ. تظل التغييرات الناجحة المدعومة معلّقة في المعاملة وفقًا للسلوك اليدوي الموثّق. ويستدعي ظهور خطأ التحقيق قبل اتخاذ أي قرار بالتثبيت. ولا يمكن لتغيّر العرض أن يحسم نتيجة تنفيذ غير مؤكّدة.

الإنهاء: قرّر بعد مراجعة المعاملة كاملةً

راجع كل العمل المعلّق المرتبط. يساعد سجل المعاملات في DBeaver على فحص العمليات وحالتها في الجلسة الحالية.

ثبّت فقط العمل الذي تفهم نطاقه وغرضه. وإذا قرّرت التخلّي عنه، فإن التراجع ينطبق على العمليات المدعومة غير المثبّتة. وظهور عبارة أو وجهة غير متوقّعة سبب للتوقّف. لا تُنهِ عملًا لا تعرفه لمجرّد إخفاء مؤشر.

التحقّق: اقرأ السجل بعد الإنهاء

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

استخدم خطة القياس التالية لتوثيق تمرين على بيانات يمكن الاستغناء عنها. لا يتضمّن هذا المقال أي ملاحظات جُمعت عمليًا.

قارن مسارين منفصلين بالقيمة الأصلية المسجّلة. أولًا، عدّل التسمية الوهمية، وغادر الخلية، وافحص المعاينة، واختر الإلغاء دون الحفظ. والنتيجة المحلية المتوقّعة هي التخلّي عن التعديل غير المحفوظ. حدّث السجل وافحصه أيضًا؛ فحالة الزر ليست دليلًا كافيًا.

في محاولة منفصلة، عدّل السجل نفسه المخصّص للتجربة وعاين التغيير. تأكّد من أن الوضع اليدوي هو الفعلي قبل الحفظ، ثم افحص رسائل نتيجة التنفيذ والعمل المعلّق. وللتخلّي عن هذا التغيير، راجع نطاق معاملته قبل التراجع وأعد قراءة السجل. قارن القيمة بالقيمة الأصلية. أبقِ العمل المعلّق غير المرتبط خارج التمرين.

إذا خالفت ملاحظة ما النتيجة المتوقّعة، فاحتفظ بالخطأ وسياق الاتصال. تأكّد مما إذا كان العمل قد أُرسل وما إذا كانت المعاملة قد انتهت قبل تجربة أي إجراء آخر. فقد يجعل تكرار الحفظ دون فهم النتيجة غير المؤكّدة أصعب تفسيرًا.

يسجّل JSON هذا قائمة التحقّق وحالة أدلتها. وهو ليس طلبًا إلى قاعدة بيانات ولا نتيجة اختبار.

{
  "checklist": "target-state-finish-verify",
  "steps": [
    "target",
    "state",
    "finish",
    "verify"
  ],
  "evidenceStatus": "not-collected"
}

ما الذي تُسيء الفرق فهمه بشأن النصوص البرمجية والعمل المعلّق

يختلف تنفيذ العبارة عن تنفيذ النص البرمجي

يعمل إجراء تنفيذ عبارة SQL على الاستعلام الموجود عند المؤشر أو النص المحدّد. ويعالج إجراء تنفيذ نص SQL البرمجي النص البرمجي في المحرّر أو الاستعلامات المحدّدة. تحقّق من الإجراء والتحديد قبل تشغيل أي منهما، كما يوضح مرجع تنفيذ SQL.

لمعالجة النصوص البرمجية إعداداتها الخاصة لنوع التثبيت: عند نهاية النص البرمجي، وبعد كل استعلام، وبعد كل عدد محدّد من الاستعلامات، ودون تثبيت. وتتيح معالجة الأخطاء خيارات التوقّف + التراجع، والتوقّف + التثبيت، والتجاهل. اقرأ كلا الإعدادين. فالوضع اليدوي في شريط الأدوات وحده لا يثبت أن نصًا برمجيًا اعتباطيًا سيُنفَّذ كوحدة ذرّية. ويحتاج التنفيذ عبر عميل قاعدة البيانات الأصلي إلى مراجعة سياسة مستقلة.

المؤشر دعوة للتحقيق

لا تتعامل مع الحفظ بوصفه تثبيتًا غير مشروط. واعتبار الإلغاء تراجعًا عن المعاملة هو الخطأ المعاكس: فهو ينسب إجراءً في قاعدة البيانات إلى عنصر تحكّم مخصّص لتعديلات الشبكة غير المحفوظة. ويعكس كلاهما سوء فهم للحالة الراهنة للعمل.

تعرض نافذة المعاملات المعلّقة المعاملات النشطة عبر الاتصالات في الجلسة الحالية. ويتيح سجل المعاملات مراجعة عمليات الجلسة. ولا يمثّل أي منهما سجل تدقيق كاملًا ودائمًا للخادم أو دليلًا على ظهور كل قفل ذي صلة.

أنه العمل عن قصد بدلًا من الاعتماد على إعدادات الخمول القابلة للضبط. وبشأن حالات انتظار ترحيلات PostgreSQL المرتبطة بالمعاملات، يتناول دليل تشخيص الفهارس المتزامنة المنفصل التحقيق في قاعدة البيانات. وهو لا يمنح إذنًا لتثبيت عمل معلّق لا تعرفه.

الحدود وقرارات الاستعادة

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

قارن الإصدار المثبّت من DBeaver وفئته وبرنامج التشغيل والإعدادات المخصّصة بوثائق العميل الحالية. فوجود مرجع على الإنترنت لا يثبت تطابق السلوك في نسختك المثبّتة.

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

قبل مشاركة معاينات SQL أو السجلات، أزل بيانات العملاء وبيانات الاعتماد مع الإبقاء على سياق كافٍ لشرح نتيجة المعاملة. وإذا ظلت نتيجة إعادة القراءة غير محسومة، فاذكر ذلك في تقرير الحالة. فهذا الغموض أهم من مظهر الشبكة المرتّب.