--- title: Runbook — DB_QUERY_CANCELED (쿼리 취소) category: TRANSIENT_DEPENDENCY error_codes: [DB_QUERY_CANCELED] severity: P2 owner: oncall last_updated: 2026-11-07 status: 초안 --- # Runbook: DB_QUERY_CANCELED (`runbook://db/query-canceled`) ## 증상 - HTTP 503, `error.code=DB_QUERY_CANCELED`. - SQLState 57014. 쿼리가 문장 시간 상한을 넘었다. ## 진단 - Postgres의 `statement_timeout`을 확인한다. 템플릿은 트랜잭션 시간 상한 (`app.persistence-jpa.transaction.write-timeout`·`read-timeout`)의 남은 시간을 문장마다 넘기므로, 그 상한을 넘긴 문장도 이 코드로 끝난다. - `pg_stat_statements`에서 느린 쿼리를 찾는다. ## 조치 - 느린 쿼리를 고치거나 인덱스를 더한다. - 정말 오래 걸려야 하는 쿼리면 시간 상한을 조정한다. ## 에스컬레이션 - 반복되면 쿼리 최적화를 DBA에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.