pgAdmin4

누가 사용하면 좋은가

PostgreSQL을 사용하는 개발자, 데이터베이스 관리자, SQL 학습자에게 적합하다. 객체 탐색과 SQL 실행을 함께 제공하므로 테이블 구조를 확인하면서 조회문을 작성하거나 역할과 권한을 점검하는 작업에 활용할 수 있다. 데이터베이스 서버 자체와는 별개인 관리 도구이므로 접속할 PostgreSQL 서버와 계정이 필요하다.

제품 전체는 Windows·macOS·Linux를 지원하며, 여기서는 macOS 배포판을 기준으로 설명한다. 개인 작업에는 데스크톱 모드, 중앙에 배포해 여러 사람이 접속하는 환경에는 웹 서버 모드를 검토할 수 있다.

macOS 설치와 첫 연결

2026-10-09에 확인한 공식 최신 배포는 2026-09-17 출시된 9.18이다. macOS 지원 표에는 Sonoma 14, Sequoia 15, Tahoe 26이 있으며 Intel과 Apple Silicon을 지원한다. 배포 디렉터리에는 x64와 arm64 DMG가 각각 있으므로 Mac의 칩에 맞춰 선택한다.

Finder에서 DMG를 열고 앱을 Applications 등 원하는 위치로 드래그한다. 실행 후 서버 연결을 등록하면서 식별용 이름, 호스트 주소, 포트, 초기 접속 데이터베이스, 사용자와 비밀번호를 입력한다. 기본 포트는 5432이며 실제 서버 설정에 맞춰야 한다. 연결한 데이터베이스에서 Query Tool을 열고 SELECT current_database(); 같은 조회로 접속 대상을 확인하는 순서가 좋다.

주요 기능과 실무 활용

객체 화면에서는 테이블·인덱스·제약 조건의 속성과 SQL 정의를 확인하고, Query Tool에서는 SQL 실행 결과와 오류 메시지를 검토한다. Schema Diff와 ERD Tool은 환경 간 구조 차이를 살피거나 관계를 문서화할 때 활용할 수 있다.

예를 들어 쇼핑몰의 월별 매출 보고서를 준비한다면 주문 테이블을 날짜와 상태 조건으로 집계한 뒤 결과를 CSV로 내보낼 수 있다. 조회가 느리면 EXPLAIN 화면에서 실행 계획을 확인하고 조건이나 인덱스 구성을 검토한다. 백업·복원 화면은 개발용 데이터베이스 복사에 활용할 수 있으며, 복원 후 필요한 테이블과 데이터가 있는지 별도로 확인한다.

무료 사용과 기능 제약

공식 배포 안내는 pgAdmin을 PostgreSQL 라이선스로 제공하는 무료 소프트웨어 프로젝트로 명시한다. 확인한 자료에는 무료판과 유료판을 나눠 기본 관리 기능을 잠그는 제품 구분이 없다. 실제 데이터베이스 작업 범위는 접속 계정의 권한에 따른다.

조회 결과를 표에서 바로 수정하는 기능에는 조건이 있다. 단일 테이블에서 직접 선택한 열이어야 하며 기본 키의 모든 열 또는 OID가 결과에 포함되어야 한다. 이름을 바꾼 열이나 계산 열 등은 읽기 전용일 수 있다. AI Assistant는 별도 AI 제공자 설정이 필요하므로 기본 설치만으로 사용할 수 있다고 보거나 외부 서비스까지 무료라고 판단해서는 안 된다.

문제가 생겼을 때 확인 순서

접속 실패는 오류 문구부터 구분한다. 연결 거부라면 서버 실행 여부와 호스트·포트, TCP/IP 수신 설정을 확인한다. 시간 초과라면 연결 정보와 네트워크 경로를 점검한다. no pg_hba.conf entry는 서버까지 도달했지만 접속 허용 규칙이 맞지 않는 경우이므로 서버 관리자에게 클라이언트 주소와 계정의 허용 여부를 확인한다. 비밀번호 인증 실패는 사용자 이름과 비밀번호부터 다시 확인한다.

결과 표가 수정되지 않으면 수정 가능한 조회 조건과 계정 권한을 살핀다. 자동 커밋을 끈 상태에서는 변경이 커밋되어야 확정되므로 트랜잭션 상태도 확인한다. SQL 오류의 세부 내용은 Messages 탭에서 확인할 수 있다.

다른 도구와 선택 기준 및 유지보수

선택 기준은 작업 방식이다. 객체 속성, 권한, 실행 계획, 백업을 화면에서 함께 다루려면 pgAdmin을 검토하고, 명령줄 중심 작업이 필요하면 PostgreSQL의 psql과 비교하는 것이 좋다. 여러 종류의 데이터베이스를 한 도구에서 관리하려는 경우에는 후보 도구의 지원 DB와 필요한 관리 기능을 따로 확인해야 한다.

pgAdmin 4는 현재 릴리스가 제공되는 제품이다. 9.18 릴리스 노트의 지원 서버는 PostgreSQL 및 EDB Advanced Server 14~18이다. 유지보수 검토 항목으로는 별도 작업 스케줄러 pgAgent의 사용 중단·지원 제거 예고가 있다. 신규 예약 작업을 설계할 때 이 의존성을 먼저 검토해야 한다.

공식 안내

• pgAdmin - PostgreSQL Tools · 확인 2026-10-09
• pgAdmin 4 (macOS) · 확인 2026-10-09
• PostgreSQL File Browser: pgadmin4/v9.18/macos · 확인 2026-10-09
• Download · 확인 2026-10-09
• Features · 확인 2026-10-09
• Server Dialog — pgAdmin 4 9.18 documentation · 확인 2026-10-09
• Query Tool — pgAdmin 4 9.18 documentation · 확인 2026-10-09
• Backup and Restore — pgAdmin 4 9.18 documentation · 확인 2026-10-09
• Connection Error — pgAdmin 4 9.18 documentation · 확인 2026-10-09
• Version 9.18 — pgAdmin 4 9.18 documentation · 확인 2026-10-09