Practical MySQL & MariaDB

mysqldump를 이용한 MySQL 데이터베이스 내보내기·가져오기 (백업·복원 가이드)

백업 및 복구
目次

MySQL 데이터베이스 관리에서 mysqldump를 이용한 내보내기 및 가져오기

1. 소개

MySQL 데이터베이스는 웹 애플리케이션 및 데이터베이스 관리 시스템에서 널리 사용됩니다. 데이터베이스를 적절히 관리하고 정기적인 백업을 수행하는 것은 예기치 않은 장애나 데이터 손실에 대비하기 위해 매우 중요합니다. 특히 mysqldump 명령은 MySQL 데이터베이스를 내보내고 나중에 복원을 위해 다시 가져오는 데 사용되는 주요 도구 중 하나입니다.

이 문서에서는 MySQL 데이터베이스를 백업(내보내기)하는 방법과 백업 파일을 사용해 데이터베이스에 데이터를 복원(가져오기)하는 방법을 자세히 설명합니다. 데이터베이스 관리자와 엔지니어를 위해 mysqldump를 활용한 효율적인 백업 및 가져오기 방법, 흔히 발생하는 오류 및 성능 최적화 기법을 다룹니다.

2. mysqldump 명령의 기본

mysqldump는 MySQL 데이터베이스를 백업하기 위한 강력한 커맨드라인 도구입니다. 이 도구를 사용하면 데이터베이스의 테이블 정의와 데이터를 텍스트 파일로 내보낼 수 있습니다. 아래에서는 기본 사용법과 자주 쓰이는 옵션을 설명합니다.

2.1 mysqldump 기본 사용법

기본 명령은 다음과 같이 실행합니다.

mysqldump -u [username] -p [database_name] > [output_file_name]

이 명령을 실행하면 지정한 데이터베이스에 있는 모든 테이블과 그 구조가 지정된 파일로 내보내집니다.

예시:

mysqldump -u root -p mydatabase > backup.sql

-u 옵션으로 MySQL 사용자명을 지정하고 -p 옵션으로 비밀번호를 입력합니다. mydatabase는 백업할 데이터베이스 이름이며, backup.sql은 내보낼 파일 이름입니다.

2.2 주요 옵션 설명

  • –single-transaction : 내보내기 중 테이블 잠금을 방지하기 위해 트랜잭션을 사용합니다. 이를 통해 백업 수행 중에도 데이터베이스를 계속 사용할 수 있습니다. InnoDB 테이블의 경우 데이터 일관성이 유지됩니다.
  • –skip-lock-tables : 데이터베이스 테이블 잠금을 방지합니다. 일반적으로 내보내기 중에 테이블이 잠겨 다른 사용자가 데이터베이스에 접근하지 못하게 되지만, 이 옵션을 사용하면 동시에 작업이 가능합니다.
  • –no-data : 실제 데이터 없이 테이블 정의만 내보냅니다. 테이블 구조만 백업하고 싶을 때 유용합니다.

2.3 내보낸 파일 구조

mysqldump 명령을 실행하면 출력 파일에 다음 형식의 SQL 문이 포함됩니다.

DROP TABLE IF EXISTS `table_name`;
CREATE TABLE `table_name` (
  `id` int(11) NOT NULL,
  `name` varchar(100) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

INSERT INTO `table_name` (`id`, `name`) VALUES (1, 'John'), (2, 'Doe');

이 파일은 데이터베이스 복원 시 사용되며, 기존 테이블을 먼저 삭제하고 다시 생성한 뒤 데이터를 삽입하는 SQL 스크립트를 포함합니다.

3. mysqldump를 이용한 가져오기

다음으로 내보낸 데이터를 데이터베이스에 가져오는 방법을 설명합니다. 가져오기는 주로 mysql 명령을 사용합니다.

3.1 기본 가져오기 명령

가져오기를 수행하려면 다음 명령을 사용합니다.

mysql -u [username] -p [database_name] < [input_file_name]

예시:

mysql -u root -p mydatabase < backup.sql

이 명령은 내보낸 backup.sql 파일을 지정한 데이터베이스 mydatabase에 가져옵니다. 가져오기가 성공하면 파일에 포함된 CREATE TABLE 및 INSERT 문이 실행되어 테이블이 생성되고 데이터가 삽입됩니다.

3.2 가져오기 시 유의사항

  • 데이터베이스 존재 여부 확인 : 대상 데이터베이스가 존재하지 않으면 오류가 발생합니다. 아래 명령을 사용해 미리 데이터베이스를 생성해야 합니다.
    CREATE DATABASE mydatabase;
  • 대용량 데이터 가져오기 : 대량 데이터를 가져오면 서버 성능에 영향을 줄 수 있습니다. 효율성을 높이려면 가져오기 전에 인덱스를 비활성화하거나 배치 처리 방식을 고려하십시오.

4. 오류 처리 및 문제 해결

데이터베이스 가져오기 작업 중에 오류가 자주 발생하지만, 적절한 처리로 해결할 수 있습니다. 이 섹션에서는 일반적인 오류 유형, 이를 피하는 방법, 그리고 구체적인 문제 해결 단계를 설명합니다.

4.1 일반적인 오류 예시

  1. ERROR 1064 (Syntax Error)
  • 원인 : MySQL 버전 간 호환성 문제나 파일 내 잘못된 SQL 구문으로 인해 발생합니다. 특히 새로운 MySQL 버전에서 사용되지 않는 구문이 포함된 경우에 흔합니다.
  • 해결 방법 : 오류 메시지에 표시된 특정 위치를 확인하고 문제가 되는 SQL 문을 수정하십시오. 다른 MySQL 버전 간 데이터 마이그레이션 시 적절한 버전 호환 옵션을 사용하십시오.
  1. ERROR 1049 (Unknown Database)
  • 원인 : 지정된 데이터베이스가 존재하지 않거나 데이터베이스 이름이 잘못된 경우 발생합니다.
  • 해결 방법 : 가져오기 전에 데이터베이스가 생성되었는지 확인하십시오. 존재하지 않으면 다음 명령으로 생성하십시오: CREATE DATABASE database_name;
  1. ERROR 1146 (Table Doesn’t Exist)
  • 원인 : SQL 파일에서 참조된 테이블이 데이터베이스에 존재하지 않을 때 발생합니다. 보통 가져오기 중 테이블이 제대로 생성되지 않아 발생합니다.
  • 해결 방법 : SQL 파일의 CREATE TABLE 문이 올바른지 확인하고 필요 시 테이블을 수동으로 생성하십시오.

4.2 오류를 피하기 위한 모범 사례

  • 내보내기 및 가져오기 환경 일치 : MySQL 버전이나 구성의 차이로 인해 구문 오류나 데이터 유형 불일치가 발생할 수 있습니다. 가능할 때마다 동일한 환경에서 내보내기와 가져오기를 수행하십시오.
  • 백업 파일 테스트 : 가져오기 전에 백업 파일의 내용을 확인하십시오. 예를 들어, 로컬 환경에서 새 데이터베이스를 생성하고 테스트 가져오기를 수행하여 모든 것이 올바르게 작동하는지 확인하십시오.

4.3 문제 해결

가져오기 중 오류를 식별하려면 오류 로그와 출력 메시지를 검토하는 것이 중요합니다. 아래는 몇 가지 문제 해결 단계입니다:

  1. 오류 메시지 확인 : MySQL 명령줄이나 로그에 표시된 오류 메시지는 필수적인 단서를 제공합니다. 문제의 줄 번호와 세부 사항을 나타내어 수정을 용이하게 합니다.
  2. 내보내기 파일 확인 : 내보낸 SQL 파일을 수동으로 검토하고 CREATE TABLE 및 INSERT INTO 문이 올바른지 확인하십시오. 또한 테이블이나 데이터가 누락되지 않았는지 확인하십시오.
  3. 내보내기 옵션 조정 : 내보내기 중 특정 옵션을 사용하면 문제를 피할 수 있습니다. 예를 들어, --compatible 옵션은 다른 MySQL 버전 간 호환성을 개선할 수 있습니다.

5. 가져오기 중 성능 최적화

대량의 데이터를 가져오면 데이터베이스 성능에 영향을 줄 수 있습니다. 이 섹션에서는 효율적인 가져오기를 위한 최적화 기법을 소개합니다.

5.1 인덱스 비활성화 및 재구축

인덱스는 가져오기 중 데이터 삽입 속도를 늦출 수 있습니다. 가져오기 시간을 줄이기 위해 가져오기 전에 인덱스를 비활성화하고 나중에 다시 활성화하십시오.

인덱스 비활성화 예시:

ALTER TABLE table_name DISABLE KEYS;

가져오기가 완료된 후 인덱스를 재구축하십시오:

ALTER TABLE table_name ENABLE KEYS;

5.2 배치 처리 사용

대규모 데이터 세트를 가져올 때 데이터를 더 작은 배치로 나누면 속도를 향상시키고 서버 부하를 줄일 수 있습니다. 예를 들어, 수백만 행을 한 번에 가져오는 대신 100,000행 단위로 배치로 나누십시오.

5.3 데이터 압축 활용

데이터 압축은 전송 시간을 줄이고 저장 공간을 절약합니다. gzip 같은 도구를 사용하여 데이터를 압축하고 가져오기 중에 압축을 해제할 수 있습니다.

압축된 파일 가져오기는 다음과 같이 수행할 수 있습니다:

gunzip < backup.sql.gz | mysql -u root -p mydatabase

6. 결론

MySQL 데이터베이스 관리에서 mysqldump를 사용한 내보내기와 가져오기는 매우 효과적인 방법입니다. 이 문서에서는 기본 사용법, 가져오기 중 오류 처리, 그리고 성능 최적화 기법을 다루었습니다.

특히 대규모 데이터베이스를 운영할 때는 인덱스 관리와 배치 처리를 통한 성능 최적화가 필수적입니다. 또한 정기적인 백업을 수행하고 테스트 임포트를 진행하면 예상치 못한 데이터 손실에 대비할 수 있습니다.

이러한 모범 사례를 구현하면 보다 원활하고 신뢰할 수 있는 데이터베이스 임포트 작업을 보장할 수 있습니다.