#postgresql

상관 서브쿼리에 한정자 없는 컬럼 이름을 넘기면 가장 안쪽 테이블의 컬럼으로 해석되어 조건이 항상 참이 됩니다. 문자열 조각으로 SQL 을 조립할 때 겪은 함정과 방어 방법입니다.

전문검색이 느린 원인은 인덱스가 아니라 스니펫을 만드는 ts_headline 이었습니다. 입력을 앞 8KB 로 캡해 266ms 를 3ms 로 줄인 과정을 정리했습니다.

실패해도 되는 조회를 try/catch 로 삼켰더니 앞선 UPDATE 까지 사라졌습니다. aborted 트랜잭션의 COMMIT 이 에러 없이 ROLLBACK 이 되는 이유와 SAVEPOINT 로 막는 방법입니다.

pool.connect() 로 빌린 연결에 error 리스너를 달지 않으면, 쉬는 동안 연결이 끊기는 순간 Node 프로세스 전체가 죽습니다. advisory lock 연결을 예로 원인과 리스너 처리 패턴을 정리했습니다.

복합 인덱스의 선두 컬럼을 조건절에서 빼면, 카디널리티가 1이라 무의미해 보여도 인덱스 전체가 Seq Scan으로 죽습니다. 상수로 채워 넣자 35초가 525ms로 줄었습니다.

링크 테이블을 조인해 SUM하면 같은 파일이 여러 번 더해져, 중복 링크는 전체의 2%뿐인데도 400GB 넘게 과다 계상됩니다. 물리 파일로 되돌려 더해야 합니다.

OR로 묶인 조건은 한쪽에 인덱스가 없으면 전체가 Seq Scan으로 떨어져, idx_scan=0인 인덱스도 불필요해서가 아니라 잠긴 것일 수 있습니다. 쿼리를 둘로 분리하자 응답이 3,866ms에서 137ms로 줄었습니다.

PostgreSQL에서 조건부 SQL 빌더 사용 시 참조되지 않는 파라미터가 포함되면 42P18 오류가 발생하므로 절과 파라미터를 함께 관리하고 실제 DB 파싱 테스트를 통해 검증해야 합니다

EXISTS 서브쿼리는 semi join 행 수를 실제보다 극단적으로 적게 추정해 플래너가 인덱스의 조기 종료 이득을 0으로 보고 Sort 를 유지하는데, MATERIALIZED CTE 로 EXISTS 를 격리하면 130ms가 3ms로 줄어듭니다.

PostgreSQL 인덱스는 부분·복합·커버링(INCLUDE)·표현식 인덱스로 작고 정확하게 좁힐 수 있고, jsonb·배열은 GIN, 시계열 대용량은 BRIN이 적합하며, CONCURRENTLY·EXPLAIN으로 안전하게 운영합니다.

PostgreSQL 에서 varchar(n) 과 text 는 저장 구조(varlena)가 같아 성능 차이가 없고, varchar(n) 은 임의의 길이 제한으로 운영 장애만 유발하므로 기본값은 text + CHECK 를 권장합니다.

pgvector 는 PostgreSQL 에 vector(N) 컬럼과 코사인 연산자(<=>)를 더해 별도 벡터 DB 없이 시맨틱 검색을 구현하며, 데이터가 자주 바뀌면 recall 높은 HNSW 인덱스가 기본 선택지입니다.

PostgreSQL 의 Repeatable Read 는 스냅샷 격리로 phantom read 까지 막지만 write skew 는 허용하며, 이를 막으려면 Serializable 로 올리고 40001 재시도 로직을 짝지어야 합니다.

운영 중 스키마 변경은 한 번에 바꾸지 않고 expand→migrate→contract 로 나눠야 무중단이 되며, CREATE INDEX CONCURRENTLY 와 NOT VALID→VALIDATE 로 강한 락을 피합니다.

PostgreSQL 은 연결마다 OS 프로세스를 띄워 연결 고갈이 나기 쉬우며, PgBouncer 를 transaction 모드로 두면 서버 연결을 소수로 묶지만 prepared statement·SET·advisory lock 이 깨질 수 있습니다.

OFFSET 은 깊은 페이지일수록 앞 행을 다 읽고 버려 선형으로 느려지고 데이터 변경 중 중복·누락도 생기지만, keyset(커서) 는 정렬 키로 바로 점프해 성능과 정확성을 모두 지킵니다.

PostgreSQL 의 DISTINCT ON·LATERAL·FILTER·EXCLUDE·SKIP LOCKED 등 8가지 기능을 쓰면 그룹별 조회·정합성·동시성 제어를 애플리케이션 코드 대신 DB 레벨에서 해결합니다.