Menu

PostgreSQL トランザクション:BEGIN・COMMIT・ROLLBACK

PostgreSQL のトランザクションの仕組みを解説します。BEGIN、COMMIT、ROLLBACK、セーブポイント、エラーが起きたときの挙動、分離レベルまで押さえます。

このページのコードはエディタで実行できます。編集してすぐに結果を確認できます。

トランザクションは複数の文をまとめ、すべてが反映されるか、何も反映されないかのどちらかにします。BEGIN で開始し、COMMIT で確定し、ROLLBACK で BEGIN 以降の変更をすべて取り消します。コミットするまで、他のセッションから変更は見えません。

Alice は 70、Bob は 80 になります。2つの更新の間でサーバーがクラッシュしても、どちらの更新も残りません。お金が一方の口座から出たのに、もう一方に届かないということは起きません。

ROLLBACK で変更を取り消す

ROLLBACK は BEGIN 以降のすべての変更を破棄します。

DELETE はトランザクション内で3行すべてを削除しましたが、ロールバックで元に戻り、件数は 3 です。psql で手作業の危険な UPDATE や DELETE をするときも同じように包みます。BEGIN の後に実行し、SELECT で結果を確認してから COMMIT か ROLLBACK を選びます。

BEGIN がなければ、PostgreSQL は各文を独自のトランザクションで実行し、終わるとコミットします (自動コミット)。ドライバーによって動きが異なり、Python の psycopg は最初の文でトランザクションを開始して 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 と応答します。想定内のエラーの後も処理を続けたいときは、危険な文の前にセーブポイントを置き、そこまでロールバックします。「ネストしたトランザクション」を提供するドライバーや ORM はこの仕組みで動いています。

テーブルの変更もロールバックできる

CREATE TABLE、ALTER TABLE、DROP TABLE をはじめ、ほとんどの DDL はトランザクションに対応しています。途中で失敗したマイグレーションは何も残しません。

to_regclass は NULL を返します。このテーブルは他の誰から見ても存在しなかったことになります。VACUUM、CREATE DATABASE、CREATE INDEX CONCURRENTLY など一部のコマンドは、トランザクションブロックの中では実行できません。

分離レベルを選ぶ

分離レベルは、トランザクションが他のセッションのコミットをどこまで見るかを決めます。BEGIN ISOLATION LEVEL ... で設定します。

レベル各文に見えるもの使いどころ
READ COMMITTED (デフォルト)文の開始前にコミットされたデータほとんどのアプリケーション
REPEATABLE READトランザクションの最初のクエリ時点で取った1つのスナップショット一貫性が必要なレポートやエクスポート
SERIALIZABLEREPEATABLE READ と同じで、さらに1つずつ順に実行した場合と結果が変わりうるトランザクションを PostgreSQL がキャンセルする読んでから書く業務ルール

READ UNCOMMITTED も指定できますが、動作は READ COMMITTED と同じです。PostgreSQL が未コミットのデータを見せることはありません。REPEATABLE READ と SERIALIZABLE では SQLSTATE 40001 ("could not serialize access") のエラーが起こりうるので、受け取ったらトランザクション全体をやり直します。

これから変更する行をロックする

読んでから書くまでの間に別のセッションが行を変更しないよう、FOR UPDATE で読むと同時にロックします。他の書き込みはコミットするまで待たされます。

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

トランザクションは短く保つ

開いたままのトランザクションは、終わるまで行ロックを持ち続け、VACUUM が古い行バージョンを削除するのも妨げます。クラッシュしたスクリプトが「idle in transaction」のまま残したセッションは、他の書き込みを何時間もブロックすることがあります。idle_in_transaction_session_timeout を設定すると、そうしたセッションを自動で終了できます。

トランザクション内では、now() はどの文でも同じ時刻、つまりトランザクションが始まった時刻を返します (日付関数 を参照)。トランザクションに関する公式チュートリアル にも例があります。

よくある質問

PostgreSQL は自動コミットですか?

はい。BEGIN の外で送った文はそれぞれ独自のトランザクションで実行され、終わるとコミットされます。ドライバーによっては逆の動きをします。Python の psycopg は自動でトランザクションを開始し、自動コミットを有効にしない限り commit() を待ちます。

PostgreSQL のデフォルトの分離レベルは何ですか?

READ COMMITTED です。各文は、その文が始まる前にコミットされたデータを見ます。トランザクション全体で一貫したスナップショットが必要なときは BEGIN ISOLATION LEVEL REPEATABLE READ または SERIALIZABLE を使います。

PostgreSQL で CREATE TABLE や ALTER TABLE をロールバックできますか?

できます。PostgreSQL の DDL はほぼすべてトランザクションに対応しているので、トランザクション内の CREATE、ALTER、DROP は ROLLBACK で消えます。CREATE DATABASE、VACUUM、CREATE INDEX CONCURRENTLY など一部のコマンドは、そもそもトランザクションブロックの中では実行できません。

PostgreSQL の COMMIT と END の違いは何ですか?

違いはありません。END は COMMIT と同じ働きをする PostgreSQL の拡張です。また START TRANSACTION は BEGIN の標準 SQL での書き方です。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める