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

يسجل التابع trace_callback يجري استدعاؤه لكل جملة SQL تنفّذ بواسطة SQLite.

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

set_trace_callback(trace_callback)

المعاملات

trace_callback

يأخذ الاستدعاء الخلفي وسيطًا واحدًا وهو عبارة الاستعلام (كسلسلة نصية) التي سيجري تنفيذها، وتتجاهل اللغة القيمة المعادة من الاستدعاء الخلفي.

يجدر الانتباه إلى أنّ محرّك SQLite لا ينفّذ العبارات الممرّة إلى توابع Cursor.execute()‎ وحسب، بل هناك مصادر أخرى منها عملية إدارة الإجراءات في وحدة بايثون، وعملية تنفيذ المشغّلات triggers المعرّفة في قاعدة البيانات الحالية.

يؤدي تمرير القيمة None إلى المعامل trace_callback إلى تعطيل الاستدعاء الخلفي.

ملاحظة: هذا التابع جديد في الإصدار 3.3.

انظر أيضًا

• التابع Connection.set_authorizer()‎:يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات.
• التابع Connection.set_progress_handler()‎:يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine.

مصادر

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