PostgreSQL 25001: 트랜잭션 블록 안에서는 실행할 수 없음
일부 명령(VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM)은 BEGIN ... COMMIT 밖에서 단독으로 실행해야 합니다.
- SQLSTATE
25001- 이름
active_sql_transaction- 카테고리
- 잘못된 트랜잭션 상태
의미
일부 PostgreSQL 명령은 트랜잭션을 직접 관리하거나 롤백할 수 없어서, 명시적 트랜잭션 블록 안에서는 실행을 거부합니다: VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE 등이 있습니다. 이어서 실행하면 BEGIN 25001 오류로 실패합니다 (active_sql_transaction).
문제는 많은 툴과 드라이버가 자동으로 트랜잭션을 열어준다는 점입니다: 마이그레이션 프레임워크는 각 마이그레이션마다 하나씩 트랜잭션으로 감싸고, 오토커밋이 꺼진 클라이언트는 암시적으로 트랜잭션을 시작합니다.
일반적인 원인
- 마이그레이션 프레임워크는 모든 마이그레이션을 트랜잭션 안에서 실행합니다.
- 클라이언트나 드라이버가 자동 커밋을 꺼 놓았습니다 (psycopg2의 기본값, JDBC 사용 시
setAutoCommit(false)), 그래서 모든 문이 트랜잭션 안에서 실행됩니다. - 스크립트가 여러 문장을 하나의 다중 문장 쿼리 문자열로 보내면 PostgreSQL이 이를 하나의 암시적 트랜잭션으로 실행합니다.
- 함수에서 명령을 호출하거나
DO항상 트랜잭션 내부에서 실행되는 블록.
해결 방법
-
autocommit이 켜진 상태로 명령을 단독으로 실행하세요. psql에서는 이것이 기본값이고, 다음 사이에 넣기만 하지 마세요
BEGIN그리고COMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
드라이버에서 이 문장에 대해 자동 커밋을 켜세요(psycopg:
conn.autocommit = True). -
마이그레이션 도구에서는 해당 마이그레이션을 트랜잭션으로 묶이지 않게 표시하세요. 대부분의 프레임워크에 이런 옵션이 있습니다.
-
각 명령을 다른 명령과 결합하지 말고 별도의 쿼리로 보내세요.
안전하게 재현하세요
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
관련 오류
그 밖의 잘못된 트랜잭션 상태 오류
코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 PostgreSQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.