تمرير المعلمات مع Pandas read_sql

نظرة عامة

تتيح لك وظيفة Pandas read_sql تنفيذ استعلامات SQL واسترداد البيانات من قاعدة البيانات. إحدى ميزاته هي القدرة على تمرير المعلمات إلى الاستعلام.

بناء جملة المعلمة

يمكن تمرير المعلمات كقائمة أو صف أو إملاء. يعتمد بناء الجملة الدقيق على برنامج تشغيل قاعدة البيانات المستخدم. فيما يلي بعض الأمثلة الشائعة:

• ؟ أو %s: عنصر نائب لقيمة واحدة
• :1 أو :name: عنصر نائب مسمى لقيمة واحدة
• %(name)s: عنصر نائب مسمى باستخدام بناء جملة string.format

استخدام قاموس مع الوسائط المسماة

أحد الخيارات لتمرير المعلمات هو استخدام القاموس. وهذا مدعوم من قبل معظم برامج التشغيل، بما في ذلك PostgreSQL مع برنامج التشغيل psycopg2. تتوافق أزواج القيمة الرئيسية في القاموس مع العناصر النائبة المسماة في الاستعلام.

مثال

لتوضيح أسلوب الوسيطة المسماة، دعنا نأخذ في الاعتبار استعلام SQL التالي:

select "Timestamp", "Value" from "MyTable"
where "Timestamp" BETWEEN :dstart AND :dfinish

إليك كيفية تمرير المعلمات إلى هذا الاستعلام باستخدام القاموس:

params = {"dstart": datetime(2014, 6, 24, 16, 0), "dfinish": datetime(2014, 6, 24, 17, 0)}

df = psql.read_sql(
    "select \"Timestamp\",\"Value\" from \"MyTable\" where \"Timestamp\" BETWEEN %(dstart)s AND %(dfinish)s",
    db,
    params=params,
    index_col=["Timestamp"],
)

في هذا المثال، يوفر قاموس المعلمات قيمًا للعناصر النائبة المسماة :dstart و :dfinish. يضمن بناء جملة %(name)s إدراج القيم بشكل صحيح في الاستعلام.