[MySQL] SET NAMES 사용법: 클라이언트 문자셋과 콜레이션 완벽 제어하기

728x90

들어가며

MySQL 클라이언트와 서버 간 데이터 전송 시 문자 인코딩이 맞지 않으면 깨진 문자나 데이터 손실이 발생할 수 있습니다. 이를 방지하기 위해 클라이언트 연결 직후 정확한 문자셋을 설정하는 것이 중요합니다. SET NAMES는 클라이언트-서버 통신에 사용될 문자셋과 콜레이션을 명시적으로 지정하는 가장 널리 쓰이는 명령어입니다. 오늘은 이 명령어의 개념, 문법, 활용법을 상세히 살펴보겠습니다.

SET NAMES란 무엇인가?

SET NAMES는 MySQL 세션의 문자셋 관련 시스템 변수를 한 번에 설정하는 명령어입니다.

변경되는 시스템 변수

character_set_client
character_set_results
character_set_connection

이 세 변수가 동시에 지정한 문자셋으로 설정되어 클라이언트와 서버 간의 문자 인코딩 일관성을 확보합니다.

기본 문법과 사용 예제

기본 문법

SET NAMES 문자셋 [COLLATE 콜레이션];

문자셋: 사용할 문자 인코딩 이름 (예: utf8mb4)
콜레이션: 문자 정렬 및 비교 규칙 (선택 사항)

예제 1: 기본 문자셋 설정

SET NAMES utf8mb4;

예제 2: 문자셋과 콜레이션 동시 설정

SET NAMES utf8mb4 COLLATE utf8mb4_general_ci;

SET CHARACTER SET과의 차이점

구분SET NAMESSET CHARACTER SET

콜레이션 지정	지원함	지원 안 함 (디폴트 콜레이션 사용)
유연성	더 세밀한 설정 가능	간단하고 빠른 기본 설정
내부 동작	시스템 변수 직접 설정	내부적으로 SET NAMES 호출

Tip: 복잡한 다국어 처리나 정렬 규칙을 명확히 제어하려면 SET NAMES 사용을 권장합니다.

설정 상태 확인

현재 적용된 문자셋과 콜레이션 상태는 다음과 같이 확인할 수 있습니다:

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

사용 시 주의사항

클라이언트-서버 통신 초기 단계에서 가장 먼저 설정하는 것이 안전합니다.
애플리케이션 커넥션 풀링 사용 시, 세션 재사용에 따른 문자셋 상태 관리 필요
서버에서 지원하는 문자셋인지 확인하려면:

SHOW CHARACTER SET;

마무리 및 실전 팁

SET NAMES는 MySQL 국제화 지원의 핵심입니다. 통신 문자셋과 콜레이션을 명확히 맞춰두면 예상치 못한 데이터 손상 이슈를 예방할 수 있습니다.

실전 팁:

커넥션 풀 기반 환경에서는 커넥션 생성 시 초기화 스크립트에 반드시 SET NAMES 포함하세요.
다국어 서비스에서는 항상 utf8mb4 문자셋을 추천합니다.
콜레이션은 시스템 요구사항에 맞춰 utf8mb4_unicode_ci 등 더 적절한 값을 선택하세요.

공식 문서 링크

더 자세한 내용은 MySQL 공식 문서를 참고하세요:

SET NAMES 공식 문서