الفرق بين المراجعتين لصفحة: «Python/Connection/set trace callback»
< Python | Connection
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>Connection.set_trace_callback()</code> في بايثون}}</noinclude> يسجل التابع trace_callback يجري ا...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>Connection.set_trace_callback()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>Connection.set_trace_callback()</code> في بايثون}}</noinclude> | ||
يسجل التابع trace_callback يجري استدعاؤه لكل جملة SQL تنفّذ بواسطة SQLite. | يسجل التابع trace_callback يجري استدعاؤه لكل جملة [[SQL]] تنفّذ بواسطة SQLite. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 8: | سطر 8: | ||
set_trace_callback(trace_callback) | set_trace_callback(trace_callback) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
| سطر 15: | سطر 14: | ||
يأخذ الاستدعاء الخلفي وسيطًا واحدًا وهو عبارة الاستعلام (كسلسلة نصية) التي سيجري تنفيذها، وتتجاهل اللغة القيمة المعادة من الاستدعاء الخلفي. | يأخذ الاستدعاء الخلفي وسيطًا واحدًا وهو عبارة الاستعلام (كسلسلة نصية) التي سيجري تنفيذها، وتتجاهل اللغة القيمة المعادة من الاستدعاء الخلفي. | ||
يجدر الانتباه إلى أنّ محرّك SQLite لا ينفّذ العبارات الممرّة إلى توابع Cursor.execute() وحسب، بل هناك مصادر أخرى منها عملية إدارة الإجراءات في وحدة بايثون، وعملية تنفيذ المشغّلات triggers المعرّفة في قاعدة البيانات الحالية. | يجدر الانتباه إلى أنّ محرّك SQLite لا ينفّذ العبارات الممرّة إلى توابع <code>[[Python/Cursor/execute|Cursor.execute()]]</code> وحسب، بل هناك مصادر أخرى منها عملية إدارة الإجراءات في وحدة بايثون، وعملية تنفيذ المشغّلات triggers المعرّفة في قاعدة البيانات الحالية. | ||
يؤدي تمرير القيمة None إلى trace_callback إلى تعطيل الاستدعاء الخلفي. | يؤدي تمرير القيمة <code>None</code> إلى المعامل <code>trace_callback</code> إلى تعطيل الاستدعاء الخلفي. | ||
هذا التابع جديد في الإصدار 3.3. | '''ملاحظة:''' هذا التابع جديد في الإصدار 3.3. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/Connection/set_authorizer|التابع <code>Connection.set_authorizer()</code>]]:يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات. | * [[Python/Connection/set_authorizer|التابع <code>Connection.set_authorizer()</code>]]:يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاول للوصول إلى عمود في جدول ضمن قاعدة البيانات. | ||
* [[Python/Connection/set_progress_handler|التابع <code>Connection.set_progress_handler()</code>]]:يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. | * [[Python/Connection/set_progress_handler|التابع <code>Connection.set_progress_handler()</code>]]:يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل <code>n</code> من تعليمات SQLite في الجهاز الافتراضي virtual machine. | ||
== مصادر == | == مصادر == | ||
[https://docs.python.org/3/library/sqlite3.html#sqlite3.set_trace_callback صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.] | [https://docs.python.org/3/library/sqlite3.html#sqlite3.set_trace_callback صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.] | ||
المراجعة الحالية بتاريخ 20:51، 18 سبتمبر 2018
يسجل التابع 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 في توثيق بايثون الرسمي.