오픈 소스의 힘을 활용하는 방법 ― Ubuntu의 세계에 오신 것을 환영합니다

초보자를 위한! Ubuntu에 PostgreSQL 설치 방법 및 기본 설정

개발 환경 구축
目次

1. 도입

PostgreSQL은 안정성과 성능이 뛰어난 관계형 데이터베이스이며, Ubuntu 환경에서도 많은 애플리케이션과 시스템에서되고 있습니다. 이 기사에서는 Ubuntu에 PostgreSQL을 설치 기본 설정을 수행하는 절차를 이해하기 쉽게 설명합니다. 초보자도 이해할 수 있도록 단계별로 설명하고, 설치 후 확인 및 연결 오류에 대한 대 포함하여 안심하고 환경을 구축할 수 있는 내용입니다.

2. 전제 조건 및 준비

먼저, Ubuntu 버전이 20.04 또는 22.04인지 확인합시다. PostgreSQL을 설치하기 전에 최신 패키지 정보를 가져오고 패키지 목록을 업데이트해 둡니다.
sudo apt update
이렇게 하면 이후 설치 단계가 원활하게 진행됩니다.

3. PostgreSQL 설치 절차

3.1 PostgreSQL 저장소 추가

Ubuntu 기본 저장소에 최신 PostgreSQL이 포함되지 않을 수 있으므로 공식 저장소를 추가합니다. 이를 통해 최신 버전을 설치할 수 있습니다.
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc

3.2 PostgreSQL 설치

저장소를 추가한 후, 아래 명령으로 PostgreSQL과 추가 도구를 설치합니다.
sudo apt update
sudo apt install postgresql postgresql-contrib

3.3 설치 확인

설치 후, 다음 명령으로 PostgreSQL 버전을 확인하고 정상적으로 설치되었는지 확인합니다.
postgres --version

4. 초기 설정

4.1 PostgreSQL 사용자 설정

PostgreSQL을 설치할 때 “postgres”라는 시스템 사용자가 생성됩니다. 아래 명령으로 “postgres” 사용자로 전환하여 데이터베이스 작업을 수행합니다.
sudo -i -u postgres

4.2 로컬 연결 설정 편집

“pg_hba.conf” 파일을 편집하여 인증 방식을 설정합니다. 기본적으로 로컬 연결만 허용되며, 원격 연결을 활성화하려면 아래 파일의 설정을 변경합니다.
sudo nano /etc/postgresql/14/main/pg_hba.conf
예를 들어, 아래와 같이 “md5” 인증을 지정하여 보안을 강화하는 설정이 가능합니다.
local   all             postgres                                md5
host    all             all             127.0.0.1/32            md5
설정을 변경한 후에는 PostgreSQL 서비스를 재시작하여 적용합니다.
sudo systemctl restart postgresql

5. 간단한 동작 확인

5.1 PostgreSQL의 시작 및 중지

PostgreSQL은 설치 시 자동으로 시작되지만, 아래 명령어로 수동으로 시작·중지할 수도 있습니다. 서비스 상태도 확인할 수 있습니다.
sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl stop postgresql

5.2 데이터베이스 확인

「psql」 명령을 사용하여 PostgreSQL에 연결하고, 데이터베이스 목록을 확인합니다.
sudo -u postgres psql
명령 프롬프트에서 「l」을 입력하면 현재 데이터베이스가 목록으로 표시됩니다.

6. pgAdmin 설치와 설정（옵션）

PostgreSQL 관리에는 pgAdmin이라는 GUI 도구도 편리합니다. 아래 명령으로 설치하고, 브라우저에서 쉽게 조작할 수 있습니다.
sudo apt install pgadmin4
설치 후, 브라우저에서 “http://localhost/pgadmin”에 접속하면 PostgreSQL 관리 작업이 가능합니다.

7. 트러블슈팅 및 흔히 발생하는 오류 대처법

7.1 설치 오류와 리포지토리 오류

설치 중에 “의존성 오류”나 “리포지토리 오류”가 발생하는 경우, 리포지토리 URL이 올바른지 확인하고, 다시 패키지 목록을 업데이트하십시오.
sudo apt update

7.2 연결 오류 대처법

PostgreSQL에 연결할 때 “비밀번호 인증에 실패했습니다”와 같은 오류가 발생하는 경우, “pg_hba.conf” 설정과 비밀번호가 올바른지 확인하고, 서비스 재시작을 시도해 보세요.
sudo systemctl restart postgresql

7.3 네트워크 오류 해결 방법

원격 연결에 문제가 발생하는 경우, postgresql.conf 파일에서 “listen_addresses” 설정이 “localhost”로 되어 있을 가능성이 있습니다. 원격 연결을 활성화하려면 아래와 같이 변경합니다.
sudo nano /etc/postgresql/14/main/postgresql.conf
아래와 같이 설정하여 원격 연결을 허용합니다.
listen_addresses = '*'
설정 후, 서비스를 재시작하여 반영합니다.
sudo systemctl restart postgresql

8. 요약

이 기사에서는 Ubuntu 환경에 PostgreSQL을 설치하고, 초기 설정 및 동작 확인을 수행하는 절차에 대해 설명했습니다. pgAdmin 사용 및 원격 연결 설정, 자주 발생하는 오류에 대한 대처 방법도 포함했으므로 처음 사용하는 분도 원활하게 설정을 진행할 수 있을 것입니다.
MySQL & MariaDBの世界
MySQL vs PostgreSQLの違いを徹底解説｜性能、拡張性、ユースケースで選ぶ最適なデータベース

目次 1 1. はじめに2 2. MySQLとPostgreSQLの基本的な違い2.1 MySQLの概要2.2 Post…