그누보드4에서 그누보드5로 데이터베이스 테이블 접두사 변경 및 마이그레이션

• 목록
• 스크랩

그누보드4에서 그누보드5로 데이터베이스 테이블 접두사 변경 및 마이그레이션

그누보드4에서 그누보드5로 업그레이드할 때 발생하는 테이블 접두사(g4 -> g5) 불일치 문제를 해결하고 데이터베이스 테이블 명칭을 안전하게 변경하는 방법

그누보드4에서 그누보드5로 마이그레이션하기 위해 데이터베이스 테이블 접두사를 g4_에서 g5_로 변경하려면, phpMyAdmin과 같은 데이터베이스 관리 도구에서 SQL RENAME TABLE 명령어를 사용해야 합니다.

테이블 접두사 변경 절차

1. 데이터베이스 백업: 작업 전 반드시 현재 데이터베이스를 전체 백업하여 데이터 손실에 대비하십시오.
2. SQL 명령어 실행: phpMyAdmin의 SQL 실행 창에 아래와 같은 형식의 명령어를 입력하여 실행합니다.

RENAME TABLE g4_auth TO g5_auth;
RENAME TABLE g4_board TO g5_board;
RENAME TABLE g4_board_file TO g5_board_file;
/*...기타 기본 테이블들에 대해 동일하게 적용... */

게시판 테이블 처리

게시판별로 생성된 g4_write_게시판명 테이블들 역시 g5_write_게시판명으로 각각 이름을 변경해야 합니다. 현재 이를 일괄적으로 처리하는 자동화 스크립트는 제공되지 않으므로, 각 테이블에 대해 수동으로 RENAME TABLE 명령을 수행해야 합니다.

*참고: 데이터베이스 테이블 구조 변경은 시스템 운영에 직접적인 영향을 미치므로, 작업 전 반드시 전체 백업본을 확보하시기 바랍니다.

게시판별 테이블명 변경 방법

그누보드4에서 그누보드5로 데이터베이스를 이전할 때, 추가 생성된 게시판별 테이블(g4_write_게시판명)은 RENAME TABLE 명령어를 사용하여 g5_write_게시판명으로 각각 변경해야 합니다.

테이블명 변경 절차

1. phpMyAdmin 접속: 데이터베이스 관리 도구인 phpMyAdmin 등의 프로그램에 접속합니다.
2. SQL 명령어 입력 및 실행: SQL 명령어 입력 항목에 아래와 같은 형식의 쿼리를 입력하여 실행합니다.

rename table g4_write_게시판명 to g5_write_게시판명;

• 주의: 게시판명 부분에는 실제 생성된 게시판의 영문 테이블 아이디를 각각 대입해야 합니다.

확인 및 주의사항

• 게시판별 테이블(g4_write_...)의 경우 자동화 스크립트가 별도로 제공되지 않으므로, 생성된 게시판 개수에 맞춰 수동으로 모두 변경 작업을 수행해야 합니다.
• 변경 작업 전 데이터베이스 백업을 반드시 진행하시기 바랍니다.

데이터베이스 테이블 접두사 변경 후 수정해야 할 설정 파일

그누보드에서 데이터베이스 테이블 명칭이나 접두사를 변경한 이후에는 웹 파일에서 데이터베이스 연결과 테이블 변수를 정의하는 설정 파일을 함께 수정해야 합니다.

• 설정 파일 위치: /data/dbconfig.php 파일에 테이블 변수가 정의되어 있습니다.
• 다음 행동: 데이터베이스의 테이블 접두사를 변경한 후, 에디터 등을 통해 /data/dbconfig.php 파일을 열어 변경된 접두사로 함께 수정해야 사이트가 정상적으로 데이터베이스와 연동됩니다.

상황별 판단 및 행동 지침

• 내 상황: 그누보드4에서 그누보드5로 업그레이드하면서 데이터베이스 테이블 접두사를 g4_에서 g5_로 변경해야 하는 경우
• 우선할 판단: phpMyAdmin 등의 관리 도구를 통해 전체 데이터베이스 백업을 우선 수행하고, 기본 테이블 및 게시판별(g4_write_...) 테이블의 명칭을 일괄적으로 변경할 준비를 합니다.
• 다음 행동: RENAME TABLE g4_auth TO g5_auth;와 같은 SQL 명령어를 사용하여 각 테이블 접두사를 변경하고, 이후 /data/dbconfig.php 파일의 설정값을 변경된 접두사로 수정합니다.

실전 FAQ

• Q: 게시판별 테이블(g4_write_...)도 일괄적으로 변경할 수 있는 자동화 스크립트가 있나요?
  • 원문 및 가이드 기준에 따르면 게시판별 테이블을 한 번에 바꾸는 공식 자동화 스크립트는 별도로 제공되지 않으므로, 각 게시판 테이블에 대해 수동으로 RENAME TABLE 명령어를 수행해야 합니다.

함께 보면 좋은 글

• 그누보드 SMS5 모듈 DB 테이블 접두사 변경 및 설정 방법
• 그누보드4에서 그누보드5로 이전 시 데이터베이스 설정(dbconfig.php) 가이드
• PHP mysql 함수에서 mysqli로의 마이그레이션 및 CRUD 구현 가이드

참고자료

기타 참고자료

• sir.kr — 이미 설치해버린... db 테이블명 접두사를 변경하고 싶습니다.... - SIR - 개발자 커뮤니티
• homzzang.com — 그누보드5 설치 시, 테이블 접두어 "가능한 변경하지 마십시오." 이유? (= 테이블 접두사 변경 시 단점/불이익/불편한점) ※ 테이블변수…
• sir.kr — 게시판의 테이블명 변경 방법 - SIR - 개발자 커뮤니티