Menu

Transaksi PostgreSQL: BEGIN, COMMIT, dan ROLLBACK

Cara kerja transaksi PostgreSQL: BEGIN, COMMIT, dan ROLLBACK, savepoint, apa akibat error pada transaksi yang terbuka, dan level isolasi.

Halaman ini dilengkapi editor yang bisa dijalankan. Edit, jalankan, dan lihat output-nya seketika.

Transaksi mengelompokkan pernyataan supaya semuanya berlaku atau tidak sama sekali. Mulai dengan BEGIN, jadikan permanen dengan COMMIT, atau batalkan semuanya sejak BEGIN dengan ROLLBACK. Sampai kamu melakukan commit, sesi lain tidak melihat perubahanmu.

Alice berakhir dengan 70 dan Bob dengan 80. Jika server crash di antara kedua update itu, tidak ada yang tersimpan: uang tidak bisa keluar dari satu akun tanpa sampai ke akun lainnya.

Membatalkan perubahan dengan ROLLBACK

ROLLBACK membuang setiap perubahan yang dibuat sejak BEGIN:

DELETE menghapus ketiga baris di dalam transaksi, dan rollback mengembalikannya: hitungannya 3. Di psql, bungkus UPDATE atau DELETE manual yang berisiko dengan cara yang sama. Jalankan setelah BEGIN, periksa hasilnya dengan SELECT, lalu pilih COMMIT atau ROLLBACK.

Tanpa BEGIN, PostgreSQL menjalankan setiap pernyataan dalam transaksinya sendiri dan melakukan commit saat selesai (autocommit). Driver berbeda-beda: psycopg di Python memulai transaksi di pernyataan pertama dan menunggu conn.commit().

Membatalkan sebagian transaksi dengan SAVEPOINT

Savepoint menandai sebuah titik di dalam transaksi. ROLLBACK TO SAVEPOINT name hanya membatalkan pekerjaan yang dilakukan setelahnya, dan transaksinya berlanjut:

Log-nya berisi "import users" dan "import products". Langkah orders dibatalkan tanpa kehilangan insert pertama. RELEASE SAVEPOINT name melupakan savepoint yang tidak kamu butuhkan lagi.

Mengatasi "current transaction is aborted"

Saat sebuah pernyataan gagal di dalam transaksi, PostgreSQL menandai seluruh transaksi sebagai gagal dan menolak setiap pernyataan berikutnya sampai kamu mengakhirinya:

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;

Solusinya ROLLBACK. COMMIT pada transaksi yang aborted tidak menyimpan apa pun; PostgreSQL menjawab ROLLBACK. Untuk tetap lanjut setelah error yang sudah diperkirakan, pasang savepoint sebelum pernyataan yang berisiko lalu rollback ke savepoint itu. Driver dan ORM yang menawarkan "nested transaction" bekerja dengan cara ini.

Perubahan tabel juga bisa di-rollback

CREATE TABLE, ALTER TABLE, DROP TABLE, dan sebagian besar DDL lainnya bersifat transaksional, jadi migrasi yang gagal di tengah jalan tidak meninggalkan sisa apa pun:

to_regclass mengembalikan NULL: tabel itu tidak pernah ada bagi orang lain. Beberapa perintah menolak berjalan di dalam blok transaksi, di antaranya VACUUM, CREATE DATABASE, dan CREATE INDEX CONCURRENTLY.

Memilih level isolasi

Level isolasi menentukan commit dari sesi lain mana yang dilihat oleh sebuah transaksi. Atur dengan BEGIN ISOLATION LEVEL ....

LevelApa yang dilihat setiap pernyataanKapan memakainya
READ COMMITTED (default)Data yang di-commit sebelum pernyataan dimulaiSebagian besar aplikasi
REPEATABLE READSatu snapshot yang diambil saat query pertama transaksiLaporan dan ekspor yang harus konsisten
SERIALIZABLESeperti REPEATABLE READ, dan PostgreSQL membatalkan transaksi yang hasilnya bisa berbeda dari menjalankannya satu per satuAturan bisnis yang membaca lalu menulis

READ UNCOMMITTED diterima tapi berperilaku seperti READ COMMITTED: PostgreSQL tidak pernah menampilkan data yang belum di-commit. Di bawah REPEATABLE READ dan SERIALIZABLE, bersiaplah menerima error dengan SQLSTATE 40001 ("could not serialize access") dan ulangi seluruh transaksi saat mendapatkannya.

Mengunci baris yang akan kamu ubah

Untuk mencegah sesi lain mengubah baris di antara pembacaan dan penulisanmu, kunci baris itu saat dibaca dengan FOR UPDATE. Penulis lain menunggu sampai kamu melakukan commit:

BEGIN;
SELECT balance FROM accounts WHERE name = 'alice' FOR UPDATE;
UPDATE accounts SET balance = balance - 30 WHERE name = 'alice';
COMMIT;

Jaga transaksi tetap singkat

Transaksi yang terbuka menahan lock barisnya sampai selesai, dan mencegah VACUUM menghapus versi baris lama. Sesi yang tertinggal dalam status "idle in transaction" karena skrip yang crash bisa memblokir penulis lain selama berjam-jam. Atur idle_in_transaction_session_timeout untuk mengakhiri sesi seperti itu secara otomatis.

Di dalam transaksi, now() mengembalikan waktu yang sama untuk setiap pernyataan: waktu transaksi dimulai (lihat fungsi tanggal). Tutorial resmi tentang transaksi memuat lebih banyak contoh.

Pertanyaan yang sering diajukan

Apakah PostgreSQL memakai autocommit?

Ya. Pernyataan yang dikirim di luar BEGIN berjalan dalam transaksinya sendiri dan di-commit saat selesai. Beberapa driver membaliknya: psycopg di Python membuka transaksi untukmu dan menunggu commit(), kecuali kamu menyalakan autocommit.

Apa level isolasi default di PostgreSQL?

READ COMMITTED. Setiap pernyataan melihat data yang sudah di-commit sebelum pernyataan itu dimulai. Pakai BEGIN ISOLATION LEVEL REPEATABLE READ atau SERIALIZABLE saat sebuah transaksi harus melihat satu snapshot yang konsisten.

Bisakah CREATE TABLE atau ALTER TABLE di-rollback di PostgreSQL?

Bisa. Hampir semua DDL di PostgreSQL bersifat transaksional, jadi CREATE, ALTER, atau DROP di dalam transaksi hilang saat ROLLBACK. Beberapa perintah, seperti CREATE DATABASE, VACUUM, dan CREATE INDEX CONCURRENTLY, sama sekali tidak bisa berjalan di dalam blok transaksi.

Apa perbedaan COMMIT dan END di PostgreSQL?

Tidak ada. END adalah extension PostgreSQL yang sama dengan COMMIT, dan START TRANSACTION adalah ejaan standar dari BEGIN.

Ilustrasi bahasa pemrograman di Coddy

Belajar coding dengan Coddy

Mulai