// PostgreSQL 오류 참조

PostgreSQL 57014: 명령문 취소 중

쿼리가 취소되었습니다. statement_timeout을 넘겼거나 클라이언트나 관리자가 취소를 요청했기 때문입니다.

SQLSTATE
57014
이름
query_canceled
카테고리
작업자 개입 필요
오류 메시지
canceling statement due to statement timeout

의미

57014는 실행 중인 명령문이 완료되기 전에 취소되었음을 의미합니다. 메시지는 그 이유를 설명합니다: canceling statement due to statement timeout 실행 시간이 다음보다 길었을 때 statement_timeout, 그리고 canceling statement due to user request 클라이언트가 취소를 눌렀을 때(psql에서 Ctrl+C, 드라이버의 취소 호출) 또는 누군가 실행했을 때 pg_cancel_backend() 에서.

문장만 취소되고 세션은 연결된 상태로 유지됩니다. 트랜잭션 블록 내에서는 트랜잭션이 이제 실패했으며 롤백해야 합니다.

일반적인 원인

  • A statement_timeout 쿼리가 초과한 서버, 데이터베이스, 역할 또는 세션에 설정되어 있습니다.
  • 직접 취소했거나 사용 중인 도구가 취소했습니다.
  • 관리자나 모니터링 작업이 다음 명령으로 취소했습니다 pg_cancel_backend(pid).
  • 느린 쿼리: 인덱스 부재, 잘못된 실행 계획, 또는 잠금을 기다리다 타임아웃이 터진 경우.

해결 방법

  1. 어떤 타임아웃이 적용되는지, 어디서 설정됐는지 확인하세요.

    SHOW statement_timeout;
    SELECT name, setting, source FROM pg_settings WHERE name = 'statement_timeout';
  2. 전역으로 늘리지 말고, 실제로 더 긴 시간이 필요한 세션이나 트랜잭션 하나에만 늘리세요.

    SET statement_timeout = '10min';
    -- or only for this transaction:
    BEGIN;
    SET LOCAL statement_timeout = '10min';
    -- long-running work
    COMMIT;
  3. 쿼리를 더 빠르게 하려면: 실행 계획에서 큰 테이블의 순차 스캔을 찾아 필요한 인덱스를 추가하세요.

    EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM orders WHERE customer_id = 42;
  4. 잠금을 기다리고 있었다면 차단 원인인 세션을 찾으세요.

    SELECT pid, pg_blocking_pids(pid) AS blocked_by, wait_event_type, query
    FROM pg_stat_activity
    WHERE cardinality(pg_blocking_pids(pid)) > 0;

안전하게 재현하세요

SET statement_timeout = '1s';
SELECT pg_sleep(5);  -- ERROR: canceling statement due to statement timeout
RESET statement_timeout;

관련 오류

그 밖의 운영자 개입 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.