https://youtu.be/7dhbaMWaJ3Y?si=iU6KeGwaumOyTziW

스프링 부트 데이터베이스 2 - MySQL RDB 단일 연결

스프링 부트 데이터베이스 2 - MySQL RDB 단일 연결
- Spring Boot에서 MySQL RDB 단일 연결(Single Connection) 설정하기
1. Spring Boot에서 MySQL 연결 방식
2. 단일 연결(Single Connection)이란?
- 특징
3. 단일 연결의 장점
- 1) 설정이 매우 간단함
- 2) 개발 속도 빠름
- 3) 테스트 환경 구축 쉬움
4. 단일 연결 시 필요한 정보
5. MySQL 기본 포트
6. Spring Boot 프로젝트 생성
- Spring Initializr 설정
7. 필수 의존성 추가
- 1) Spring Data JPA
- 2) MySQL Driver
8. build.gradle 예시
9. application.properties 위치
10. MySQL 연결 핵심 설정
- 기본 설정 예시
11. 각 설정 의미 분석
- 1) URL
- 구조
- 예시
12. Username 설정
13. Password 설정
14. Driver 설정 추가
15. 전체 설정 예시
16. AWS RDS 연결 예시
17. 추가 URL 옵션
18. 왜 옵션을 추가할까?
- serverTimezone
- characterEncoding=UTF-8
19. Spring Boot 자동 연결 원리
20. 실행 후 성공 여부 확인
21. 연결 실패 시 대표 오류
- Access denied
- Communications link failure
- Unknown database
- Driver 오류
22. JPA DDL 자동 생성 설정
- 설정 예시
23. ddl-auto 옵션 종류
24. 실무 추천 설정
- 개발 환경
- 운영 환경
25. SQL 로그 출력 설정
- 결과
26. 네이밍 전략 설정
27. 기본 동작 차이
- 설정 적용 시
28. 실무에서 가장 중요한 포인트
29. 단일 연결 vs 다중 연결 차이
- 단일 연결
- 다중 연결
30. 추천 개발 흐름
31. 이번 글 핵심 정리
- 핵심 설정
- 필수 의존성
- 장점
마무리

Spring Boot에서 MySQL RDB 단일 연결(Single Connection) 설정하기

이번 글에서는 Spring Boot 프로젝트에서 MySQL 데이터베이스를 가장 간단하게 연결하는 방법인:

단일 연결(Single Connection)

설정을 정리한다.

Spring Boot는 기본적으로:

JDBC Driver
DataSource
JPA 연결

등을 자동 구성(Auto Configuration) 해주기 때문에 설정 파일만 작성해도 MySQL 연결이 가능하다.

1. Spring Boot에서 MySQL 연결 방식

Spring Boot에서 MySQL을 연결하는 방법은 크게 두 가지다.

방식	설명
단일 연결	하나의 DB만 연결
다중 연결	여러 DB 동시 연결

2. 단일 연결(Single Connection)이란?

단일 연결은:

Spring Boot 프로젝트에
하나의 MySQL 데이터베이스만 연결하는 방식

이다.

특징

Spring Boot가 내부적으로:

Driver 생성
DataSource 생성
Connection 설정

등을 자동 처리한다.

즉:

Configuration 클래스 직접 작성 불필요

하다.

3. 단일 연결의 장점

1) 설정이 매우 간단함

application.properties

설정만으로 연결 가능

2) 개발 속도 빠름

초기 프로젝트 구성에 매우 유리

3) 테스트 환경 구축 쉬움

로컬 개발 환경에서 자주 사용

4. 단일 연결 시 필요한 정보

MySQL 연결에는 아래 정보가 필요하다.

항목	설명
IP 주소	DB 서버 주소
Port	MySQL 포트
Database 이름	사용할 DB
Username	DB 계정
Password	비밀번호

5. MySQL 기본 포트

기본 MySQL 포트는:

이다.

6. Spring Boot 프로젝트 생성

Spring Initializr 설정

예시:

항목	값
Language	Java
Build Tool	Gradle
Spring Boot	3.x
Java	17 이상

7. 필수 의존성 추가

MySQL 연결에는 아래 두 개가 핵심이다.

1) Spring Data JPA

spring-boot-starter-data-jpa

ORM 사용

2) MySQL Driver

mysql-connector-j

DB 연결 Driver

8. build.gradle 예시

dependencies {

    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

    runtimeOnly 'com.mysql:mysql-connector-j'

}

9. application.properties 위치

경로:

src/main/resources/application.properties

10. MySQL 연결 핵심 설정

기본 설정 예시

spring.datasource.url=jdbc:mysql://localhost:3306/testdb

spring.datasource.username=root

spring.datasource.password=1234

11. 각 설정 의미 분석

1) URL

spring.datasource.url

DB 주소 설정

구조

jdbc:mysql://IP:PORT/DB이름

예시

spring.datasource.url=jdbc:mysql://localhost:3306/testdb

값	의미
localhost	DB 서버 주소
3306	MySQL 포트
testdb	데이터베이스 이름

12. Username 설정

spring.datasource.username=root

MySQL 접속 계정

13. Password 설정

spring.datasource.password=1234

DB 비밀번호

14. Driver 설정 추가

실무에서는 명시적으로 작성하기도 한다.

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

15. 전체 설정 예시

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.datasource.url=jdbc:mysql://localhost:3306/testdb

spring.datasource.username=root

spring.datasource.password=1234

16. AWS RDS 연결 예시

로컬 MySQL이 아니라 AWS RDS를 사용하는 경우:

spring.datasource.url=jdbc:mysql://rds주소:3306/testdb

형태 사용

17. 추가 URL 옵션

실무에서는 보통 아래 옵션도 추가한다.

spring.datasource.url=jdbc:mysql://localhost:3306/testdb?serverTimezone=Asia/Seoul&characterEncoding=UTF-8

18. 왜 옵션을 추가할까?

serverTimezone

시간대 문제 방지

characterEncoding=UTF-8

한글 깨짐 방지

19. Spring Boot 자동 연결 원리

Spring Boot는:

spring.datasource.*

설정을 읽으면 내부적으로:

HikariCP 생성
DataSource 생성
JDBC 연결

자동 수행

20. 실행 후 성공 여부 확인

정상 연결되면:

애플리케이션이 오류 없이 실행

된다.

21. 연결 실패 시 대표 오류

Access denied

아이디/비밀번호 오류

Communications link failure

IP 또는 포트 문제

Unknown database

DB 이름 없음

Driver 오류

mysql-connector-j 의존성 누락

22. JPA DDL 자동 생성 설정

Spring Boot는 Entity 기반으로 테이블 생성 가능하다.

설정 예시

spring.jpa.hibernate.ddl-auto=create

23. ddl-auto 옵션 종류

옵션	설명
create	실행 시 테이블 새 생성
update	변경된 부분만 반영
validate	검증만 수행
none	아무 작업 안함

24. 실무 추천 설정

개발 환경

spring.jpa.hibernate.ddl-auto=update

운영 환경

spring.jpa.hibernate.ddl-auto=none

실무에서는 운영 DB 자동 변경을 매우 조심한다.

25. SQL 로그 출력 설정

매우 유용한 옵션

spring.jpa.show-sql=true

결과

실행되는 SQL 확인 가능

26. 네이밍 전략 설정

Entity 변수명을 DB 컬럼명 그대로 사용 가능

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

27. 기본 동작 차이

설정 없으면:

userName
→ user_name

스네이크 케이스 변환

설정 적용 시

userName
→ userName

그대로 사용

28. 실무에서 가장 중요한 포인트