ServBay에서 phpMyAdmin으로 MySQL/MariaDB 데이터베이스 관리하기

개요: phpMyAdmin이란?

phpMyAdmin은 MySQL 및 MariaDB 데이터베이스를 웹 인터페이스로 관리할 수 있게 해주는 널리 사용되는 오픈소스 데이터베이스 관리 도구입니다. 웹 개발자에게 직관적이고 사용하기 쉬운 그래픽 인터페이스를 제공하여, 데이터베이스 및 테이블·사용자 생성, SQL 쿼리 실행, 데이터 가져오기·내보내기 등 일상적인 데이터베이스 관리를 매우 쉽게 할 수 있습니다.

ServBay는 강력한 로컬 웹 개발 환경으로, 이미 phpMyAdmin이 통합되어 있어 ServBay에서 실행 중인 MySQL 또는 MariaDB 인스턴스를 손쉽게 관리할 수 있습니다.

phpMyAdmin의 주요 장점은 다음과 같습니다:

1. 강력한 기능: 대부분의 MySQL 및 MariaDB 핵심 기능을 지원하며, 데이터베이스, 테이블, 필드, 인덱스, 사용자 권한 등 다양한 관리 요구를 충족합니다.
2. 사용자 친화적: 직관적인 그래픽 UI를 제공하여 데이터베이스 초보자도 쉽게 사용할 수 있습니다.
3. 다국어 지원: 다양한 언어로 인터페이스를 제공하므로 전 세계 어디서나 사용이 편리합니다.
4. 확장성: 플러그인 또는 스크립트를 통해 기능 확장이 쉽습니다.

phpMyAdmin을 사용하면 개발자는 데이터베이스 명령줄 작업에 많은 시간을 쏟지 않고, 애플리케이션 로직 개발에 집중할 수 있습니다.

ServBay에서 phpMyAdmin 접속하기

ServBay에는 기본적으로 phpMyAdmin이 내장되어 있으므로, 제공된 로컬 접속 주소로 쉽게 접근할 수 있습니다.

ServBay가 실행 중일 때, 웹 브라우저에서 다음 주소를 방문해 주세요:

https://servbay.host/phpmyadmin

참고로, servbay.host는 ServBay의 기본 로컬 도메인으로, 내장된 Caddy/Nginx 서버가 이를 ServBay의 환영 페이지 및 통합 도구(phpMyAdmin 등)로 연결해줍니다. ServBay가 실행 중이고, 관련 웹 서버(Caddy 또는 Nginx)와 데이터베이스 패키지(MySQL 또는 MariaDB)가 활성화되어 있는지 확인하세요.

phpMyAdmin 로그인하기

데이터베이스 관리를 시작하려면 올바른 계정정보로 phpMyAdmin에 로그인해야 합니다.

1. 브라우저 실행: phpMyAdmin 주소인 https://servbay.host/phpmyadmin로 접속합니다.
2. 접속 정보 입력: 로그인 화면에서 사용자 이름과 비밀번호를 입력해야 합니다.
   • 사용자명 및 비밀번호: ServBay 앱의 데이터베이스(Databases) 탭에서 ServBay에서 기본 제공하는 데이터베이스 사용자(일반적으로 root)와 비밀번호를 확인할 수 있습니다. 최초 사용 후 보안을 위해 root 비밀번호를 변경하는 것을 권장합니다.
   • 서버: 일반적으로 default를 입력하거나, 원하는 데이터베이스 버전(예: MariaDB-10.6 또는 MySQL-8.0)을 선택합니다. default는 ServBay에서 현재 기본 활성화된 데이터베이스 버전을 의미합니다.
3. 로그인: “로그인” 버튼을 클릭하여 phpMyAdmin 관리 페이지에 입장합니다.

phpMyAdmin으로 ServBay 데이터베이스 관리하기

phpMyAdmin에 성공적으로 로그인하면, 그래픽 인터페이스를 통해 다양한 데이터베이스 관리 작업을 수행할 수 있습니다. 주요 작업은 다음과 같습니다:

새 데이터베이스 생성하기

새로운 프로젝트를 위해 독립된 데이터베이스를 만드는 것이 일반적인 시작 단계입니다.

1. phpMyAdmin 왼쪽 네비게이션에서 새로 만들기 또는 페이지 가운데의 데이터베이스 탭을 클릭합니다.
2. “데이터베이스 생성”란에 원하는 데이터베이스 이름(예: servbay_project_db)을 입력합니다.
3. “정렬 규칙” 드롭다운에서 원하는 문자셋과 정렬 규칙을 선택합니다. 일반적으로 utf8mb4_unicode_ci를 추천합니다(이모지 등 폭넓은 문자 지원).
4. 생성 버튼을 클릭합니다.

새 테이블 생성하기

데이터베이스 생성 후, 테이블을 만들어 데이터 구조를 정의할 수 있습니다.

1. 왼쪽 네비게이션에서 방금 만든 데이터베이스명을 클릭합니다.
2. 데이터베이스 구조 화면에서 “새 테이블 생성” 영역을 찾습니다.
3. 테이블명(예: users)과 필요한 필드 수를 입력합니다.
4. 생성 버튼을 클릭합니다.
5. 새 페이지에서 각 필드의 속성을 정의하세요:
   • 이름: 필드명(예: id, username, email, created_at)
   • 유형: 데이터 타입(예: INT, VARCHAR, TEXT, DATETIME)
   • 길이/값: 데이터 타입에 맞는 길이 지정(예: VARCHAR(255))
   • 기본값: (선택 사항) 필드의 기본값 설정
   • 인덱스: PRIMARY, UNIQUE, INDEX 등의 인덱스 설정. 일반적으로 id에 PRIMARY와 AUTO_INCREMENT를 적용
   • 자동증가(A_I): 체크하면 해당 필드가 자동 증가하도록 설정(주로 기본키에 사용)
6. 모든 필드를 설정한 후, 페이지 하단의 저장 버튼을 클릭합니다.

데이터 삽입하기

테이블에 새 레코드를 추가할 수 있습니다.

1. 왼쪽 네비게이션에서 데이터 삽입 대상 테이블을 선택합니다.
2. 상단 메뉴에서 삽입 탭을 클릭합니다.
3. 추가할 데이터 값을 입력하세요. 여러 행을 한번에 삽입할 수도 있습니다.
4. 페이지 하단의 실행 버튼을 클릭합니다.

데이터 조회 및 탐색

테이블에 저장된 데이터를 조회하거나, 맞춤형 쿼리를 실행할 수 있습니다.

1. 왼쪽 네비게이션에서 데이터를 보고 싶은 테이블을 선택합니다.
2. 상단 메뉴에서 탐색 탭을 클릭합니다. 테이블의 앞부분 데이터가 표시됩니다.
3. 더 복잡한 쿼리를 실행하고자 한다면 SQL 탭을 클릭한 후, SQL 문(예: SELECT * FROM users WHERE username = 'servbay-demo';)을 입력 후 실행을 클릭합니다.

데이터 수정하기

테이블의 기존 레코드를 수정합니다.

1. 왼쪽 네비게이션에서 데이터 수정 대상 테이블을 선택합니다.
2. 탐색 탭에서 수정할 데이터 행을 찾습니다.
3. 해당 행 오른쪽의 편집 아이콘(보통 연필 모양)을 클릭하세요.
4. 원하는 필드 값을 수정합니다.
5. 페이지 하단의 실행 버튼을 눌러 저장합니다.

데이터 삭제하기

테이블에서 레코드를 삭제합니다.

1. 왼쪽 네비게이션에서 삭제할 데이터가 있는 테이블을 선택합니다.
2. 탐색 탭에서 삭제할 데이터 행을 찾습니다.
3. 해당 행 왼쪽의 체크박스를 선택합니다.
4. 여러 행을 한 번에 선택하여 일괄 삭제도 가능합니다.
5. 행 오른쪽의 삭제 아이콘(보통 X자 아이콘)을 클릭하거나, 복수 선택 시 페이지 하단의 삭제 작업을 선택한 후 실행을 클릭합니다.
6. 삭제 작업을 확인합니다.

테이블 삭제하기

전체 테이블과 해당 데이터까지 완전히 삭제합니다.

1. 왼쪽 네비게이션에서 삭제할 테이블이 포함된 데이터베이스를 선택합니다.
2. 데이터베이스 구조 화면에서 삭제할 테이블을 찾으세요.
3. 테이블 왼쪽의 체크박스를 선택합니다.
4. 테이블 목록 하단에서 삭제 작업을 찾아 실행을 클릭합니다.
5. 삭제 작업을 확인합니다. 삭제된 테이블과 그 데이터는 복구할 수 없습니다.

데이터베이스 삭제하기

데이터베이스 전체, 포함된 모든 테이블·데이터까지 완전히 제거합니다.

1. 왼쪽 네비게이션에서 삭제하려는 데이터베이스를 선택합니다.
2. 상단 메뉴에서 작업 탭을 클릭합니다.
3. 페이지 하단의 “데이터베이스 삭제(Drop the database)” 영역에서 데이터베이스 삭제 버튼을 클릭합니다.
4. 삭제 확인 후 실행합니다. 데이터베이스 삭제는 복구가 불가능합니다.

자주 묻는 질문 (FAQ)

• Q: https://servbay.host/phpmyadmin에 접속이 안됩니다.
  • A: ServBay 앱이 실행중이고, ServBay 제어판에서 웹 서버(Caddy 혹은 Nginx) 및 접속하려는 데이터베이스(예: MySQL, MariaDB)가 활성화되어 있는지 확인하세요. 시스템 hosts 파일이 다른 프로그램에 의해 수정되지 않았는지도 점검하시고, ServBay를 재시작해 보세요.
• Q: 데이터베이스 사용자명과 비밀번호는 어디서 찾나요?
  • A: ServBay 앱 데이터베이스(Databases) 탭에서 기본 root 비밀번호를 확인할 수 있습니다. 자세한 내용은 데이터베이스 root 계정 정보 및 접속 정보 얻기 문서를 참고하세요.
• Q: 데이터베이스 root 비밀번호를 잊어버렸어요.
  • A: ServBay는 데이터베이스 root 비밀번호 초기화 기능을 제공합니다. ServBay 앱의 데이터베이스(Databases) 탭에서 ‘비밀번호 초기화’ 버튼을 찾을 수 있습니다. 클릭 시 MySQL 또는 MariaDB 등 선택한 데이터베이스의 기본 root 비밀번호를 자동으로 재설정해줍니다.
• Q: phpMyAdmin에서 ServBay의 PostgreSQL 또는 MongoDB에 접속할 수 있나요?
  • A: phpMyAdmin은 MySQL과 MariaDB 전용 관리 도구로, PostgreSQL이나 MongoDB는 지원하지 않습니다.

요약

ServBay에 내장된 phpMyAdmin을 사용하면 로컬 개발 환경에서 MySQL과 MariaDB 데이터베이스를 쉽고 효율적으로 관리할 수 있습니다. 단순한 생성·삭제 뿐만 아니라, 데이터 삽입, 조회, 수정, 삭제 등 다양한 데이터베이스 작업을 그래픽 인터페이스로 손쉽게 처리할 수 있습니다. ServBay의 편리한 환경 관리 기능과 결합되어, 웹 애플리케이션 개발 및 테스트 작업이 더욱 원활해집니다.