데이터베이스가 있는 모든 KapsuleHost 웹사이트는 phpMyAdmin을 통해 브라우저 기반 데이터베이스 접속을 제공받으며, 싱글 사인온으로 열리기 때문에 별도로 보관해야 할 두 번째 비밀번호가 없습니다. 이 가이드에서는 phpMyAdmin을 여는 방법, 접속 정보 확인 방법, 그곳에서 수행할 가치가 있는 작업, 그리고 WordPress 사이트에서 phpMyAdmin으로 절대 해서는 안 되는 두 가지 데이터베이스 작업을 다룹니다.
phpMyAdmin 열기
- KPanel에 로그인한 다음 왼쪽 사이드바에서 웹사이트를 클릭합니다.
- 사이트를 클릭합니다.
- 사이트 자체 메뉴에서 데이터베이스를 엽니다.
- phpMyAdmin 열기을 클릭합니다.
phpMyAdmin은 새 탭에서 열리며, 이미 로그인된 상태로 해당 사이트의 데이터베이스를 가리킵니다. 로그인 양식도 없고 별도로 저장해야 할 자격 증명도 없습니다.
해당 사이트 유형에는 데이터베이스가 프로비저닝되지 않았다는 메시지가 표시된다면 이는 정상입니다. 정적 HTML 사이트와 일부 애플리케이션 유형은 데이터베이스 없이 생성됩니다. WordPress와 WooCommerce를 포함해 데이터베이스를 사용하는 사이트 유형에는 항상 데이터베이스가 있습니다.
접속 정보
같은 화면에서 애플리케이션이 사용하는 자격 증명을 확인할 수 있으며, 각 항목에는 복사 버튼이 있고 비밀번호는 표시 버튼 뒤에 숨겨져 있습니다.
| 항목 | 값 |
|---|---|
| 호스트 | 127.0.0.1 |
| 포트 | 3306 |
| 데이터베이스 | 사용자의 데이터베이스 이름 |
| 사용자명 | 사용자의 데이터베이스 사용자 |
| 비밀번호 | 표시 버튼을 클릭하기 전까지 숨김 |
이 값들은 wp-config.php, .env 파일, 또는 어떤 프레임워크든 데이터베이스 설정에 들어가는 값입니다.
127.0.0.1은 "이 서버 자신"을 의미합니다. 노트북에서는 접속할 수 없으며, 아무리 방화벽을 설정해도 이는 바뀌지 않습니다. 데이터베이스는 설계상 공인 주소로 전혀 리스닝하지 않기 때문입니다. TablePlus나 Sequel Ace 같은 데스크톱 클라이언트를 연결하려면 SSH 터널을 사용하세요. SSH 터널을 통한 데이터베이스 접속을 참고하세요.
어떤 용도로 사용해야 하나
phpMyAdmin은 다음과 같은 특정 작업에서 제 역할을 합니다.
- 데이터 확인. 플러그인이 실제로 무엇을 저장했는지 확인하거나, 특정 행이 존재하는지 확인하거나, 레코드 수를 세는 작업.
- 마이그레이션이나 복원 작업 중 데이터베이스 가져오기.
- 추가 안전 복사본을 만들거나 개발자에게 전달하기 위한 데이터베이스 내보내기.
- 잘못 입력되어 wp-admin 로그인을 막아버린
siteurl처럼 깨진 단일 값 복구. - 용량 진단. 테이블을 크기순으로 정렬하면 로그 테이블이나 임시 테이블이 통제 불능으로 커졌을 때 바로 확인할 수 있습니다.
데이터베이스 가져오기
- Database 탭에서 phpMyAdmin을 엽니다.
- 왼쪽 패널에서 데이터베이스 이름을 클릭합니다.
- 상단의 Import를 클릭합니다.
.sql파일을 선택하고 Go를 클릭합니다.
가져오기는 일치하는 테이블을 교체합니다. 병합하지 않습니다.
운영 중인 데이터베이스에 가져오기를 수행하면 즉시 파괴적인 결과가 발생합니다. 일치하는 테이블의 모든 행이 파일에 있는 내용으로 교체되며, phpMyAdmin 안에는 되돌리기 기능이 없습니다. 먼저 사이트의 백업 페이지에서 백업을 받으세요: 백업하기.
대용량 덤프의 경우 먼저 .sql.gz로 압축하세요. phpMyAdmin이 이를 지원하며, 대개 업로드 용량 제한 이하로 줄일 수 있습니다. 그래도 너무 크다면 테이블별로 여러 파일로 나누거나, 티켓을 열어 주시면 저희가 서버 쪽에서 가져오기를 대신 진행해 드립니다.
데이터베이스 내보내기
- 왼쪽 패널에서 데이터베이스 이름을 클릭합니다.
- Export를 클릭합니다.
- 단순 복사라면 SQL 형식의 Quick이 적합합니다. 특정 테이블만 필요하거나 출력물을 gzip으로 압축하려면 Custom을 선택하세요.
- Go를 클릭합니다.
phpMyAdmin 내보내기는 유용한 추가 복사본이지 백업 전략이 아닙니다. 데이터베이스만 캡처할 뿐 파일은 포함하지 않으며, 저장한 위치에 남아 있을 뿐입니다. 사이트는 매일 데이터베이스와 파일이 함께 자동으로 백업되며, 언제든 수동으로도 백업을 받을 수 있습니다: 백업하기.
여기서 하면 안 되는 두 가지
SQL로 검색 및 바꾸기를 실행하지 마세요
WordPress는 플러그인과 테마 설정을 PHP 직렬화 문자열로 저장하며, 이 문자열은 내부의 각 값 길이를 함께 기록합니다. REPLACE() 쿼리는 기록된 길이는 그대로 둔 채 텍스트만 변경하므로, PHP가 더는 해당 옵션을 읽지 못하고 조용히 빈 값으로 되돌아갑니다. 테마 설정이 사라지고, 슬라이더가 비워지고, 라이선스가 해지됩니다.
사이트의 WordPress 탭에 있는 검색 및 바꾸기 카드를 사용하세요. 이 기능은 직렬화를 올바르게 처리하며 먼저 백업을 수행합니다. 자세한 설명: 검색 및 바꾸기 실행하기.
wp_users를 편집해서 비밀번호를 재설정하지 마세요
오래된 가이드에서는 phpMyAdmin 드롭다운의 MD5 함수를 사용해 user_pass을 설정하라고 안내합니다. 최신 WordPress는 MD5 해시를 사용하지 않으며, 이를 잘못 설정하면 비밀번호가 재설정되는 대신 계정이 잠겨버립니다.
KPanel에는 이를 위한 제대로 된 도구가 사이트의 WordPress 탭, Users 섹션에 마련되어 있습니다: Login as로 바로 로그인하거나, 재설정 이메일을 보내거나, 재설정 링크를 복사해 직접 보낼 수 있습니다. 분실한 WordPress 관리자 비밀번호 재설정하기를 참고하세요.
KPanel의 WordPress 데이터베이스 도구
일상적인 WordPress 데이터베이스 작업에는 WordPress 탭의 데이터베이스 섹션이 phpMyAdmin보다 더 안전하고 빠릅니다. 테이블 크기를 한눈에 보여주고, 먼저 자동 백업을 수행한 뒤 최적화와 복구를 진행하며, 오래된 테이블을 최신 스토리지 엔진으로 변환하고, 게시물 리비전, 자동 임시 저장본, 만료된 임시 데이터, 휴지통에 있는 게시물을 한 번의 클릭으로 정리할 수 있습니다. 검색 및 바꾸기는 바로 옆 섹션인 빠른 작업에 있습니다.
원시 데이터 행을 직접 확인해야 할 때는 phpMyAdmin을 사용하세요. 무언가를 변경해야 할 때는 Database 섹션을 사용하세요.
문제 해결
phpMyAdmin이 열리지 않습니다. 이 버튼에는 사이트에 대한 쓰기 권한이 필요합니다. KapsuleHost 계정 역할이 읽기 전용이라면 계정 소유자에게 요청하세요. 쓰기 권한이 있는데도 계속 실패한다면 사이트가 아직 프로비저닝 중일 수 있으니 사이트 상단의 상태 표시를 확인하세요.
Database 탭에 나온 정보로 노트북에서 연결할 수 없습니다. 맞습니다. 의도된 동작입니다. 데이터베이스는 공개적으로 노출되지 않습니다. SSH 터널을 사용하세요: SSH 터널을 통한 데이터베이스 접속.
가져오기가 오류 없이 멈춥니다. 거의 항상 파일 크기 문제입니다. gzip으로 압축하거나 파일을 나누세요.
값을 변경했더니 사이트가 망가졌습니다. 가장 최근 백업에서 복원하세요: 백업에서 복원하기. 이것이 바로 백업을 먼저 받아야 하는 이유입니다.
테이블이 엄청나게 커졌습니다. phpMyAdmin에서 크기순으로 정렬해 원인을 찾은 다음, 행을 직접 삭제하기보다는 WordPress 탭의 데이터베이스 섹션에서 정리하세요.