إعدادات الاستعادة

يقبل استعلام 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.

`structure_only`	لم يتم تعيين `restore_*`	`restore_* = true`	`restore_* = false`
`false`	تمت الاستعادة	تمت الاستعادة	تم التخطي
`true`	تم التخطي	تمت الاستعادة	تم التخطي

هذا متوافق تمامًا مع الإصدارات السابقة: إذ يتصرف استعلام RESTORE الذي لا يعيّن أيًا من الإعدادات الجديدة تمامًا كما كان من قبل.

أمثلة

استعِد تعريفات الجداول وكيانات الوصول، دون استعادة بيانات الجداول — على سبيل المثال، لإعداد بيئة لاختبار الاستعلامات أو إعادة تشغيلها دون نسخ البيانات:

RESTORE ALL FROM backup_name
SETTINGS structure_only = true, restore_access_entities = true

استعد بيانات الجدول فقط، من دون إعادة إنشاء كيانات الوصول أو الدوال المعرّفة من قِبل المستخدم:

RESTORE ALL FROM backup_name
SETTINGS structure_only = true, restore_table_data = true

استعد كل شيء باستثناء الدوال المعرّفة من قِبل المستخدم:

RESTORE ALL FROM backup_name
SETTINGS restore_functions = false