전체 글32 PostgreSQL pg_stat_statements로 느린 쿼리 찾는 법, 설치부터 reset·insufficient privilege까지 (직접 실행 결과) DB가 느려졌다는 말을 들었을 때 가장 먼저 떠오르는 질문은 "어떤 쿼리가 느린가"다. 그런데 정말 먼저 물어야 할 질문은 따로 있다. 어떤 쿼리가 DB 시간을 가장 많이 쓰고 있는가? 한 번에 0.01ms 걸리는 쿼리도 2만 번 돌면 무시할 수 없고, 120ms짜리 쿼리도 30번이면 전체를 잡아먹을 수 있다.pg_stat_statements는 이 질문에 답하는 확장이다. 이 글은 PostgreSQL 16.16 로컬 임시 클러스터에서 설치, 상위 쿼리 찾기, 인덱스로 고친 뒤 비교, 권한 문제, 통계 비우기까지 직접 실행한 결과로 정리한다.요약shared_preload_libraries에 넣고 재시작해야 동작한다. 확장만 만들면 에러가 난다.먼저 total_exec_time 순으로 본다. 평균이 아니라 .. 2026. 11. 19. PostgreSQL 테이블 크기 조회 쿼리, pg_total_relation_size와 \dt+가 다른 이유 (인덱스·TOAST·파티션까지 실수 6가지) 디스크가차오를 때 가장 먼저 하는 일은 "어느 테이블이 큰가"를 보는 것이다. 그런데 \dt+에 나온 숫자나 pg_relation_size 하나만 보고 판단하면 실제 차지하는 공간의 절반만 보는 경우가 흔하다. 아래 테스트에서는 \dt+가 62 MB라고 한 테이블이 인덱스까지 97 MB였고, 본문 1.3 MB짜리 테이블이 TOAST까지 80 MB였다.이 글은 테이블 크기를 조회할 때 자주 하는 실수 6가지를, PostgreSQL 16.2에서 직접 만든 테이블로 하나씩 재현한다. 마지막에 그대로 복사해 쓰는 조회 쿼리와 점검 체크리스트를 붙였다.요약테이블이 차지하는 전체 공간은 pg_total_relation_size (본문 + TOAST + 인덱스)\dt+와 pg_table_size는 인덱스를 뺀 크기,.. 2026. 11. 19. PostgreSQL 접속 안 될 때 확인 순서, connection refused부터 no pg_hba.conf entry·password authentication failed까지 에러 9가지 (PG16 재현) 앱 서버나 DBeaver에서 PostgreSQL에 붙으려는데 에러만 돌아온다. 메시지는 비슷해 보여도 막힌 자리가 다르다. 서버 문 앞에서 막혔는지, 출입 명단(pg_hba.conf)에서 막혔는지, 비밀번호에서 막혔는지, DB 이름에서 막혔는지에 따라 고칠 파일이 달라진다.이 글은 PostgreSQL 16.2 테스트 클러스터를 새로 띄워 접속 에러 9가지를 일부러 만들고, 메시지 원문과 서버 로그를 그대로 옮긴 것이다. 확인 순서대로 따라가면 어디서 막혔는지 좁힐 수 있다. 전체 스크립트와 출력은 이 글 폴더의 실행스크립트.sh, 실행결과.txt에 있다.단계메시지 앞부분고칠 곳1Connection refused서버 상태, 포트, listen_addresses2no pg_hba.conf entry / re.. 2026. 11. 18. pg_dump 백업과 pg_restore 복구 방법, 형식 4가지 크기 비교와 복구할 때 나는 에러 6가지 (PG16 실행 결과) 20,045KB vs 1,088KB같은 DB(38MB)를 pg_dump plain 형식과 custom(-Fc) 형식으로 백업한 파일 크기같은 데이터베이스를 같은 pg_dump로 백업했는데 파일 크기가 18배 넘게 차이 났다. 형식 옵션 하나 차이다. 그리고 이 형식 선택이 나중에 복구할 때 pg_restore를 쓸 수 있는지, 테이블 하나만 골라 살릴 수 있는지, 병렬 복구가 되는지까지 정한다.이 글은 PostgreSQL 16.2에서 주문 20만 건짜리 예제 DB를 만들어 pg_dump 형식 4가지로 백업하고, pg_restore로 복구하면서 실제로 만난 에러 6가지를 메시지 원문 그대로 정리한 것이다. 전체 스크립트와 출력은 이 글 폴더의 실행스크립트.sh, 실행결과.txt에 있다.먼저 결론에 해당하는.. 2026. 11. 17. 오라클 NVL·DECODE·ROWNUM을 PostgreSQL로 바꾸는 법, coalesce·CASE·LIMIT로 옮길 때 결과가 달라지는 5가지 (실행 예제) 결론부터 적으면 NVL은 coalesce, DECODE는 CASE, ROWNUM은 ORDER BY + LIMIT 또는 row_number()로 바꾸면 된다. 여기까지는 변환표 한 장이면 끝난다. 문제는 이름만 바꿨는데 에러가 나거나, 더 나쁘게는 에러 없이 결과가 달라지는 경우다.이 글은 세 함수를 PostgreSQL로 옮길 때 실제로 부딪히는 차이를 오라클 문서와 나란히 놓고, PostgreSQL 16에서 직접 돌린 결과로 보여 준다.한 줄 요약NVL → coalesce (타입을 맞춰야 하고 빈 문자열은 NULL이 아니다), DECODE → CASE (NULL끼리는 같지 않다), ROWNUM → ORDER BY 뒤 LIMIT/FETCH FIRST, 번호가 필요하면 row_number() OVER.메모오.. 2026. 11. 15. ORA-12514 원인과 해결, listener does not currently know of service 에러를 lsnrctl services로 푸는 순서 (PostgreSQL 비교 실행) 접속 에러 세 개를 나란히 놓으면 ORA-12514가 어디서 막혔는지 바로 보인다. ORA-12154는 클라이언트가 tnsnames.ora에서 별칭을 못 찾은 것이고, ORA-12541은 그 주소에 리스너가 아예 없는 것이다. ORA-12514는 리스너까지는 갔는데, 리스너가 요청한 서비스 이름을 모르는 것이다. 네트워크와 포트는 이미 맞았다는 뜻이니, 볼 곳은 서비스 이름과 서비스 등록 두 가지로 좁혀진다.예전 버전에서는 ORA-12514: TNS:listener does not currently know of service requested in connect descriptor로 많이 봤고, 오라클 26ai 문서에는 메시지가 더 친절하게 바뀌어 있다. 이 글은 오라클 공식 문서를 기준으로 확인 순서.. 2026. 11. 12. 오라클 SQL Plan Baseline 생성·확인·evolve·삭제 순서 (19c, PostgreSQL 비교 실행) "SQL Plan Baseline을 걸어 두면 그 SQL은 그 계획으로 영원히 고정된다." 실무에서 자주 듣는 말인데, 오라클 문서가 설명하는 동작은 조금 다르다. 베이스라인은 계획 하나를 못 박는 기능이 아니라 검증된 계획 목록이다. 옵티마이저는 그 목록 안에서 비용이 가장 낮은 계획을 고르고, 새로 찾은 계획은 일단 "미승인"으로 쌓아 둔다. 목록에 있는 계획을 하나도 재현할 수 없으면(예: 계획이 쓰던 인덱스를 지운 경우) 결국 새 계획으로 실행한다.이 글은 실행계획이 통계 때문에 바뀌는 원리를 PostgreSQL 16에서 직접 재현해 보고, 오라클에서 SQL Plan Baseline으로 좋은 계획을 붙잡는 순서를 19c 문서 기준으로 정리한다. 2026년 7월에 쓴 글을 고쳐 쓰면서 공식 문서 링.. 2026. 11. 12. ORA-01017 invalid username/password 원인과 해결, 26ai 메시지 변경과 SYSDBA 접속까지 (PostgreSQL 비교 실행) ORA-01017 메시지가 바뀌었다. 19c와 21c에서는 ORA-01017: invalid username/password; logon denied였는데, 오라클 26ai 문서에는 ORA-01017: invalid credential or not authorized; logon denied로 나온다. "비밀번호가 틀렸다"에서 "자격 증명이 틀렸거나 권한이 없다"로 넓어진 셈이다.실제로 이 에러는 비밀번호 오타만으로 나지 않는다. 사용자 이름의 대소문자, 접속한 컨테이너, 비밀번호가 저장된 방식, SYSDBA 접속에 쓰는 비밀번호 파일까지 원인이 여러 갈래다. 이 글은 오라클 공식 문서를 기준으로 원인을 질문 형태로 하나씩 짚고, 같은 상황을 PostgreSQL 16에서 직접 재현해 두 DB가 로그인 실.. 2026. 11. 10. PostgreSQL 권한 부여·조회 정리, GRANT를 줬는데 permission denied가 나는 6가지 경우 (PG16 실행 결과) GRANT SELECT ON app.orders TO report_user;를 실행하고 GRANT 메시지까지 확인했다. 그런데 report_user로 접속해 조회하면 여전히 permission denied가 나온다. 왜 그럴까?오라클에서 넘어온 사람이 PostgreSQL 권한에서 가장 많이 막히는 지점이 여기다. 오라클은 테이블에 SELECT만 주면 끝나지만, PostgreSQL은 데이터베이스 → 스키마 → 객체 세 겹을 다 통과해야 한다. 게다가 시퀀스, 앞으로 만들 테이블, 테이블을 누가 만들었는지까지 권한에 영향을 준다.이 글은 PostgreSQL 16.2 테스트 클러스터에 롤 다섯 개를 만들고, 실제로 에러가 나는 순서대로 실행한 결과를 그대로 옮겼다. 에러 메시지별로 원인과 해결을 붙였으니, 지.. 2026. 11. 9. psql 자주 쓰는 명령어 정리, \l \dt \d+ \x부터 \copy \watch까지 (오라클 SQL*Plus와 비교) SQL*Plus에 익숙한 사람이 psql을 처음 켜면 손이 먼저 DESC를 친다. 그리고 psql에는 DESC가 없다는 걸 알게 된다. SET LINESIZE도, SPOOL도, @스크립트도 이름이 다르다.psql은 PostgreSQL에 기본으로 들어 있는 명령줄 클라이언트다. 백슬래시(\)로 시작하는 메타 명령이 SQL*Plus의 SET·DESCRIBE·SPOOL 역할을 나눠 맡는다. 이 글은 기능을 알파벳순으로 나열하지 않고, 실무에서 실제로 마주치는 상황 열두 가지에 맞춰 어떤 명령을 치면 되는지 정리했다.모든 출력은 PostgreSQL 16.2와 psql 16.2로 테스트 클러스터를 만들어 직접 실행한 결과다. 예제 DB는 shopdb, 스키마는 app, 테이블은 고객 1,000건과 주문 2만 건이.. 2026. 11. 8. PostgreSQL 인덱스를 안 타는 이유 6가지, 50만 건에서 EXPLAIN ANALYZE로 직접 확인한 결과 (함수·형변환·LIKE·복합 인덱스·통계) 인덱스를 만들었는데 실행 계획에 Seq Scan이 나오면 먼저 옵티마이저를 의심하기 쉽다. "PostgreSQL은 힌트도 없는데 왜 내 인덱스를 무시하지?"실제로 확인해 보면 옵티마이저가 고집을 부리는 경우는 드물다. 대부분은 쿼리가 인덱스를 쓸 수 없는 모양이거나, 안 쓰는 쪽이 더 빠른 상황이거나, 통계가 현실과 다른 경우다. 그리고 의외로 많이 놓치는 경우가 하나 더 있다. 실행 계획에 인덱스 이름이 나왔는데도 느린 경우다.50만 건 테스트 테이블에서 여섯 가지 원인을 하나씩 재현하고, 고친 뒤의 실행 계획과 비교했다. 테스트 환경은 PostgreSQL 16.2(Windows 노트북, DB 정렬 규칙 Korean_Korea.949)이다. 실행 시간은 환경마다 다르니 차이의 크기를 보면 된다.01테스.. 2026. 11. 6. PostgreSQL SERIAL vs IDENTITY 차이, 시퀀스 값이 꼬여 duplicate key가 날 때 setval로 맞추는 법 데이터 이관을 끝내고 애플리케이션을 붙였는데 첫 INSERT부터 이런 에러가 난다면?ERROR: duplicate key value violates unique constraint "member_ident_def_pkey"DETAIL: Key (id)=(1) already exists.테이블에는 1번부터 1,000번까지 데이터가 들어 있다. 그런데 시퀀스는 여전히 1부터 번호를 주고 있다. 오라클에서 넘어온 데이터, pg_dump로 일부만 옮긴 데이터, 엑셀로 밀어 넣은 데이터에서 자주 보는 장면이다.이 글은 자동 증가 컬럼을 만드는 두 가지 방법, SERIAL과 IDENTITY의 차이를 실제로 실행해 비교한다. 그리고 시퀀스가 꼬였을 때 맞추는 방법을 정리한다. 테스트는 PostgreSQL 16.2.. 2026. 11. 5. PostgreSQL JSONB 조회·검색·UPDATE 사용법, 30만 건에서 인덱스 유무로 1,000배 차이 난 쿼리 108ms와 0.08ms. 30만 건짜리 JSONB 테이블에서 같은 조건을 두 가지 방법으로 쓴 결과다.JSONB는 "스키마 없이 아무거나 넣을 수 있는 컬럼"으로 시작하기 쉽다. 문제는 조회할 때다. ->>로 꺼내서 비교하는 쿼리는 GIN 인덱스를 만들어 둬도 쓰지 않는다. 숫자를 문자로 비교하면 에러 없이 틀린 건수가 나온다. jsonb_set은 중간 경로가 없으면 아무 일도 하지 않는다.이 글은 그런 실수 다섯 가지를 실제로 실행한 결과와 함께 정리한다. 테스트 환경은 PostgreSQL 16.2(Windows 노트북), 30만 건 테스트 테이블이다. 실행 시간은 환경마다 다르니 차이의 크기만 보면 된다.테스트 테이블: 주문 정보를 JSONB 한 컬럼에CREATE TABLE orders ( id .. 2026. 11. 5. ORA-01722 수치가 부적합합니다 원인과 해결, 문자 컬럼 비교·TO_NUMBER·VALIDATE_CONVERSION (PostgreSQL 비교) 어제까지 잘 돌던 쿼리가 오늘 갑자기 ORA-01722: invalid number(수치가 부적합합니다)로 멈춘다. 쿼리는 하나도 안 바꿨는데 말이다. 이 에러는 대부분 숫자로 바꿀 수 없는 문자열이 데이터에 한 줄 들어왔을 때 터진다. 그래서 개발 DB에서는 멀쩡하고 운영 DB에서만 나는 경우가 많다.원인 1순위문자 컬럼을 숫자와 비교하는 암시적 형변환결론부터 말하면, 원인 행은 VALIDATE_CONVERSION으로 찾고, 해결은 비교 대상을 문자로 맞추거나 TO_NUMBER(... DEFAULT NULL ON CONVERSION ERROR)로 막는다 (12.2부터).재현 예제CREATE TABLE orders ( order_id NUMBER, amount_txt VARCHAR2(20) -.. 2026. 10. 27. 오라클 MERGE INTO 사용법, 있으면 UPDATE 없으면 INSERT와 ORA-30926 해결 (PostgreSQL MERGE 비교) 배치 작업을 짜다 보면 "있으면 수정, 없으면 입력"을 한 번에 처리해야 할 때가 많다. 먼저 SELECT로 존재 여부를 확인하고 UPDATE나 INSERT를 따로 부르면 쿼리가 두 번 돌고, 그 사이에 다른 세션이 끼어들 수도 있다. 오라클에서는 이걸 MERGE INTO 한 문장으로 끝낸다.한 줄 요약MERGE INTO 대상 USING 원본 ON (조건) WHEN MATCHED THEN UPDATE WHEN NOT MATCHED THEN INSERT. 원본에 같은 키가 두 번 있으면 ORA-30926이 난다. PostgreSQL도 15부터 같은 MERGE 문법을 쓴다.예제 테이블상품 마스터(product)에 오늘 받은 상품 파일(product_stage)을 반영하는 상황이다.CREATE TABLE pr.. 2026. 10. 26. 오라클 DBMS_STATS 통계 수집 방법 (19c), GATHER_TABLE_STATS·GATHER_SCHEMA_STATS·LOCK·RESTORE 정리 야간 배치로 테이블에 수백만 건을 넣은 다음 날 아침, 평소 0.1초 걸리던 쿼리가 몇 분씩 걸리는 일이 있다. 실행계획을 열어 보면 인덱스를 타던 쿼리가 풀 스캔으로 바뀌어 있다. 이런 경우 원인은 대부분 옵티마이저 통계가 실제 데이터와 맞지 않아서다. 오라클에서 통계를 다루는 도구가 DBMS_STATS 패키지다. 수집, 확인, 고정(LOCK), 되돌리기(RESTORE)까지 실무에서 쓰는 순서대로 정리했다.한 줄 요약테이블 하나: DBMS_STATS.GATHER_TABLE_STATS('스키마', '테이블'), 기본값(샘플 AUTO, 히스토그램 AUTO)을 그대로 쓰는 것이 오라클 권장통계가 오래됐는지: DBA_TAB_STATISTICS.STALE_STATS (행의 10% 이상 바뀌면 YES)통계 바꾸고.. 2026. 10. 26. 오라클 계층형 쿼리 CONNECT BY를 PostgreSQL WITH RECURSIVE로 바꾸는 법 (LEVEL, SYS_CONNECT_BY_PATH, NOCYCLE) 오라클에서 조직도, 메뉴 트리, BOM(부품 구성표)을 조회할 때 쓰던 START WITH ... CONNECT BY PRIOR는 PostgreSQL에 없다. PostgreSQL로 옮기면 같은 결과를 WITH RECURSIVE(재귀 CTE)로 만들어야 한다. 문법이 낯설어서 처음에는 막막하지만, LEVEL, SYS_CONNECT_BY_PATH, ORDER SIBLINGS BY, NOCYCLE마다 바꾸는 공식이 정해져 있다. 이 글은 오라클 쿼리와 PostgreSQL 쿼리를 나란히 놓고 하나씩 바꿔 본다.한 줄 요약START WITH → 재귀 CTE의 앵커(첫 SELECT), CONNECT BY PRIOR id = parent_id → 재귀 SELECT의 JOIN 조건LEVEL·SYS_CONNECT_BY_.. 2026. 10. 25. PgBouncer란? PostgreSQL 커넥션 풀 설정 방법과 언제 필요한지 (pool_mode, pgbouncer.ini) 애플리케이션 서버를 2대에서 6대로 늘리면 흔히 PostgreSQL에서 FATAL: sorry, too many clients already가 나기 시작한다. 앱마다 커넥션 풀을 20개씩 잡고 있다면 그것만으로 120개다. max_connections를 올리면 당장은 해결되지만, PostgreSQL은 커넥션 하나가 서버 프로세스 하나라서 연결이 늘어날수록 메모리와 문맥 전환 비용이 같이 커진다. 이때 앞에 두는 것이 PgBouncer다.한 줄 요약PgBouncer는 PostgreSQL 앞에 두는 가벼운 커넥션 풀러다. 클라이언트 연결 수천 개를 실제 DB 연결 수십 개로 묶어 준다.웹 애플리케이션처럼 짧은 트랜잭션이 많을 때는 pool_mode = transaction이 효과가 크다. 대신 SET, LI.. 2026. 10. 24. PostgreSQL 스키마 생성·조회·권한 부여 정리, 데이터베이스와 차이와 search_path까지 [오라클에서 넘어와 PostgreSQL 스키마와 사용자가 따로라서 처음에 권한 설정이 꼬였던 경험]PostgreSQL을 처음 쓰면 "데이터베이스와 스키마는 뭐가 다른지", "테이블을 만들었는데 왜 다른 사용자가 못 보는지"에서 막힌다. 특히 오라클에 익숙하면 더 헷갈린다. 오라클은 사용자가 곧 스키마인데, PostgreSQL은 사용자(롤)와 스키마가 따로이기 때문이다. 스키마 개념부터 생성, 조회, 권한 부여, 용량 확인까지 자주 쓰는 명령을 한곳에 정리했다.한 줄 요약데이터베이스 안에 스키마가 있고, 스키마 안에 테이블이 있다. 다른 사용자가 테이블을 보려면 스키마 USAGE 권한 + 테이블 SELECT 권한 둘 다 필요하다. 스키마 이름을 안 쓰면 search_path 순서대로 찾는다.기준: Post.. 2026. 10. 22. PostgreSQL EXPLAIN ANALYZE 읽는 법, 어디부터 봐야 할까 (actual time, loops, buffers) [운영 중 느린 쿼리를 EXPLAIN ANALYZE로 처음 열어 봤을 때 어디를 봐야 할지 막막했던 경험]쿼리가 느리면 누구나 EXPLAIN ANALYZE부터 돌린다. 그런데 결과가 수십 줄씩 나오면 어디를 봐야 할지 막막하다. 실행계획은 안쪽(들여쓰기 깊은 곳)부터 읽고, 다섯 군데만 확인하면 대부분의 원인이 보인다. PostgreSQL 공식 문서의 실제 실행 예시로 읽는 순서를 정리했다.한 줄 요약Execution Time으로 전체 시간 확인 → 2. 가장 오래 걸린 노드 찾기 (actual time × loops) → 3. 추정 rows와 실제 rows 비교 → 4. Rows Removed by Filter 확인 → 5. Buffers read 확인기준: PostgreSQL 16 이상 (예시 출력은.. 2026. 10. 21. PostgreSQL UPSERT, ON CONFLICT 사용법과 자주 나는 에러 2가지 [실무 경험 한 줄: 예) 배치에서 "있으면 수정, 없으면 입력"을 SELECT 후 분기로 짰다가 동시 실행 때 중복 에러가 났던 상황]"있으면 수정하고 없으면 입력한다." 오라클에서는 MERGE INTO로 하던 작업을 PostgreSQL에서는 보통 INSERT ... ON CONFLICT로 한다. 문법은 짧지만, 처음 쓰면 유니크 인덱스가 없다는 에러와 같은 행을 두 번 수정할 수 없다는 에러를 거의 반드시 만난다. 기본 사용법과 두 에러의 원인, 해결 방법을 정리했다.한 줄 요약ON CONFLICT (키) DO NOTHING은 중복이면 건너뛰고, DO UPDATE SET 컬럼 = EXCLUDED.컬럼은 중복이면 새 값으로 바꾼다. 충돌 기준 컬럼에는 반드시 유니크 인덱스나 제약이 있어야 한다.기준: .. 2026. 10. 20. 이전 1 2 다음