postgresql18.3 로컬 주소DB 구축 (4) - PostGIS 확장기능 설치

PostGIS 이미지 교체

Docker를 이용하여 PostGIS를 설치하는 것은 PostGIS 기능만 추가로 설치하는 것이 아니고 기존 컨테이너를 PostGIS 이미지로 교체(Rolling Update) 하는 것을 말합니다.

 

1. 데이터 백업: 만약을 대비해 pg_dump로 전체 데이터를 백업합니다.
2. 이미지 교체: docker-compose.yml의 image 태그를 postgis/postgis로 변경합니다.
3. 재기동: docker-compose up -d를 실행하여 새 컨테이너를 띄웁니다.

PostGIS 이미지는 내부적으로 일반 PostgreSQL 엔진을 그대로 품고 있기 때문에, 기존 데이터 폴더(pgdata)를 그대로 연결하면 데이터 유실 없이 공간 함수 기능만 새로 쓸 수 있게 됩니다.

---

작업 순서

1. 기존 컨테이너 정지 및 제거

docker compose down

2. docker-compose.yml 수정

image: postgres:18.3 → image: postgis/postgis:18-3.6으로 변경 후 저장합니다.

3. 새 컨테이너 실행

docker compose up -d

4. PostGIS 활성화

DBeaver와 같은 DB운영툴에 접속한 후, 아래 SQL을 실행하여 공간 함수 기능 생성합니다.

CREATE EXTENSION IF NOT EXISTS postgis;

---

확인

파일을 수정하고 docker-compose up -d를 실행하여 성공적으로 교체되면 쿼리로 결과를 확인하실 수 있습니다.

SELECT PostGIS_Full_Version();