AWS RDS 에서 mysql 한글 및 이모지 처리 (utf8, utf8mb4)

1 minute read

mysql 에서 utf8 은 3바이트로 실제 UTF-8 유니코드에서 4바이트를 쓰는것과 달리, 표현할 수 있는 캐릭터제한이 있었다. 한글 표시는 utf8 만 써도 되지만 이모지등은 utf8mb4 를 사용해야 표현이 가능하다.

java.sql.SQLException: Incorrect string value: '\xEA\xB9\x80\xEC\x9C\xA4...' for column 'name' at row 1

utf8 조차도 안되어 있을때 한글을 db 에 넣으려거나, utf8 만 되어있느데 이모지를 디비에 넣으려면 위와 비슷한 오류가 당신을 막아설 것이다.

자 그러니 DB를 utf8mb4 로 시원하게 세팅해 보는 법을 AWS RDS 에서 해보도록 합시다.

추가적으로 기본 timezone 도 한국시각에 맞게 바꿔봅니다

주의 : 이미 연결된 커넥션을 모두 꺼버리자. 서버의 파라미터를 수정하고 재부팅했는데, 기존연결된 커넥션에서 파라미터를 계속 조회하면 제대로 변경이 안되어있을 때가 있다.

RDS parameter group setting

RDS - 데이터베이스 - 구성 에 가면 위처럼 파라미터그룹을 볼 수 있습니다. default 로 되어있다면, 새로 하나 생성한 뒤, 그 파라미터 그룹을 사용할 DB 에 적용하면 됩니다.
파라미터 그룹 선택 후 편집에서 char 로 치면 character set 에 대한 설정들이 나옵니다. collation 이라고 치면 collation 설정(정렬을 위한) 이 나옵니다.
- 여기서 해당 값들을 utf8mb4 와 utf8mb4_unicode_ci 로 맞춰줍니다.
  - utf8mb4_general_ci 로 맞춰줘도 상관없습니다 (한글,영어,일본어 등에선 문제 없음. 불어 등에서 정렬이 좀 다릅니다)
- 단, character_set_filesystem = binary 값 그대로 둬야 합니다.
- skip-character-set-client-handshake 는 1 로 해줘서 클라이언트에서 접속할 때 주는 값을 막아버립니다.
```
  -- 단, 아래처럼 useUnicode=true  는 클라이언트 접속시 꼭 넣어주셔야 합니다 어머님.
  jdbc:mysql://yourRdsEndpoint.[rds.amazonaws.com:3306/foodin_master?useUnicode=true&serverTimezone=Asia/Seoul](http://rds.amazonaws.com:3306/foodin_master?userUnicode=true&serverTimezone=Asia/Seoul)
  -- mySql5.7 부터는 serverTimezone 값도 꼭 넣어야 합니다. 파라미터 그룹에서 time_zone 검색해서 동일하게 Asia/Seoul 로 세팅해두면 now() 등 사용시 현재 한국 시각으로 표시 됩니다.
```