운영 서버에 SSH로 접속해서 DB 쿼리를 실행해야 합니다. GUI 도구는 로컬에서만 쓸 수 있고, CLI 도구는 명령어가 생소합니다. 반대로 개발할 때는 테이블 구조를 눈으로 보면서 쿼리를 짜는 게 훨씬 편합니다. 상황별로 어떤 도구를 쓰는지 알면 매번 검색하는 시간이 줄어듭니다.

확대

주요 도구 비교

GUI 도구는 스키마 탐색, ERD 확인, 대화형 쿼리 작성에 강합니다. CLI 도구는 서버 SSH 환경, 스크립트 자동화, 빠른 점검 루틴에 강합니다. 실무에서는 평소에는 GUI를 쓰고, 프로덕션 서버 긴급 대응 시에는 CLI를 씁니다.

DBeaver — 최고의 무료 선택

DBeaver는 가장 많이 사용되는 무료 데이터베이스 GUI 클라이언트입니다. Java 기반으로 Windows, macOS, Linux 모두 동일한 경험을 제공하며 ERD 자동 생성, 데이터 내보내기/가져오기, SQL 편집기 자동완성을 지원합니다. 단점은 Java 기반이라 무겁고 시작이 느리며, macOS에서 네이티브 앱 대비 UI가 다소 어색하다는 점입니다.

TablePlus — macOS 최적화

네이티브 macOS 앱으로 빠른 시작과 반응성, 깔끔한 UI, 탭 방식의 다중 연결 관리를 제공합니다. macOS를 주력으로 사용하고 빠른 UI를 원할 때 선택합니다.

DataGrip — 개발자 최강 도구

JetBrains에서 만든 유료 DB 전용 IDE입니다. 가장 강력한 SQL 자동완성과 리팩터링, JetBrains IDE와의 완벽 통합, 스키마 비교와 데이터 마이그레이션을 지원합니다. IntelliJ 계열 IDE를 사용하며 DB 작업이 많을 때 선택합니다. 학생과 오픈소스 프로젝트는 무료입니다.

연결 문자열(Connection String) 이해

어떤 도구를 사용하든 DB 연결에는 동일한 정보가 필요합니다. 연결 문자열은 호스트, 포트, 데이터베이스 이름, 사용자명, 비밀번호, 선택적 파라미터(SSL 모드, 타임아웃 등)를 하나의 URL로 표현합니다.

postgresql://username:password@host:port/dbname
postgresql://postgres:secret123@localhost:5432/shop_db
postgresql://postgres:secret123@localhost:5432/shop_db?sslmode=require&connect_timeout=10

비밀번호는 절대 코드에 직접 쓰지 않습니다. .env 파일이나 환경변수로 관리하고 .gitignore에 반드시 추가해야 합니다.

운영 서버에 접속해서 PostgreSQL을 확인해야 합니다. GUI 도구를 설치할 수 없는 환경입니다. psql만 있는데, \l, \dt, \d tablename이 무엇을 뜻하는지 모릅니다. psql 메타 명령어를 익혀두면 어떤 서버에서도 DB 상태를 즉시 확인할 수 있습니다.

확대

psql 시작하기

psql은 PostgreSQL 공식 CLI 클라이언트입니다. GUI 도구가 없는 서버 환경이나 스크립트 자동화에 필수적입니다. 환경변수(PGHOST, PGPORT, PGUSER, PGDATABASE)를 미리 설정해두면 매번 플래그를 입력하지 않아도 됩니다.

psql -h localhost -p 5432 -U postgres -d mydb
psql "postgresql://postgres:password@localhost:5432/mydb"

실행 완료 또는 조회 결과가 표시됩니다.

필수 메타 커맨드 (백슬래시 명령어)

psql의 메타 커맨드는 \로 시작하며 SQL이 아닌 psql 자체 명령입니다. 세미콜론 없이 Enter만 치면 바로 실행됩니다.

\l              데이터베이스 목록 전체
\c mydb         mydb로 연결 전환
\dt             현재 DB의 테이블 목록
\dt public.*    public 스키마 전체 테이블
\d tablename    테이블 컬럼 구조와 인덱스 상세 보기
\di             인덱스 목록
\dv             뷰 목록
\df             함수 목록
\du             사용자(Role) 목록
\dn             스키마 목록
\timing         쿼리 실행 시간 측정 ON/OFF
\e              외부 에디터(vim/nano)에서 쿼리 편집
\i filename.sql SQL 파일 실행
\o output.txt   결과를 파일로 저장
\q              psql 종료
\?              전체 메타 커맨드 도움말
\h SELECT       SELECT 문법 도움말

\d tablename은 컬럼 타입, NOT NULL 여부, 기본값, 인덱스 정보를 한 번에 보여줍니다. 테이블 구조를 빠르게 확인할 때 가장 많이 쓰는 명령입니다.

COPY 명령으로 대용량 데이터 처리

\COPY는 클라이언트 파일시스템을 사용하므로 로컬 파일 작업에 항상 \COPY를 사용합니다. COPY(백슬래시 없음)는 DB 서버 파일시스템 경로를 사용해 로컬 환경에서 동작하지 않을 수 있습니다.

\COPY orders TO '/tmp/orders_backup.csv' WITH CSV HEADER;

\COPY products FROM '/tmp/products.csv' WITH CSV HEADER;

\COPY (SELECT id, email, created_at FROM users WHERE active = true)
TO '/tmp/active_users.csv' WITH CSV HEADER;

.psqlrc — psql 환경 설정

홈 디렉토리의 .psqlrc 파일로 psql 기본 설정을 커스터마이징할 수 있습니다. 아래 설정을 적용하면 psql을 열 때마다 실행 시간 측정이 켜지고 NULL 값이 [NULL]로 시각적으로 표시됩니다.

\set PROMPT1 '%[%033[1;32m%]%n@%/%[%033[0m%]# '
\timing on
\pset null '[NULL]'
\pset pager always

pgcli와 mycli — 자동완성 강화 CLI

표준 psql/mysql보다 편리한 대안 도구입니다. 테이블명, 컬럼명, SQL 키워드 자동완성, 문법 컬러 강조, Ctrl+R 히스토리 검색을 지원합니다. 서버에 GUI를 설치할 수 없는 환경에서 DB 작업이 잦다면 pgcli를 강력 추천합니다.

pip install pgcli
pgcli postgresql://postgres:password@localhost/mydb

pip install mycli
mycli -u root -h localhost mydb

앞에서 psql의 Ctrl+C가 트랜잭션을 롤백하는 함정을 봤습니다. 도구가 만드는 더 은밀한 사고는 반대쪽에 있습니다 — 트랜잭션을 열어 둔 채 방치하는 것입니다. DBeaver 같은 GUI는 기본이 수동 커밋인 경우가 많아, 조회 한 번에도 트랜잭션이 열리고 결과창을 닫기 전까지 닫히지 않습니다.

• 오래된 트랜잭션은 스냅샷을 붙잡습니다: PostgreSQL은 MVCC로 각 트랜잭션에 특정 시점의 스냅샷을 줍니다. 트랜잭션이 살아 있는 한 그 시점 이후의 죽은 행(dead tuple)을 아무도 못 지웁니다 — 그 트랜잭션이 아직 옛 버전을 볼 권리가 있기 때문입니다. 이 하한선을 xmin horizon이라 부릅니다.
• 그래서 VACUUM이 헛돌게 됩니다: 점심 먹으러 가며 열어 둔 idle in transaction 세션 하나가 몇 시간을 버티면, 그동안 DB 전체에서 삭제·수정으로 생긴 dead tuple을 VACUUM이 회수하지 못합니다. 테이블과 인덱스가 부풀고(bloat) 같은 쿼리가 점점 느려집니다. 원인은 도구 창 하나인데 증상은 DB 전체 성능 저하로 나타납니다.
• 잠금까지 물고 있을 수 있습니다: 그 트랜잭션이 UPDATE를 한 상태였다면 행 잠금을, 스키마를 건드렸다면 더 강한 잠금을 계속 쥡니다. 마침 그때 배포된 마이그레이션(ALTER)이 뒤에서 대기하며 연쇄 지연을 만들 수 있습니다.
• 안전장치는 자동 커밋과 타임아웃입니다: 운영 DB를 만지는 도구는 읽기 조회에 트랜잭션을 굳이 열지 않도록 autocommit을 켭니다. 서버에는 idle_in_transaction_session_timeout을 걸어, 일정 시간 방치된 트랜잭션을 DB가 스스로 끊게 합니다. 편한 GUI일수록 이 설정이 없으면 위험합니다.

핵심은, 도구가 편하다고 트랜잭션 경계까지 대신 관리해 주지는 않는다는 점입니다. 조회만 했는데 왜 DB가 느려지지의 범인은 종종 내가 열어 둔 결과창입니다(트랜잭션 격리 수준(Isolation Level)과 이상 현상 제어).