טרנזקציה מקבצת פקודות כך שכולן נכנסות לתוקף או שאף אחת לא. מתחילים אותה עם BEGIN, הופכים אותה לקבועה עם COMMIT, או מבטלים כל מה שקרה מאז ה-BEGIN עם ROLLBACK. עד שמבצעים commit, sessions אחרים לא רואים את השינויים שלכם.
ל-Alice נשארים 70 ול-Bob יש 80. אם השרת היה קורס בין שני העדכונים, אף אחד מהם לא היה שורד: כסף לא יכול לצאת מחשבון אחד בלי להגיע לשני.
לבטל שינויים עם ROLLBACK
ROLLBACK זורק כל שינוי שנעשה מאז ה-BEGIN:
ה-DELETE הסיר את שלוש השורות בתוך הטרנזקציה, וה-rollback החזיר אותן: הספירה היא 3. ב-psql, עטפו באותה צורה UPDATE או DELETE ידני מסוכן. הריצו אותו אחרי BEGIN, בדקו את התוצאה עם SELECT, ואז בחרו COMMIT או ROLLBACK.
בלי BEGIN, PostgreSQL מריץ כל פקודה בטרנזקציה משלה ומבצע לה commit כשהיא מסתיימת (autocommit). דרייברים שונים זה מזה: psycopg של Python מתחיל טרנזקציה בפקודה הראשונה ומחכה ל-conn.commit().
לבטל חלק מטרנזקציה עם SAVEPOINT
נקודת שמירה מסמנת מקום בתוך טרנזקציה. ROLLBACK TO SAVEPOINT name מבטל רק את העבודה שנעשתה אחריה, והטרנזקציה ממשיכה:
ביומן יש "import users" ו-"import products". שלב ההזמנות בוטל בלי לאבד את ההכנסה הראשונה. RELEASE SAVEPOINT name שוכח נקודת שמירה שכבר לא צריך.
לתקן את "current transaction is aborted"
כשפקודה נכשלת בתוך טרנזקציה, PostgreSQL מסמן את כל הטרנזקציה ככושלת ומסרב לכל פקודה שבאה אחריה עד שמסיימים אותה:
BEGIN;
INSERT INTO accounts VALUES ('alice', 10); -- duplicate key: error
UPDATE accounts SET balance = 0;
-- ERROR: current transaction is aborted, commands ignored until end of transaction block
ROLLBACK;
התיקון הוא ROLLBACK. COMMIT על טרנזקציה שבוטלה לא שומר כלום; PostgreSQL עונה ROLLBACK. כדי להמשיך אחרי שגיאה צפויה, הגדירו נקודת שמירה לפני הפקודה המסוכנת וחזרו אליה. דרייברים ו-ORMs שמציעים "טרנזקציות מקוננות" עובדים כך.
לבטל גם שינויים בטבלאות
CREATE TABLE, ALTER TABLE, DROP TABLE ורוב שאר ה-DDL הם טרנזקציוניים, כך ש-migration שנכשל באמצע לא משאיר כלום אחריו:
to_regclass מחזיר NULL: הטבלה מעולם לא הייתה קיימת עבור אף אחד אחר. כמה פקודות מסרבות לרוץ בתוך בלוק טרנזקציה, ביניהן VACUUM, CREATE DATABASE ו-CREATE INDEX CONCURRENTLY.
לבחור רמת בידוד
רמת הבידוד קובעת אילו commits של sessions אחרים טרנזקציה רואה. קובעים אותה עם BEGIN ISOLATION LEVEL ....
| רמה | מה כל פקודה רואה | מתי להשתמש |
|---|---|---|
READ COMMITTED (ברירת מחדל) | נתונים שבוצע להם commit לפני שהפקודה התחילה | רוב האפליקציות |
REPEATABLE READ | תמונת מצב אחת שנלקחת בשאילתה הראשונה של הטרנזקציה | דוחות וייצואים שחייבים להיות עקביים |
SERIALIZABLE | כמו REPEATABLE READ, ו-PostgreSQL מבטל טרנזקציות שהתוצאה שלהן יכולה להיות שונה מהרצה שלהן אחת אחרי השנייה | כללים עסקיים שקוראים ואז כותבים |
READ UNCOMMITTED מתקבל אבל מתנהג כמו READ COMMITTED: PostgreSQL אף פעם לא מציג נתונים שלא בוצע להם commit. תחת REPEATABLE READ ו-SERIALIZABLE, צפו לשגיאות עם SQLSTATE 40001 ("could not serialize access") והריצו מחדש את כל הטרנזקציה כשמקבלים אחת כזו.
לנעול שורה שאתם עומדים לשנות
כדי למנוע מ-session אחר לשנות שורה בין הקריאה שלכם לכתיבה שלכם, נעלו אותה בזמן הקריאה עם FOR UPDATE. כותבים אחרים מחכים עד שתבצעו commit:
BEGIN;
SELECT balance FROM accounts WHERE name = 'alice' FOR UPDATE;
UPDATE accounts SET balance = balance - 30 WHERE name = 'alice';
COMMIT;
לשמור על טרנזקציות קצרות
טרנזקציה פתוחה מחזיקה את נעילות השורות שלה עד שהיא מסתיימת, והיא מונעת מ-VACUUM להסיר גרסאות ישנות של שורות. Session שנשאר "idle in transaction" בגלל סקריפט שקרס יכול לחסום כותבים אחרים במשך שעות. הגדירו idle_in_transaction_session_timeout כדי לסיים sessions כאלה אוטומטית.
בתוך טרנזקציה, now() מחזיר את אותו זמן לכל פקודה: הזמן שבו הטרנזקציה התחילה (ראו פונקציות תאריך). המדריך הרשמי על טרנזקציות כולל עוד דוגמאות.
שאלות נפוצות
האם PostgreSQL עובד ב-autocommit?
כן. פקודה שנשלחת מחוץ ל-BEGIN רצה בטרנזקציה משלה ומבוצע לה commit כשהיא מסתיימת. חלק מהדרייברים הופכים את זה: psycopg של Python פותח בשבילכם טרנזקציה ומחכה ל-commit(), אלא אם מפעילים autocommit.
מה רמת הבידוד שבברירת המחדל ב-PostgreSQL?
READ COMMITTED. כל פקודה רואה את הנתונים שבוצע להם commit לפני שהפקודה התחילה. השתמשו ב-BEGIN ISOLATION LEVEL REPEATABLE READ או ב-SERIALIZABLE כשטרנזקציה צריכה לראות תמונת מצב עקבית אחת.
אפשר לבטל CREATE TABLE או ALTER TABLE ב-PostgreSQL?
כן. כמעט כל ה-DDL ב-PostgreSQL טרנזקציוני, כך ש-CREATE, ALTER או DROP בתוך טרנזקציה נעלמים ב-ROLLBACK. כמה פקודות, כמו CREATE DATABASE, VACUUM ו-CREATE INDEX CONCURRENTLY, לא יכולות לרוץ בתוך בלוק טרנזקציה בכלל.
מה ההבדל בין COMMIT ל-END ב-PostgreSQL?
אין הבדל. END היא הרחבה של PostgreSQL שעושה אותו דבר כמו COMMIT, ו-START TRANSACTION הוא הכתיב הסטנדרטי של BEGIN.