Menu

generate_series ב-PostgreSQL: מספרים, תאריכים וחורים

generate_series מחזיר קבוצת שורות מערך התחלה עד ערך סיום: מספרים, תאריכים וחותמות זמן. משתמשים בו כדי למלא חורים בדוחות, לייצר נתוני בדיקה ולבנות לוחות שנה.

בדף הזה יש עורכים שאפשר להריץ. לערוך, להריץ ולראות את הפלט מיד.

generate_series(start, stop, step) מחזיר שורה לכל ערך מ-start ועד stop כולל, בצעדים של step (1 אם משמיטים אותו). הוא עובד עם מספרים שלמים, עם numerics ועם חותמות זמן עם צעד מסוג interval. משתמשים בו ב-FROM כמו בטבלה.

השאילתה מחזירה 1, ‏4, ‏7 ו-10 עם הריבועים שלהם. צעד שלילי סופר כלפי מטה: generate_series(5, 1, -2) נותן 5, ‏3, ‏1. סדרה שלא יכולה להגיע לסוף שלה, כמו generate_series(5, 1), לא מחזירה שורות. generate_series(0, 1, 0.25) צועד על numerics.

לייצר סדרת תאריכים

העבירו חותמות זמן או תאריכים עם צעד מסוג interval. אין גרסה של date, ולכן הערכים חוזרים כ-timestamptz; המירו אותם עם ::date:

חוזרים חמישה ימים, מ-26 בפברואר עד 2 במרץ, דרך סוף החודש. כל interval יכול לשמש כצעד: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.

עם ערכי timestamptz, צעד של interval '1 day' הולך לפי לוח השנה של ה-TimeZone של ה-session. במעבר לשעון קיץ, צעד אחד יכול להיות 23 או 25 שעות. מאז PostgreSQL 16, ארגומנט רביעי מציין את האזור שבו צועדים, בלי קשר למה שה-session משתמש בו:

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 בנובמבר יש 2 הזמנות, ב-4 בנובמבר יש אחת, וב-2, ב-3 וב-5 מוצג 0. ספרו עמודה של הטבלה המצורפת (count(o.id)), לא count(*), אחרת כל יום ריק נספר כ-1.

השוואה של 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: 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

להתחיל