MariaDB에서 테이블을 UTF8MB4로 변경하는 방법 > 메모

기본변경방법

ALTER TABLE 테이블명 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

단계별 상세 방법

SHOW TABLE STATUS WHERE Name = '테이블명';
-- 또는
SHOW CREATE TABLE 테이블명;

-- 권장: 모든 텍스트 컬럼을 utf8mb4로 변환
ALTER TABLE 테이블명 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 또는 테이블 기본값만 변경 (기존 컬럼은 유지)
ALTER TABLE 테이블명 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

ALTER TABLE 테이블명 
MODIFY 컬럼명 VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

데이터베이스 전체 변경

-- 데이터베이스 기본값 변경
ALTER DATABASE 데이터베이스명 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Collation 옵션

• utf8mb4_unicode_ci - 권장, 정확한 유니코드 정렬
• utf8mb4_general_ci - 빠르지만 덜 정확
• utf8mb4_bin - 바이너리 비교 (대소문자 구분)

주의사항

• 인덱스 길이: utf8mb4는 문자당 최대 4바이트를 사용하므로 VARCHAR(255)에 인덱스가 있으면 문제가 될 수 있습니다
• 백업 필수: 변경 전 반드시 데이터 백업
• 연결 설정: 애플리케이션의 DB 연결 설정도 utf8mb4로 변경 필요

그누보드에서 config.php 에서 설정 변경

// Set Database table default Charset
// utf8, utf8mb4 등 지정 가능 기본값은 utf8, 설치전에 utf8mb4 으로 수정 시 모든 테이블에 이모지 입력이 가능합니다.
// utf8mb4 인코딩은 MySQL 또는 MariaDB 5.5 버전 이상을 요구합니다.
define('G5_DB_CHARSET', 'utf8mb4');