<div id="readability-page-1" class="page"><article id="post-11425">
				

							<div>
												
<h2>의존성 및 설정 변경</h2>
<p>가장 먼저 <code>build.gradle</code> 또는 <code>pom.xml</code>에서 데이터베이스 드라이버를 교체해야 합니다.</p>
<ul>
<li>
<p><strong>Dependency 교체</strong>:</p>
</li>
<li>
<p><code>mysql-connector-java</code> (혹은 <code>mysql-connector-j</code>)를 삭제하고 <code>org.postgresql:postgresql</code>을 추가합니다.</p>
</li>
<li>
<p><strong>application.yml (또는 properties)</strong>:</p>
</li>
<li>
<p><code>spring.datasource.url</code>: <code>jdbc:mysql://...</code>에서 <code>jdbc:postgresql://...</code>로 변경합니다.</p>
</li>
<li>
<p><code>spring.jpa.database-platform</code>: 명시적으로 Dialect를 설정했다면 <code>org.hibernate.dialect.MySQLDialect</code>에서 <code>org.hibernate.dialect.PostgreSQLDialect</code>로 변경합니다. (최신 Hibernate 버전은 자동 감지하므로 생략해도 무방합니다.)</p>
</li>
</ul>
<h2>주요 기술적 차이점</h2>
<p>두 데이터베이스는 아키텍처와 사양에 있어 차이가 있으며, 특히 JPA 엔티티를 작성하거나 SQL 쿼리를 짤 때 체감됩니다.</p>
<table>
<thead>
<tr>
<th>구분</th>
<th>MySQL</th>
<th>PostgreSQL</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>대소문자 구분</strong></td>
<td>설정에 따라 다르지만 기본적으로 <strong>구분 안 함</strong></td>
<td>식별자(테이블, 컬럼명)가 <strong>대소문자를 구분함</strong></td>
</tr>
<tr>
<td><strong>자동 증가 키</strong></td>
<td><code>AUTO_INCREMENT</code> 사용</td>
<td><code>SERIAL</code> 또는 <code>IDENTITY</code> 컬럼 사용</td>
</tr>
<tr>
<td><strong>불리언(Boolean)</strong></td>
<td><code>TINYINT(1)</code>로 저장 (0/1)</td>
<td><strong>Native <code>BOOLEAN</code> 타입</strong> 지원 (true/false)</td>
</tr>
<tr>
<td><strong>JSON 데이터</strong></td>
<td>JSON 컬럼 지원</td>
<td><strong>JSONB 타입</strong> 지원 (인덱싱 및 검색 성능 탁월)</td>
</tr>
<tr>
<td><strong>표준 준수</strong></td>
<td>관대함 (비표준 문법 허용)</td>
<td>SQL 표준을 엄격하게 준수</td>
</tr>
</tbody>
</table>
<hr>
<h2>개발 시 주의해야 할 점 (함정 카드)</h2>
<h3>대소문자 문제 (Case Sensitivity)</h3>
<p>PostgreSQL은 테이블명이나 컬럼명을 쌍따옴표(<code>"</code>)로 감싸지 않으면 기본적으로 <strong>소문자로 처리</strong>합니다.</p>
<ul>
<li>만약 JPA에서 <code>@Column(name = "UserName")</code>처럼 대문자를 섞어 명시했다면, PostgreSQL은 이를 <code>username</code>으로 인식하여 "컬럼을 찾을 수 없다"는 에러를 뱉을 수 있습니다. 가능한 모든 식별자를 소문자(<code>user_name</code>)로 통일하는 것이 정신 건강에 좋습니다.</li>
</ul>
<h3>데이터 타입 매핑</h3>
<ul>
<li><strong>Boolean</strong>: MySQL은 <code>TINYINT(1)</code>을 쓰지만, Postgres는 진짜 <code>boolean</code> 타입을 씁니다. 기존 데이터가 0/1로 들어가 있다면 마이그레이션 시 주의해야 합니다.</li>
<li><strong>JSON</strong>: Postgres의 <code>JSONB</code>는 매우 강력합니다. 단순히 텍스트로 저장하지 말고, JPA에서 <code>@JdbcTypeCode(SqlTypes.JSON)</code> (Hibernate 6 기준)을 사용하여 엔티티 필드에 매핑하면 편리하게 객체로 다룰 수 있습니다.</li>
</ul>
<h3>시퀀스(Sequence) 생성 전략</h3>
<p>MySQL에서는 주로 <code>GenerationType.IDENTITY</code>를 사용하여 데이터베이스의 자동 증가 설정을 따릅니다. PostgreSQL에서도 동일하게 동작하지만, <code>GenerationType.SEQUENCE</code>를 사용하는 것이 Postgres의 기본 철학에 더 가깝고, 대량 데이터를 삽입할 때 성능상 이점이 있을 수 있습니다.</p>
<hr>
<h2>요약: 무엇을 먼저 확인해야 할까?</h2>
<ol>
<li><strong>기존 SQL 쿼리</strong>: Native Query(직접 짠 쿼리)가 있다면 MySQL 전용 문법(예: <code>IFNULL</code>, <code>TINYINT</code> 관련 처리)이 포함되어 있는지 확인하고 수정하세요.</li>
<li><strong>데이터 마이그레이션</strong>: 만약 기존 MySQL 데이터를 옮겨야 한다면, 단순히 데이터만 옮기는 것이 아니라 데이터 타입 변환(Type Casting) 이슈를 꼭 검토해야 합니다.</li>
<li><strong>대소문자 컨벤션</strong>: 식별자 이름을 소문자_스네이크_케이스로 통일하는지 확인하세요.</li>
</ol>
<p><span></span> <span>Post Views:</span> <span>12</span>
			</p>											</div>
		
	
	</article></div>

상구리의 기술 블로그

Spring Boot – MySQL 에서 PostgreSQL 로 전환
의존성 및 설정 변경
가장 먼저 build.gradle 또는 pom.xml에서 데이터베이스 드라이버를 교체해야 합니다.
Dependency 교체:
mysql-connector-java (혹은 mysql-connector-j)를 삭제하고 org.postgresql:postgresql을 추가합니다.
application.yml (또는 properties):
spring.datasource.url: jdbc:mysql://...에서 jdbc:postgresql://...로 변경합니다.
spring.jpa.database-platform: 명시적으로 Dialect를 설정했다면 org.hibernate.dialect.MySQLDialect에서 org.hibernate.dialect.PostgreSQLDialect로 변경합니다. (최신 Hibernate 버전은 자동 감지하므로 생략해도 무방합니다.)
주요 기술적 차이점
두 데이터베이스는 아키텍처와 사양에 있어 차이가 있으며, 특히 JPA 엔티티를 작성하거나 SQL 쿼리를 짤 때 체감됩니다.
구분
MySQL
PostgreSQL
대소문자 구분
설정에 따라 다르지만 기본적으로 구분 안 함
식별자(테이블, 컬럼명)가 대소문자를 구분함
자동 증가 키
AUTO_INCREMENT 사용
SERIAL 또는 IDENTITY 컬럼 사용
불리언(Boolean)
TINYINT(1)로 저장 (0/1)
Native BOOLEAN 타입 지원 (true/false)
JSON 데이터
JSON 컬럼 지원
JSONB 타입 지원 (인덱싱 및 검색 성능 탁월)
표준 준수
관대함 (비표준 문법 허용)
SQL 표준을 엄격하게 준수
개발 시 주의해야 할 점 (함정 카드)
대소문자 문제 (Case Sensitivity)
PostgreSQL은 테이블명이나 컬럼명을 쌍따옴표(")로 감싸지 않으면 기본적으로 소문자로 처리합니다.
만약 JPA에서 @Column(name = "UserName")처럼 대문자를 섞어 명시했다면, PostgreSQL은 이를 username으로 인식하여 "컬럼을 찾을 수 없다"는 에러를 뱉을 수 있습니다. 가능한 모든 식별자를 소문자(user_name)로 통일하는 것이 정신 건강에 좋습니다.
데이터 타입 매핑
Boolean: MySQL은 TINYINT(1)을 쓰지만, Postgres는 진짜 boolean 타입을 씁니다. 기존 데이터가 0/1로 들어가 있다면 마이그레이션 시 주의해야 합니다.
JSON: Postgres의 JSONB는 매우 강력합니다. 단순히 텍스트로 저장하지 말고, JPA에서 @JdbcTypeCode(SqlTypes.JSON) (Hibernate 6 기준)을 사용하여 엔티티 필드에 매핑하면 편리하게 객체로 다룰 수 있습니다.
시퀀스(Sequence) 생성 전략
MySQL에서는 주로 GenerationType.IDENTITY를 사용하여 데이터베이스의 자동 증가 설정을 따릅니다. PostgreSQL에서도 동일하게 동작하지만, GenerationType.SEQUENCE를 사용하는 것이 Postgres의 기본 철학에 더 가깝고, 대량 데이터를 삽입할 때 성능상 이점이 있을 수 있습니다.
요약: 무엇을 먼저 확인해야 할까?
기존 SQL 쿼리: Native Query(직접 짠 쿼리)가 있다면 MySQL 전용 문법(예: IFNULL, TINYINT 관련 처리)이 포함되어 있는지 확인하고 수정하세요.
데이터 마이그레이션: 만약 기존 MySQL 데이터를 옮겨야 한다면, 단순히 데이터만 옮기는 것이 아니라 데이터 타입 변환(Type Casting) 이슈를 꼭 검토해야 합니다.
대소문자 컨벤션: 식별자 이름을 소문자_스네이크_케이스로 통일하는지 확인하세요.

Spring Boot – MySQL 에서 PostgreSQL 로 전환

댓글