MariaDB Dump 파일 Import 에러 해결기

MariaDB Dump 파일 Import 에러 해결기

"NOTE_VERBOSITY" 에러와의 싸움

최근에 MariaDB 덤프 파일을 내 로컬 환경에 import하려고 했는데, 예상치 못한 에러를 만났다. 평소엔 잘 되던 작업이었기에 당황스러웠다. 아래는 import 중 발생한 에러 메시지다:

WARNING: option --ssl-verify-server-cert is disabled, because of an insecure passwordless login.
--------------
/*M!100616 SET @OLD_NOTE_VERBOSITY=@@NOTE_VERBOSITY, NOTE_VERBOSITY=0 */
--------------
ERROR 1193 (HY000) at line 17: Unknown system variable 'NOTE_VERBOSITY'

이 메시지를 보면 알 수 있듯, NOTE_VERBOSITY라는 시스템 변수를 인식하지 못하고 import가 중단된다.

왜 이런 에러가 났을까?

처음엔 내 컴퓨터의 MariaDB 설정 문제일까 싶었지만, 알고 보니 덤프를 export할 때 사용한 MySQL 서버 버전과 내 로컬 컴퓨터의 MySQL 버전 차이에서 비롯된 문제였다.

• 서버에서 사용한 MySQL/MariaDB 버전: 10
• 내 로컬 환경의 MySQL/MariaDB 버전: 11

즉, MariaDB 10.5에서만 존재하는 시스템 변수인 NOTE_VERBOSITY가, 11버전에서는 더 이상 존재하지 않거나 이름이 변경되었거나 지원되지 않는 것이다.

해결 방법은?

1. 덤프 파일 수정

에러가 발생하는 라인을 직접 주석 처리하거나 삭제해준다. (NOTE_VERBOSITY 관련 구문)

예: -- 또는 #로 주석 처리

-- SET @OLD_NOTE_VERBOSITY=@@NOTE_VERBOSITY, NOTE_VERBOSITY=0

혹은 해당 줄 자체를 삭제해도 무방하다.

2. 같은 버전에서 export & import

가장 확실한 방법은 동일한 버전의 MySQL/MariaDB에서 export하고 import하는 것이다. 버전 차이로 인한 변수/구문 차이가 줄어들기 때문이다.

---

나와 같은 문제를 겪는 분들이 있을까 봐 기록으로 남긴다. 작은 버전 차이라도 의외로 import 시 큰 영향을 줄 수 있다는 점, 꼭 기억하자.