التابع Connection.set_progress_handler()‎ في بايثون

يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا.

البنية العامة

set_progress_handler(handler, n)

المعاملات

handler

يمكن استدعاء التابع مع تمرير القيمة None للمعامل handler للتخلص من أي استدعاء خلفي معدّ مسبقًا.

تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء OperationalError.

n

عدد تعليمات SQLite.

انظر أيضًا

• التابع Connection.set_authorizer()‎:يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات.
• التابع Connection.set_trace_callback()‎:يسجل التابع trace_callback يجري استدعاؤه لكل جملة SQL تنفّذ بواسطة SQLite.

مصادر

صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.