Skip to main content
يقبل استعلام RESTORE إعدادات في عبارة SETTINGS تحدد فئات الكائنات التي تُقرأ من النسخة الاحتياطية. توثق هذه الصفحة الإعدادات التي تحدد ما تتم استعادته: بيانات الجداول، وكيانات الوصول، والدوال المعرّفة من قِبل المستخدم.

structure_only

النوع: Bool. القيمة الافتراضية: false. عند ضبطه على true، لا تُقرأ من النسخة الاحتياطية سوى استعلامات CREATE، من دون محتويات الكائنات المستعادة. وهو اختصار ملائم يضبط القيم الافتراضية الفعّالة لإعدادات الفئات الثلاثة أدناه على false:
  • restore_table_data
  • restore_access_entities
  • restore_functions

restore_table_data

النوع: Bool. اختياري؛ إذا لم يُعيَّن، تكون قيمته الافتراضية !structure_only (أي true ما لم يُعيَّن structure_only). يحدد ما إذا كانت بيانات الجداول ستُستعاد. عند تعيينه صراحةً، يتجاوز structure_only: عيّنه إلى true لاستعادة بيانات الجداول حتى عند ضبط structure_only=true، أو إلى false لتخطي بيانات الجداول حتى إذا لم يكن structure_only مُعيَّنًا.

restore_access_entities

النوع: Bool. اختياري؛ إذا لم يُعيَّن، تكون قيمته الافتراضية !structure_only. يحدد ما إذا كان يجب استعادة كيانات الوصول، مثل المستخدمين والأدوار وملفات تعريف الإعدادات وسياسات الصفوف والحصص. وعند تعيينه صراحةً، يتجاوز structure_only.

restore_functions

النوع: Bool. اختياري؛ إذا لم يُعيَّن، تكون قيمته الافتراضية !structure_only. يحدد ما إذا كان ينبغي استعادة الدوال المعرّفة من قِبل المستخدم. عند تعيينه صراحةً، يتجاوز structure_only.

السلوك الفعلي

تُستعاد كل فئة عندما يكون إعدادها المقابل true. وإذا لم يُحدَّد إعداد الفئة، تُستمد قيمته من structure_only: تكون القيم الثلاث true افتراضيًا، وتصبح جميعها false عندما يكون structure_only=true. هذا متوافق تمامًا مع الإصدارات السابقة: إذ يتصرف استعلام RESTORE الذي لا يعيّن أيًا من الإعدادات الجديدة تمامًا كما كان من قبل.

أمثلة

استعِد تعريفات الجداول وكيانات الوصول، دون استعادة بيانات الجداول — على سبيل المثال، لإعداد بيئة لاختبار الاستعلامات أو إعادة تشغيلها دون نسخ البيانات:
استعد بيانات الجدول فقط، من دون إعادة إنشاء كيانات الوصول أو الدوال المعرّفة من قِبل المستخدم:
استعد كل شيء باستثناء الدوال المعرّفة من قِبل المستخدم:
آخر تعديل في ١٧ أغسطس ٢٠٢٦