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

يحمل هذا التابع إحدى ملحقات SQlite من المكتبة المشتركة. يجب تفعيل خاصية تحميل الملحقات بواسطة التابع enable_load_extension()‎ قبل استخدام هذا التابع.

يجدر التنبيه إلى أنّ الملحقات القابلة للتحميل معطّلة بصورة افتراضية، وذلك لأنّ بعض المنصّات (وبالخصوص Mac OS X) تمتلك مكتبات SQLite مصرّفة دون تضمين هذه الميزة. لتفعيل ميزة الملحقات القابلة للتحميل يجب تمرير ‎-enable-loadable-sqlite-extensions إلى الإعدادات.

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

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

load_extension(path)

المعاملات

path

المسار المؤدي إلى الملحقة المطلوب تحميلها.

أمثلة

يبين المثال التالي طريقة استخدام التابع:

import sqlite3

con = sqlite3.connect(":memory:")

# تفعيل خاصية تحميل الملحقات
con.enable_load_extension(True)

# fulltext search تحميل الملحقة
con.load_extension("./fts3.so")

# تعطيل ميزة تحميل الملحقات مرة أخرى
con.enable_load_extension(False)

انظر أيضًا

• التابع Connection.enable_load_extension()‎:يحدّد هذا التابع ما إذا كان بإمكان محرّك SQLite من تحميل الملحقات من المكتبات المشتركة.

مصادر

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