Menu

generate_series في PostgreSQL: أرقام وتواريخ وفجوات

تعيد generate_series مجموعة صفوف من قيمة بداية إلى قيمة نهاية: أرقام وتواريخ وطوابع زمنية. استخدمها لملء الفجوات في التقارير وتوليد بيانات الاختبار وبناء التقاويم.

تحتوي هذه الصفحة على محررات قابلة للتشغيل. حرّر، شغّل، وشاهد النتيجة فوراً.

تعيد generate_series(start, stop, step) صفًا لكل قيمة من start حتى stop بما فيها، بخطوة step (‏1 إن حذفتها). وتعمل مع الأعداد الصحيحة وnumeric والطوابع الزمنية بخطوة من نوع interval. استخدمها في FROM كأنها جدول.

يعيد هذا 1 و4 و7 و10 مع مربعاتها. والخطوة السالبة تعدّ تنازليًا: تعطي generate_series(5, 1, -2) القيم 5 و3 و1. والسلسلة التي لا تستطيع بلوغ نهايتها، مثل generate_series(5, 1)، لا تعيد أي صف. وتسير generate_series(0, 1, 0.25) بقيم numeric.

توليد سلسلة من التواريخ

مرّر طوابع زمنية أو تواريخ مع خطوة من نوع interval. لا توجد نسخة للنوع date، فتعود القيم كـ timestamptz، حوّلها بـ ::date:

تعود خمسة أيام، من 26 فبراير إلى 2 مارس، عبر نهاية الشهر. وتصلح أي فترة خطوةً: interval '1 hour' وinterval '15 minutes' وinterval '1 month' وinterval '1 week'.

مع قيم timestamptz تتبع الخطوة interval '1 day' تقويم TimeZone للجلسة، وعند تغيير التوقيت الصيفي قد تكون الخطوة الواحدة 23 أو 25 ساعة. ومنذ PostgreSQL 16 يحدد وسيط رابع المنطقة التي تُحسب فيها الخطوات، مهما كانت منطقة الجلسة:

SELECT generate_series(
    timestamptz '2026-03-28 00:00 Europe/Berlin',
    timestamptz '2026-03-31 00:00 Europe/Berlin',
    interval '1 day',
    'Europe/Berlin');

ملء الأيام الناقصة في التقرير

لا يعيد GROUP BY على بياناتك إلا الفترات التي فيها صفوف. ولعرض كل يوم مع صفر للأيام التي لا طلبات فيها، ولّد الأيام واربط البيانات بها بـ LEFT JOIN:

في 1 نوفمبر طلبان، وفي 4 نوفمبر طلب واحد، وتُظهر الأيام 2 و3 و5 القيمة 0. اعدد عمودًا من الجدول المربوط (count(o.id)) لا count(*)، وإلا عُدّ كل يوم فارغ واحدًا.

مقارنة created_at بنطاق، بدل created_at::date = d، تسمح باستخدام فهرس على created_at. والنمط نفسه مع interval '1 month' وdate_trunc يملأ الأشهر الفارغة (راجع دوال التاريخ).

توليد بيانات الاختبار

ينشئ INSERT ... SELECT من سلسلة العدد الذي تحتاجه من الصفوف في جملة واحدة:

يحصل الجدول على 1,000 مستخدم موزّعين على 30 يومًا من التسجيل. القيم محسوبة من i، فيعطي كل تشغيل النتيجة نفسها، واستخدم random() حين تريدها أن تتغير. وولّد مليون صف بالطريقة نفسها لتجربة فهرس ومقارنة الخطط بـ EXPLAIN ANALYZE.

ترقيم الصفوف واستخدام السلاسل في الربط

يضيف WITH ORDINALITY عمود موضع إلى أي دالة تعيد مجموعة صفوف:

يسرد هذا خمس فترات مدة كل منها 15 دقيقة من 09:00 إلى 10:00، مرقّمة من 1 إلى 5. وتعمل السلسلة أيضًا في CROSS JOIN، مثلًا لإقران كل مستخدم بكل يوم في الشهر.

تعيد generate_series في قائمة SELECT أيضًا عدة صفوف، لكن استدعاءين من هذا النوع بطولين مختلفين يحشوان الأقصر بقيم NULL. أبقِ الدوال التي تعيد مجموعات في FROM. وللسلاسل التي لا تستطيع دالة واحدة التعبير عنها، مثل التنقل في شجرة، استخدم CTE تعاوديًا.

الأسئلة الشائعة

هل تشمل generate_series قيمة النهاية؟

نعم، إذا وقعت الخطوات عليها: تعيد generate_series(1, 5) القيم من 1 إلى 5. وإن لم تقع عليها، تتوقف السلسلة عند آخر قيمة لا تتجاوز النهاية، فتعيد generate_series(1, 10, 4) القيم 1 و5 و9.

هل توجد generate_series في MySQL؟

لا. في MySQL تبني السلسلة باستعلام CTE تعاوديّ (WITH RECURSIVE)، وهو يعمل في PostgreSQL أيضًا لكنه أطول في الكتابة.

لماذا تعيد generate_series مع التواريخ طوابع زمنية؟

لا توجد نسخة من الدالة للنوع date، فيستخدم PostgreSQL نسخة timestamptz. حوّل كل قيمة مجددًا بـ ::date.

كيف أولّد رقمًا عشوائيًا لكل صف؟

استدعِ random() في قائمة الاختيار: يعطي SELECT i, random() FROM generate_series(1, 5) AS i قيمة بين 0 و1 لكل صف، ويعطي floor(random() * 100)::int عددًا صحيحًا من 0 إلى 99. ومنذ PostgreSQL 17 تعيد random(1, 100) عددًا صحيحًا عشوائيًا في ذلك النطاق مباشرة.

رسم توضيحي للغات البرمجة في Coddy

تعلّم البرمجة مع Coddy

ابدأ الآن