DB Server

VPC 환경에서 이용 가능합니다.

DB Server에서는 Cloud PostgreSQL Server를 생성, 삭제하거나 운영 중인 PostgreSQL Server 목록을 확인할 수 있습니다. 또한 운영 중인 PostgreSQL Server의 스펙을 변경하거나 관리자(User) 계정 등을 관리할 수 있습니다.

DB Server 화면

DB Server 이용을 위한 기본적인 설명은 다음과 같습니다.

PostgreSQL Server 목록 확인

생성하여 운영 중인 PostgreSQL Server 목록에서 각 서버별 정보를 확인할 수 있습니다. 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Database > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.

2. DB Server 메뉴를 클릭해 주십시오.

3. 생성한 PostgreSQL Server 목록이 나타나면 요약 정보를 확인하거나 PostgreSQL Server를 클릭하여 상세 정보를 확인해 주십시오.
   

   • DB Service 이름: PostgreSQL의 서비스 이름으로 PostgreSQL Server를 역할별로 구분한 그룹. 일반적으로 하나의 Primary Server, Secondary Server, 다수의 Read Replica Server로 구성되는 서버군을 말하며, 동일한 데이터를 갖고 있는 PostgreSQL 서버들을 하나의 Service로 지칭
     • : 클릭 시 Service 이름 변경
   • DB Role: PostgreSQL Server의 역할
   • DB Server 이름: PostgreSQL Server의 이름
   • DB Server 타입: PostgreSQL Server의 서버 유형, 가용 메모리
   • Monitoring: 모니터링 화면으로 이동
   • DB Status: DB Server 상세보기 화면으로 이동
   • DB 접속 포트: PostgreSQL Server가 사용 중인 포트 번호
   • Private 도메인: Private 도메인 정보
   • Public 도메인: 외부에서 접근할 수 있는 Public 도메인 정보
     • DB 관리 메뉴의 Public 도메인 관리 기능을 통해 설정하였을 경우에만 표시
   • 데이터 스토리지: 사용 중인 데이터 스토리지 크기(가용량)
   • 데이터 스토리지 타입: 사용 중인 데이터 스토리지 종류
   • 데이터 스토리지 용량: 사용 중인 데이터 스토리지 가용량과 사용량
   • Status/상태: PostgreSQL Server의 상태
     • 생성중: 사용자가 입력한 정보로 PostgreSQL Server를 생성하고 있는 상태
       
     • 설정중: 사용자가 입력한 정보로 PostgreSQL Server를 생성하여 구성하고 있는 상태
       
     • 운영중: 사용자가 입력한 정보로 PostgreSQL Server의 생성과 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태
       
     • 삭제중: 사용자가 입력한 정보로 생성한 PostgreSQL Server를 삭제하고 있는 상태
       
     • 정지중: 사용자가 입력한 정보로 생성한 PostgreSQL Server 구동을 중지하고 있는 상태
       
     • 재시작중: 사용자가 입력한 정보로 생성한 PostgreSQL Server를 다시 시작하고 있는 상태
       
     • 시작중: 사용자가 입력한 정보로 생성한 PostgreSQL Server를 시작하고 있는 상태
       
     • 업그레이드: 사용자가 선택한 스펙으로 PostgreSQL Server 스펙을 업그레이드하고 있는 상태
       
     • 다운그레이드: 사용자가 선택한 스펙으로 PostgreSQL Server스펙을 다운그레이드하고 있는 상태
       
   • 생성 일시: PostgreSQL Server를 생성한 날짜, 서버 상태가 생성중이 된 최초 시점
   • 구동 일시: PostgreSQL Server의 운영을 시작한 날짜, 서버 상태가 운영중이 된 최초 시점
   • ACG: PostgreSQL Server에서 사용 중인 ACG의 이름과 아이디
     • : 클릭 시 Server > ACG 화면으로 이동
     • [규칙 보기] 버튼: 클릭 시 적용된 상세 규칙 확인
   • Database Config: PostgreSQL Server에 적용된 Config
     • : 클릭 시 Database Config 화면으로 이동
   • DB 엔진 버전: Server에 설치된 PostgreSQL의 버전 정보
   • DB License: Server에 설치된 PostgreSQL 라이선스 정보
   • VPC: PostgreSQL Server가 사용 중인 VPC 이름
   • 서버 세대: PostgreSQL Server가 설치된 서버 세대 정보
   • Subnet: PostgreSQL Server가 사용 중인 Subnet 이름
   • 사설 IP: PostgreSQL Server가 설치된 사설 IP 정보
   • 고가용성: 고가용성 기능 사용 여부를 Y, N으로 표시
   • 백업 보관일(백업시간): 백업 기능을 사용 중인 경우 설정해놓은 백업 파일 보관 기간과 백업 수행 주기 정보
     • : 클릭 시 백업 기능 사용 여부 및 파일 보관 기간, 수행 주기 설정

PostgreSQL Server 생성

네이버 클라우드 플랫폼 콘솔에서 PostgreSQL Server를 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Database > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.

2. DB Server 메뉴를 클릭해 주십시오.

3. [DB Server 생성] 버튼을 클릭해 주십시오.
   

4. 서비스 신청 화면이 나타나면 다음 단계를 차례대로 진행해 주십시오.

   • 1. 서버 설정
   • 2. DB 설정
   • 3. 최종 확인

1. 서버 설정

설정값을 입력하여 PostgreSQL을 설치할 Server를 생성하는 방법은 다음과 같습니다.

1. 서버 설정 화면이 나타나면 DBMS 종류에서 서버에 설치할 DBMS의 종류를 확인해 주십시오.
   
2. 설치할 PostgreSQL 버전과 라이선스 정보를 확인해 주십시오.
   • DB 엔진 버전: 네이버 클라우드 플랫폼에서 생성 가능한 PostgreSQL 버전 정보
   • DB 라이센스: 네이버 클라우드 플랫폼에서 생성 가능한 PostgreSQL의 오픈소스 라이선스 정보
3. 생성할 서버의 가용성을 위한 추가 옵션을 설정해 주십시오.
   • 고가용성 지원: 장애 발생 시 자동 복구를 위한 Failover 기능 사용 여부 클릭하여 선택
     • 선택 시 Primary Server, Secondary Server 두 대의 PostgreSQL 서버로 이중화 구성
     • 선택 시 백업 파일 보관 기간과 백업 시간 설정(기본값: 1일, 자동)
     • 선택 시 백업 파일 보관 해제 불가
     • 선택 시 추가 요금 발생
     • Secondary Server는 사용자 별도 접근 불가능
4. PostgreSQL Server 생성을 위해 필요한 VPC, PostgreSQL Server 관련 항목을 설정해 주십시오.
   • VPC: 서버 및 PostgreSQL 생성에 사용할 VPC 선택
     • [새로고침] 버튼: 생성해놓은 VPC 목록을 최신 버전으로 확인하려는 경우 클릭
     • [VPC 생성] 버튼: 생성해놓은 VPC가 없어 신규로 생성하려는 경우 클릭
   • Subnet: VPC 접근 시 사용할 Private Subnet 선택
     • [새로고침] 버튼: 생성해놓은 Subnet 목록을 최신 버전으로 확인하려는 경우 클릭
     • [Subnet 생성] 버튼: 생성해놓은 Subnet이 없어 신규로 생성하려는 경우 클릭
   • DB Server 타입: 생성할 PostgreSQL Server 타입과 선택한 서버 타입에 따른 가용 메모리 선택
   • 데이터 스토리지 타입: DB 데이터 저장을 위한 스토리지 종류를 SSD, HDD 가운데 클릭하여 선택
     • PostgreSQL Server 생성 후 설정 변경 불가능
   • 데이터 스토리지 용량: DB 데이터 저장을 위한 스토리지 용량 확인
     • PostgreSQL Server 최초 생성 시 10GB 할당
     • 데이터 증가에 따라 10GB 단위로 용량 자동 갱신 및 과금
     • 최대 6000GB까지 지원
5. Cloud DB for PostgreSQL 이용 시 적용되는 요금제 정보를 확인해 주십시오.
   • 요금제: 사용한 시간에 따라 요금이 과금되는 시간 요금제가 기본 적용되며 서버 사양, 스토리지 용량에 따라 변경
   • 요금에 대한 자세한 정보는 요금 안내 클릭
6. PostgreSQL Server 생성을 위해 필요한 나머지 항목을 설정해 주십시오.
   • DB Server 이름: 생성될 PostgreSQL Server 이름을 입력
     • 영문 소문자, 숫자, 하이픈(-)을 사용하여 3~20자 사이로 입력
     • 첫 글자는 영문, 마지막 글자는 영문이나 숫자
     • 서버 구분을 위해 사용자가 입력한 이름 뒤에 임의의 텍스트 및 숫자 3자리가 자동 할당 <예시> mypostgresql-001-xxxx
     • 중복 사용 불가능
   • DB Service 이름: 생성될 PostgreSQL Server를 역할별로 구분한 Group 이름을 입력 <예시> mypostgresql-service
     • 국문, 영문, 숫자, 하이픈(-)을 사용하여 3~30자 사이로 입력
     • 중복 사용 불가능
   • ACG 설정: ACG(Access Control Group)는 자동 생성
     • ACG 세부 설정은 콘솔의 Server > ACG에서 가능
7. [다음] 버튼을 클릭해 주십시오.

2. DB 설정

설치할 PostgreSQL에 대한 정보를 설정하는 방법은 다음과 같습니다.

1. DB 설정 화면이 나타나면 PostgreSQL Server 생성을 위해 필요한 항목을 설정해 주십시오.
   

   • USER_ID: PostgreSQL Server 관리자 계정 아이디 입력
     • 영문 소문자, 숫자, "_" 특수문자를 사용하여 4~16자 사이로 입력
     • 첫 글자는 영문
     • 미리 정의된 예약어 사용 불가능
   • 접근 제어: PostgreSQL Server에 접근을 허용할 Client의 CIDR 입력
     • 전체 접속을 허용하는 경우 <예시> 0.0.0.0/0
     • 특정 IP 접속만 허용하는 경우 <예시> 123.123.123.123/32
     • 특정 IP 대역만 허용하는 경우 <예시> 123.123.123.0/24
   • USER 암호: PostgreSQL Server 관리자 계정 비밀번호 입력
     • 영문, 숫자, 특수문자를 각 1자 이상씩 포함하여 8~20자 사이로 입력
     • 특수문자 ` & + \ " ' > / 및 공백 사용 불가
   • DB 접속 포트: 생성될 PostgreSQL Server에 접근을 허용할 TCP 포트 번호를 5432 또는 10000~20000 사이로 입력
     • 기본값: 5432
     • 한 번 지정한 포트 번호는 변경 불가능
   • 기본 DB 명: 기본으로 생성할 DB 이름 입력
     • 영문 소문자, 숫자, "_" 특수문자를 사용하여 1~30자 사이로 입력
     • 첫 글자는 영문
   • DB Config 설정: 네이버에서 제공하는 최적화된 기본 설정 확인
     • 상세보기 > DB Config에서 내용 확인 및 변경 가능
   • DB log 수집: error 로그, slow query 로그 수집 및 뷰어 기능 제공 확인
     • Cloud Log Analytics 연동

2. 생성할 서버의 백업 사용 여부를 설정해 주십시오.

   • BACKUP 설정: 백업 여부와 백업 파일 보관, 백업 시간 설정
     • PostgreSQL Server의 Backup 설정을 사용합니다.: 백업 사용 시 클릭하여 선택
     • Backup 파일 보관 기간: 별도의 백업 스토리지에 백업 파일을 보관할 기간을 클릭하여 선택
       • 시점 복구를 위해 Backup file은 최대 설정된 보관 기간 + 24시간 보관됩니다
     • Backup 시간: 백업이 수행되는 시간을 자동, 사용자 정의 가운데 선택
     • 선택 시 사용한 공간 크기만큼 추가 요금 발생
       • 자동: 하루마다 자동으로 백업 시작
       • 사용자 정의: 하루마다 사용자가 설정한 시간+15분 사이에 백업 시작

3. [다음] 버튼을 클릭해 주십시오.

4. Cloud Log Analytics 이용 신청이 나타나면 내용 확인 후 [확인] 버튼을 클릭해 주십시오.

   • Cloud Log Analytics 이용 신청이 필요한 경우 [Cloud Log Analytics 이용 신청] 버튼 클릭
   • Cloud Log Analytics에 대한 자세한 설명은 Cloud Log Analytics 사용 가이드 참고

3. 최종 확인

1. 최종 확인 화면이 나타나면 설정한 서버 정보, DB 정보, Backup 정보를 확인해 주십시오.
   

   • 설정을 수정하려면 [이전] 버튼 클릭

2. [생성] 버튼을 클릭해 주십시오.

3. DB Server 화면의 PostgreSQL 목록에서 생성한 PostgreSQL 상태를 확인해 주십시오.

   • 생성중: 사용자가 입력한 정보로 PostgreSQL 서버를 생성하고 있는 상태
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 생성하여 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 생성과 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

PostgreSQL Server 재시작

PostgreSQL Server를 쉽고 간편하게 다시 시작할 수 있습니다. 다시 시작 중인 서버에는 접속할 수 없습니다. 다시 시작하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Database > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.
2. DB Server 메뉴를 클릭해 주십시오.
3. 다시 시작할 PostgreSQL Server를 클릭한 다음 [DB Server 재시작] 버튼을 클릭해 주십시오.
4. DB Server 재시작 팝업 창이 나타나면 다시 시작할 DB Server의 이름을 확인한 다음 [확인] 버튼을 클릭해 주십시오.
5. DB Server 화면의 PostgreSQL Server 목록에서 PostgreSQL Server 상태를 확인해 주십시오.
   • 정지중: PostgreSQL Server 구동을 중지하고 있는 상태
   • 재시작중: PostgreSQL Server를 다시 시작하고 있는 상태

PostgreSQL Server 삭제

생성하여 운영 중인 PostgreSQL Server를 삭제할 수 있습니다. 고가용성을 사용 중인 경우 Primary Server와 Secondary Server가 함께 삭제됩니다. 백업 기능을 사용 중인 경우 백업 파일도 함께 삭제됩니다. 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Database > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.
2. DB Server 메뉴를 클릭해 주십시오.
3. 삭제할 PostgreSQL Server를 클릭한 다음 [DB Server 삭제] 버튼을 클릭해 주십시오.
4. DB Server 삭제 팝업 창이 나타나면 삭제할 DB Server의 이름을 입력한 다음 [확인] 버튼을 클릭해 주십시오.
5. DB Server 화면의 PostgreSQL Server 목록에서 PostgreSQL Server 상태를 확인해 주십시오.
   • 삭제중: PostgreSQL Server를 삭제하고 있는 상태

PostgreSQL Server 모니터링

네이버 클라우드 플랫폼의 Cloud DB for PostgreSQL에서는 사용자가 직관적으로 운영 중인 서버와 데이터 상태를 확인하고 효과적으로 관리할 수 있도록 서버별로 대시보드를 통한 모니터링 서비스를 제공하고 있습니다.

생성하여 운영 중인 PostgreSQL Server의 모니터링 화면으로 이동하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Database > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.
2. DB Server 메뉴를 클릭해 주십시오.
3. 모니터링할 PostgreSQL Server를 클릭한 다음 [Monitoring] 버튼을 클릭해 주십시오.
4. 모니터링할 대시보드를 클릭하여 선택해 주십시오.
   

PostgreSQL Server 관리

생성한 PostgreSQL Server를 운영하다 보면 생성 당시 설정했던 서버나 DB 관련 옵션을 변경해야 하는 상황이 발생할 수 있습니다. Cloud DB for PostgreSQL에서는 이미 생성한 PostgreSQL Server일지라도 간편하게 몇 번의 클릭으로 몇 가지 스펙을 변경하거나 업그레이드할 수 있도록 지원하고 있습니다.

생성하여 운영 중인 PostgreSQL Server를 관리하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Platform 메뉴에서 VPC를 선택하여 클릭해 주십시오.

2. Services > Database > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.

3. DB Server 메뉴를 클릭해 주십시오.

4. 관리할 PostgreSQL Server를 클릭한 다음 [관리] 버튼을 클릭해 주십시오.

5. 필요한 관리를 클릭하여 선택해 주십시오.
   

   • DB Service 상세보기
   • DB Server 상세보기
   • Read Replica 추가
   • 고가용성 설정 변경
   • DB Server 스펙 변경
   • DB Config 관리
   • Public 도메인 관리
   • DB User 관리
   • DB User 권한 관리
   • DB Server Log 설정 변경
   • DB Failover
   • Version Upgrade

DB Service 상세보기

선택한 PostgreSQL Service의 Database, Config, User, Backup 관련 상세 정보를 확인하거나 수정할 수 있습니다. 구체적인 내용은 다음과 같습니다.

상세 정보를 확인하고 수정하는 방법은 다음과 같습니다.

1. DB Service 상세보기 화면이 나타나면 Database 관리 탭 메뉴를 클릭해 주십시오.
2. 데이터베이스 정보를 확인하고 데이터베이스를 추가하거나 수정, 삭제해 주십시오.
   
   • 추가: Database Name에 추가할 데이터베이스 이름을 입력하고 Owner에서 데이터베이스를 관리할 User를 선택한 후 [Database 추가] 버튼 클릭
   • 삭제: 삭제할 데이터베이스의 설정 필드에 있는 [삭제] 버튼 클릭
3. [저장] 버튼을 클릭해 주십시오.
4. DB Config 관리 탭 메뉴를 클릭해 주십시오.
5. DB Config 정보를 확인하고 Config를 추가, 수정, 삭제해 주십시오.
   
   • 추가, 수정, 삭제 방법: DB Config 관리 참조
6. [저장] 버튼을 클릭해 주십시오.
7. DB User 관리 탭 메뉴를 클릭해 주십시오.
8. DB User 정보를 확인하고 User를 추가, 수정, 삭제해 주십시오.
   
   • 추가, 수정, 삭제 방법: DB User 관리 참조
9. [저장] 버튼을 클릭해 주십시오.
10. DB User 권한 관리 탭 메뉴를 클릭해 주십시오.
11. DB User 권한 정보를 확인하고 권한을 추가, 삭제해 주십시오.
    
    • 추가, 삭제 방법 : DB User 권한 관리 참조
12. [저장] 버튼을 클릭해 주십시오.
13. Backup 설정 관리 탭 메뉴를 클릭해 주십시오.
14. Backup 설정 정보를 확인하고 필요한 항목을 설정해 주십시오.
    
    • Backup 파일 보관 기간: 백업 기능 사용 시 백업 파일의 최대 보관 기간
    • Backup 시간: 백업 기능 사용 시 백업 수행 시간
15. [저장] 버튼을 클릭해 주십시오.
16. Extension 관리 탭 메뉴를 클릭해 주십시오.
17. Extension 정보를 확인하고 Extension을 추가, 설정, 삭제해 주십시오.
    
    • 추가, 수정, 삭제 방법: Extension 관리 참고
18. [저장] 버튼을 클릭해 주십시오.
19. Public Schema 관리 탭 메뉴을 클릭해 주십시오.
20. Database의 Public Schema 권한을 부여하거나 회수할 수 있습니다.
    
21. [저장] 버튼을 클릭해 주십시오.

DB Server 상세보기

선택한 PostgreSQL Server가 정상적으로 운영되는지 서버 관련 상세 정보를 확인할 수 있습니다. 구체적인 내용은 다음과 같습니다.

확인하는 방법은 다음과 같습니다.

1. DB Server 상세보기 화면이 나타나면 pg_stat_activity 탭 메뉴를 클릭해 주십시오.
2. 선택한 PostgreSQL Server에서 현재 사용 중인 세션 프로세스의 통계 정보를 확인하고 필요한 명령을 실행해 주십시오.
   • 세션 강제 중지: terminate 클릭
   • SQL 수행 중지: cancel 클릭
   • 추출한 SQL 표시: sql 클릭
3. pg_settings 탭 메뉴를 클릭해 주십시오.
4. 선택한 PostgreSQL Server의 런타임 매개변수 정보를 확인해 주십시오.
   
5. pg_stat* 탭 메뉴를 클릭해 주십시오.
6. 선택한 PostgreSQL Server 관련 통계 정보를 확인해 주십시오.
   
7. DB Server Logs 탭 메뉴를 클릭해 주십시오.
8. 선택한 PostgreSQL Server의 로그 파일 정보 확인하고 필요한 명령을 실행해 주십시오.
   
   • 로그 파일을 Storage에 저장: [Object Storage로 보내기] 버튼 클릭하여 저장할 버킷 선택한 후 [Object Storage로 보내기] 버튼 클릭
     • Object Storage 이용 신청을 하지 않은 경우: [Object Storage 상품 바로가기] 버튼 클릭하여 이용 신청 및 버킷 1개 이상 생성
   • 로그 파일 삭제: [Log 삭제] 버튼 클릭

Read Replica 추가

선택한 PostgreSQL Server(Primary)의 읽기 전용 복제본 서버(Read Replica)를 생성할 수 있습니다. 한 대의 서버마다 Zone별 최대 5대까지의 Read Replica DB를 생성할 수 있습니다. 네이버 클라우드 플랫폼의 Load Balancer를 사용하여 Read Replica DB 서버들을 읽기 전용 복제본으로 사용함으로써 데이터베이스의 읽기 부하를 분산하도록 설정도 가능합니다. 자세한 설정 방법은 읽기 부하 분산 설정을 참고해 주십시오.

Read Replica PostgreSQL Server는 Primary PostgreSQL Server와 다음과 같은 설정값이 동일하게 생성됩니다.

• DB Server 타입
• 데이터 스토리지 타입
• 데이터 스토리지 용량
• DB Config 설정값

Read Replica PostgreSQL Server 역시 Primary PostgreSQL Server와 동일한 요금이 청구되며, 사용한 시간으로 과금합니다. Read Replica PostgreSQL Server를 추가하는 방법은 다음과 같습니다.

1. Read Replica 팝업 창이 나타나면 Primary DB Server와 Read Replica DB Server 정보를 확인해 주십시오.
   
2. [예] 버튼을 클릭해 주십시오.
3. DB Server 화면의 PostgreSQL 목록에서 생성한 Read Replica PostgreSQL Server 상태를 확인해 주십시오.
   • 생성중: 사용자가 입력한 정보로 Read Replica PostgreSQL Server를 생성하고 있는 상태
   • 설정중: 사용자가 입력한 정보로 Read Replica PostgreSQL Server를 생성하여 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 Read Replica PostgreSQL Server의 생성과 설정이 완료되어 애플리케이션 서버에서 Read Replica PostgreSQL에 접속 가능한 상태

읽기 부하 분산 설정

네이버 클라우드 플랫폼의 Load Balancer를 사용하여 Read Replica DB 서버들을 읽기 전용 복제본으로 사용함으로써 데이터베이스의 읽기 부하를 분산하도록 설정할 수 있습니다. 우선 로드 밸런서를 생성한 후 생성한 로드 밸런서가 정상적으로 접근할 수 있도록 PostgreSQL Server의 ACG에 설정을 추가하는 순서로 진행합니다. 설정하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Networking > Load Balancer 메뉴를 차례대로 클릭해 주십시오.
2. [Load Balancer 생성] 버튼을 클릭해 주십시오.
3. 로드밸런서와 리스너 생성에 필요한 정보를 입력해 주십시오.
4. [로드밸런서 생성] 버튼을 클릭해 주십시오.
5. 네이버 클라우드 플랫폼 콘솔에서 Services > Storage > Cloud DB for PostgreSQL 메뉴를 차례대로 클릭해 주십시오.
6. DB Server 메뉴를 클릭해 주십시오.
7. 설정할 서버의 상세 정보 화면에서 ACG의 버튼을 클릭해 주십시오.
8. [ACG 설정] 버튼을 클릭해 주십시오.
9. 로드 밸런서가 접속할 수 있도록 설정을 추가해 주십시오.
   • 프로토콜: TCP
   • 접근 소스: 로드 밸런서 서브넷의 IP 주소 대역
   • 허용 포트: DB 서버 포트
10. [적용] 버튼을 클릭해 주십시오.
11. 네이버 클라우드 플랫폼 콘솔에서 Services > Networking > Load Balancer 메뉴에서 생성 결과를 확인해 주십시오.
    • 접속 정보: 로드 밸런서 접속을 위한 IP를 확인하고 읽기 분산을 위한 접근 시 사용
    • 적용 서버: 적용 서버의 연결 상태가 성공으로 표시되는지 확인

고가용성 설정 변경

선택한 PostgreSQL Server를 Standalone이나 고가용성 구성으로 변경할 수 있습니다. 변경하는 방법은 다음과 같습니다.

1. 고가용성 설정 변경 팝업 창이 나타나면 서버 기본 정보를 확인해 주십시오.
   
2. 기존 고가용성 설정이 Y인 경우 Standalone으로, 기존 고가용성 설정이 N인 경우 고가용성으로 설정이 가능합니다.
3. [확인] 버튼을 클릭해 주십시오.
4. DB Server 화면의 PostgreSQL 목록에서 PostgreSQL Server 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL Server를 생성하여 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL Server의 생성과 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

DB Server 스펙 변경

생성한 PostgreSQL Server의 서버 스펙을 변경할 수 있습니다. 스펙 업그레이드 시 추가 요금이 발생합니다.

스펙을 변경하는 방법은 다음과 같습니다.

1. 스펙변경 팝업 창이 나타나면 현재 서버 사양을 확인해 주십시오.
2. 변경할 서버 사양을 클릭하여 선택해 주십시오.
   
3. [예] 버튼을 클릭해 주십시오.
4. DB Server 화면의 PostgreSQL 목록에서 스펙을 변경한 PostgreSQL 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

DB Config 관리

생성한 PostgreSQL Server의 다양한 설정을 변경할 수 있습니다. 변경 시 전체 서비스에 적용되며, 일부 Config는 변경 시 서버가 자동으로 다시 시작한 후 적용됩니다. 변경하는 방법은 다음과 같습니다.

1. Database Config 팝업 창이 나타나면 편집을 위해 필요한 정보를 확인하거나 입력해 주십시오.
   
   • Config Name: 설정 변수 이름
   • Config Value: 변수값
   참고

   Config 변수에 대한 자세한 설명은 PostgreSQL 공식 문서를 참고해 주십시오.

2. [추가] 버튼을 클릭해 주십시오.
   • 추가한 설정 변수 수정 시: [수정] 버튼 클릭
   • 추가한 설정 변수 삭제 시(기본값으로 설정 시): [삭제] 버튼 클릭
3. [저장] 버튼을 클릭해 주십시오.
4. DB Server 화면의 PostgreSQL 목록에서 Config를 변경한 PostgreSQL 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

Public 도메인 관리

Public 도메인을 신청하여 네이버 클라우드 외부에서 PostgreSQL Server로 접근이 가능하도록 설정하거나 설정한 Public 도메인을 해제할 수 있습니다. Public 도메인을 설정한 경우 외부와 통신하는 데이터는 네트워크 사용량으로 과금됩니다. 신청 및 해제하는 방법은 다음과 같습니다.

1. Public 도메인 신청 팝업 창이 나타나면 Public 도메인을 신청할 DB Server의 이름을 확인해 주십시오.
   
2. [예] 버튼을 클릭해 주십시오.

DB User 관리

PostgreSQL Server를 생성할 때 서버를 사용할 계정의 아이디와 비밀번호를 기본으로 생성합니다. 하지만 서버를 운영하다보면 사용자를 추가해야 하거나, 기존 사용자 계정 비밀번호를 재설정해야 하는 상황이 발생할 수 있습니다. 또는 사용자 계정을 삭제해야 할 수도 있습니다. Cloud DB for PostgreSQL에서는 서버를 사용하는 사용자 계정의 추가, 수정, 삭제를 간편하게 할 수 있는 User 관리 기능을 제공합니다. User 관리 기능으로 사용자 계정을 변경한 결과는 전체 서비스에 적용됩니다. 사용자 계정은 최대 1000개까지 추가할 수 있습니다.

사용자 계정을 추가, 삭제하거나 기존 관리자 계정의 비밀번호를 변경하는 방법은 다음과 같습니다.

1. DB User 관리 팝업 창이 나타나면 사용자 계정에 필요한 작업을 진행해 주십시오.
   
   • 사용자 계정 추가: USER_ID, 접근 제어, 암호에 정보를 입력하고 Replication Role를 클릭하여 선택한 후 [DB User 추가] 버튼 클릭
   • 사용자 계정 삭제: 삭제할 사용자 계정 행에서 [삭제] 버튼 클릭
   • 사용자 계정 비밀번호 수정: 수정할 사용자 계정 행에서 [수정] 버튼 클릭하여 수정 후 [저장] 버튼 클릭
2. [확인] 버튼을 클릭해 주십시오.
3. DB Server 화면의 PostgreSQL 목록에서 User를 설정한 PostgreSQL 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

DB User 권한 관리

PostgreSQL은 권한의 집합을 미리 정의하고 필요한 사용자에게 지정된 권한을 부여할 수 있습니다. Cloud DB for PostgreSQL 은 안정적인 시스템을 위해서 슈퍼 유저 권한을 내부적으로 보호하고 있습니다. 슈퍼 유저 권한을 사용자에게 직접 부여하지 않지만 슈퍼 유저만 부여 및 회수할 수 있는 predefined roles에 대한 일부 권한을 제어할 수 있습니다. 또한 슈퍼 유저만 조회할 수 있는 일부 뷰에 대한 select 권한도 부여 및 회수할 수 있습니다. 하지만 최소 권한 원칙을 준수하고 꼭 필요한 최소한의 권한만 부여하는 것이 바람직합니다.

사용자 계정에 권한을 추가하거나 삭제하는 방법은 다음과 같습니다.

1. DB 관리 > DB Service 상세보기 > DB User 권한 관리 탭으로 이동해 주십시오.
2. USER_ID 를 확인하고 Privileges에 부여, 회수할 권한을 선택해 주십시오.
3. [저장] 버튼을 클릭해 주십시오.
   

DB Server Log 설정 변경

생성한 PostgreSQL Server의 로그 보관 설정을 변경할 수 있습니다. 변경 시 전체 서비스에 적용됩니다. 변경하는 방법은 다음과 같습니다.

1. DB Server Log 설정 변경 팝업 창이 나타나면 설정 변경에 필요한 작업을 진행해 주십시오.
   
   • Log: 서버 로그 이름 확인
   • Log Rotation Age: 로그 보관 주기(시간)를 클릭하여 선택(기본값: 24 hours)
   • Log Rotation Size: 로그 보관 주기(용량)를 클릭하여 선택(기본값: 10MB)
   • Log Archive Count: 로그 보관 주기(개수)를 클릭하여 선택(기본값: 100개)
2. [저장] 버튼을 클릭해 주십시오.
3. DB Server 화면의 PostgreSQL 목록에서 Server Log를 설정한 PostgreSQL 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

DB Failover

Primary PostgreSQL Server에 장애가 발생한 경우 사용자가 직접 Failover 기능을 사용하여 Primary와 Secondary를 전환할 수 있습니다. 전환 시 일정 시간(분)이 소요되며 전환되는 동안 서버 접속은 되지 않습니다. 전환하는 방법은 다음과 같습니다.

1. DB Failover 팝업 창이 나타나면 안내 정보를 확인해 주십시오.
   
2. [예] 버튼을 클릭해 주십시오.
3. DB Server 화면의 PostgreSQL 목록에서 DB Failover를 설정한 PostgreSQL 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태
   • Config Name: 설정 변수 이름
   • Config Value: 변수값
   참고

   Config 변수에 대한 자세한 설명은 PostgreSQL 공식 문서를 참고해 주십시오.

4. [추가] 버튼을 클릭해 주십시오.
   • 추가한 설정 변수 수정 시: [수정] 버튼 클릭
   • 추가한 설정 변수 삭제 시(기본값으로 설정 시): [삭제] 버튼 클릭
5. [저장] 버튼을 클릭해 주십시오.
6. DB Server 화면의 PostgreSQL 목록에서 Config를 변경한 PostgreSQL 상태를 확인해 주십시오.
   • 설정중: 사용자가 입력한 정보로 PostgreSQL 서버를 구성하고 있는 상태
   • 운영중: 사용자가 입력한 정보로 PostgreSQL 서버의 설정이 완료되어 애플리케이션 서버에서 PostgreSQL에 접속 가능한 상태

Version Upgrade

PostgreSQL Engine의 마이너 버전을 업그레이드할 수 있습니다. 버전 업그레이드는 DB Service 전체에 적용되며, Read Replicas -> Secondary -> DB Failover -> Prior Primary 순으로 한 대씩 업그레이드가 진행됩니다. 업그레이드를 수행하는 동안 서버 접속은 되지 않습니다.

1. DB 관리 > Version Upgrade 를 클릭해 주십시오.
2. 업그레이드할 버전을 선택하고 [확인] 버튼을 클릭해 주십시오.

스키마 관리

PostgreSQL은 Database를 생성하면 public라는 이름의 default schema가 제공되며 모든 유저 (PUBLIC) 에게 접근 권한이 부여됩니다.
하지만 public schema를 사용하는 것은 보안상 취약점이 될 수 있어 별도로 목적에 맞는 schema를 생성하는 것을 권고하고 있습니다.
또한 많은 고객분들과 인증 심사 기관의 요청으로 신규 생성되는 database 에서는 아래와 같이 접근 권한이 제거되었습니다.

revoke all on schema public from public;

따라서 Database 의 owner 계정으로 접속 후 아래와 같이 별도의 schema 를 생성하길 권고드립니다.

create schema [스키마명];

DB Server 접속 방법

Private Domain 을 이용하는 방법

Cloud DB for PostgreSQL에서는 Private Domain을 제공하고 있으며 Private Domain 이름은 DB Server의 IP로 연결됩니다.
Standalone 구성일 경우, 하나의 DB Server의 IP로 연결됩니다.
HA 구성일 경우, Primary DB Server와 Secondary DB Server가 각각 다른 Private Domain을 가지고 있지만 두 Private Domain은 모두 Primary DB Server의 IP로 연결됩니다. 둘 중 어느 Private Domain을 사용해도 Primary DB Server로 연결됩니다. Failover가 발생하면 새롭게 승격된 Primary DB Server로 자동으로 연결 정보가 변경되므로 손쉽게 접속정보를 관리할 수 있습니다.

접속 정보의 예제는 다음과 같습니다. (JDBC를 이용한 경우)

jdbc:postgresql://<Private Domain 이름>:<포트>/<DB명>

사설 IP 를 이용하는 방법

Cloud DB for PostgreSQL에서는 사설 IP를 통한 DB Server 연결을 지원합니다. 사설 IP는 Failover가 발생해도 변하지 않는 DB Server의 IP입니다. 사설 IP의 개념을 알고 접속 정보를 사용하는 경우에 유용하며, Secondary DB Server에 접속해서 Read Only DB로 활용할 때 유용합니다.
다만 Secondary DB Server에 큰 부하를 준다면 HA 구성에 영향을 주어 Failover에 실패할 수 있습니다. 이런 경우는 Secondary DB를 사용하는 대신, Read Replica DB를 추가하고 Load Balancer를 이용하여 읽기 분산을 하길 권고드립니다.

접속 정보의 예제는 다음과 같습니다. (JDBC를 이용한 경우)

- Primary DB Server에 접속하는 경우
jdbc:postgresql://<Primary 사설 IP>:<포트>,<Secondary 사설 IP>:<포트>/<DB명>?targetServerType=primary

- Secondary DB Server에 접속하는 경우
jdbc:postgresql://<Primary 사설 IP>:<포트>,<Secondary 사설 IP>:<포트>/<DB명>?targetServerType=secondary