PostgreSQL 연동 가이드

effic tip : 담당자님이 마케터/기획자라면 DB를 관리하는 개발자에게 이 문서와 함께 DB연결에 필요한 정보를 요청하세요.

1. 에픽 DB 연동 페이지 위치

• [설정] > [DB 연동] 탭에서 DB 연동을 관리할 수 있습니다.

📁DB 연동

2. 연동에 필요한 정보

DB 연동에 필요한 정보는 아래와 같으며, readonly 권한인 정보를 사용하는 것을 권장드립니다.

항목	설명
Host	PostgreSQL 서버의 주소 (IP 주소 또는 도메인 이름).
Port	PostgreSQL이 사용하는 통신 포트 (기본값: 5432).
Database	연결하려는 데이터베이스 이름.
Username	Read-Only 권한을 가진 사용자 이름.
Password	해당 사용자의 비밀번호.

3. DB에서 정보 확인하는 방법

pgAdmin을 이용한 확인

• pgAdmin 실행:

  • PostgreSQL 클라이언트 도구인 pgAdmin을 실행합니다.

• 서버 등록 또는 선택:

  • 이미 등록된 서버가 있다면 해당 서버를 클릭합니다.

  • 새로운 서버를 등록하려면 Create → Server를 클릭하여 서버 정보를 입력합니다.

• Host와 Port 확인:

  • 서버 이름을 우클릭 → Properties 선택합니다.

  • General 탭에서 Host 정보 확인 (예: localhost 또는 192.168.0.1).

  • Connection 탭에서 Port 정보 확인 (기본값: 5432).

• Database와 Username 확인:

  • 왼쪽 패널에서 해당 서버를 클릭 → Databases 선택.

  • 사용할 데이터베이스를 선택하여 이름 확인 (예: my_database).

  • Login/Group Roles에서 Read-Only 사용자 확인 (예: readonly_user).

• Password:

  • 비밀번호는 사용자 생성 시 설정한 값이며, 관리자(DBA)로부터 확인해야 합니다.

SQL 명령어로 확인

1. PostgreSQL에 접속:

   • PostgreSQL 서버에 접속합니다.

   bash코드 복사psql -U admin_user -d postgres

2. 사용자 및 데이터베이스 목록 조회:

   • Database 확인:

     \l

     결과에서 연결하려는 데이터베이스 이름을 찾습니다.

   • Read-Only 사용자 확인:

     \du

     Read-Only 권한을 가진 사용자 이름이 출력됩니다.

   • 접속 호스트와 포트 확인: PostgreSQL의 설정 파일에서 listen_addresses와 port를 확인합니다.

클라우드 환경(AWS RDS 또는 GCP Cloud SQL)

• AWS RDS:

  • AWS Management Console → RDS Dashboard → Databases 선택합니다.

  • Instance Details에서 다음 정보를 확인합니다.

    • Endpoint: Host (예: my-db-instance.xxxxxxx.region.rds.amazonaws.com).

    • Port: 기본값은 5432.

    • Database: 데이터베이스 생성 시 설정한 이름.

• GCP Cloud SQL:

  • Google Cloud Console → SQL → Instance 선택합니다.

  • Instance Details에서 다음 정보 확인합니다.

    • Public IP Address: Host.

    • Database: 데이터베이스 이름.