Menu

מפתח ראשי ב-PostgreSQL: Identity, ‏SERIAL ו-UUID

איך מגדירים מפתח ראשי ב-PostgreSQL ואיך מייצרים אותו: עמודות identity, ה-SERIAL הוותיק, ו-UUID עם gen_random_uuid(). וגם מפתחות מורכבים ואיפוס sequence.

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

מפתח ראשי הוא העמודה, או קבוצת העמודות, שמזהה כל שורה. הערכים שלו חייבים להיות ייחודיים ולא NULL, ולטבלה יכול להיות רק אחד. ב-PostgreSQL בדרך כלל נותנים למסד הנתונים לייצר אותו עם עמודת identity: id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY.

ה-ids הם 1 ו-2. הגדרת המפתח יוצרת גם אינדקס ייחודי עליו, בשם users_pkey.

עמודות identity: ‏ALWAYS מול BY DEFAULT

עמודות identity הן הדרך הסטנדרטית של SQL למספר שורות, וזמינות מאז PostgreSQL 10. יש שתי צורות:

  • GENERATED ALWAYS AS IDENTITY דוחה ערך מפורש ב-INSERT, אלא אם ההכנסה כוללת OVERRIDING SYSTEM VALUE. זו ברירת המחדל הבטוחה יותר.
  • GENERATED BY DEFAULT AS IDENTITY משתמש בערך המיוצר רק כשלא מספקים ערך.

עם BY DEFAULT, הכנסה של ids משלכם משאירה את ה-sequence מאחור, וה-id הבא שייווצר מתנגש. אחרי ייבוא שורות עם ids מפורשים, קדמו את ה-sequence מעבר לגבוה ביותר עם setval:

בלי השורה של setval, ההכנסה האחרונה הייתה מקבלת id ‏1 ונכשלת עם שגיאת מפתח כפול. איתה, השורה החדשה מקבלת 4.

SERIAL מול identity

serial ‏(4 בתים) ו-bigserial ‏(8 בתים) הם לא טיפוסים אמיתיים. הם קיצור שיוצר sequence וקובע את ברירת המחדל של העמודה ל-nextval() שלו:

העמודה היא integer רגיל עם ברירת מחדל nextval('legacy_id_seq'::regclass). שום דבר לא מונע מהכנסה לכתוב id משלה, ול-sequence צריך הרשאות משלו. עמודות identity פותרות את שני הדברים, אז העדיפו אותן בטבלאות חדשות. serial עדיין עובד, ותפגשו אותו בסכמות ישנות ובמדריכים.

השתמשו ב-bigint (או ב-bigserial) לטבלאות שיכולות לגדול. מפתח integer נגמר אחרי כ-2.1 מיליארד ערכים.

מפתחות ראשיים מסוג UUID

gen_random_uuid() מחזיר UUID אקראי מגרסה 4. הוא מובנה מאז PostgreSQL 13, כך שלא צריך הרחבה:

כל הרצה מדפיסה ids שונים, 36 תווים כל אחד בצורת טקסט. הטיפוס uuid שומר אותם ב-16 בתים, אז השתמשו בו ולא ב-text. PostgreSQL 18 מוסיף את uuidv7(), שמייצר UUID מסודרים לפי זמן שנכנסים לפי סדר האינדקס. ב-PostgreSQL 17, ייצרו אותם באפליקציה.

מפתחות ראשיים מורכבים

מפתח יכול להשתרע על כמה עמודות, ונכתב בשורה משלו ב-CREATE TABLE. זה המפתח הטבעי לטבלת קישור, שבה כל זוג יכול להופיע פעם אחת:

הזוג החוזר (1, 10) מדולג, ולכן הספירה היא 3. כדי להוסיף מפתח לטבלה קיימת, השתמשו ב-ALTER TABLE t ADD PRIMARY KEY (col). הדף על ALTER TABLE מסביר את השינויים האחרים. טבלאות אחרות מצביעות על המפתח עם מפתחות זרים.

שאלות נפוצות

האם יש AUTO_INCREMENT ב-PostgreSQL?

לא בשם הזה. הדרך הסטנדרטית היא עמודת identity, ‏id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, שזמינה מאז PostgreSQL 10. הטיפוסים הוותיקים serial ו-bigserial עושים אותו דבר עם sequence וערך ברירת מחדל.

למה יש חורים ב-sequence של ה-id שלי ב-PostgreSQL?

Sequence מחלק ערך גם כשההכנסה נכשלת אחר כך או כשהטרנזקציה שלה מתבטלת, והערך הזה לעולם לא חוזר לשימוש. חורים הם דבר רגיל ולא מזיק, אז אל תסתמכו על כך שה-ids רצופים.

האם מפתח ראשי יוצר אינדקס ב-PostgreSQL?

כן. מפתח ראשי (וכל אילוץ UNIQUE) יוצר אוטומטית אינדקס B-tree ייחודי, שנקרא tablename_pkey במקרה של המפתח הראשי.

להשתמש ב-UUID או ב-bigint למפתח ראשי?

מפתחות identity מסוג bigint קטנים יותר (8 בתים לעומת 16) ונכנסים לפי סדר האינדקס. UUID אפשר לייצר בכל מקום בלי פנייה למסד הנתונים, והם לא חושפים כמה שורות יש. UUID אקראיים מפזרים את ההכנסות על פני האינדקס, וזה עולה יותר בטבלאות גדולות.

איור של שפות התכנות ב-Coddy

ללמוד תכנות עם Coddy

להתחיל