개요
소스에서 VillageSQL을 빌드하면 최신 기능을 얻을 수 있으며, 특정 환경에 맞게 빌드를 사용자 정의할 수 있습니다.사전 요구 사항
시작하기 전에 다음이 설치되어 있는지 확인하세요:- Git - 저장소 복제용
- CMake 3.16 이상 - 빌드 시스템 생성기
- C++ 컴파일러 - GCC 8+, Clang 8+, 또는 MSVC 2019+
- 빌드 도구 - make, ninja, 또는 해당 도구
- 개발 라이브러리 - OpenSSL, ncurses, pkg-config, bison, 및 기타 MySQL 종속성
의존성 설치
Ubuntu/Debian:단계 1: 저장소 복제
GitHub에서 VillageSQL Server 저장소를 복제합니다. CMake 단계가 수정 없이 작동하도록 홈 디렉터리에 복제하세요:저장소는 MySQL 코드베이스로 인해 몇 GB에 달합니다.
단계 2: CMake로 구성
저장소 외부에 빌드 디렉터리를 만들고 프로젝트를 구성합니다: Linux:Linux 사용자: 절대 경로에
$HOME 사용. macOS 사용자: ~ (틸드) 사용. 저장소 경로가 다른 경우 실제 복제 위치로 대체하세요.CMake 옵션 설명
<path-to-repo>- 복제된 VillageSQL 저장소 경로 (Linux에서는$HOME, macOS에서는~사용)-DWITH_DEBUG=1- 디버그 심볼 활성화 (개발에 권장됨)-DCMAKE_INSTALL_PREFIX=~/mysql- 설치 디렉터리 설정-DWITH_SSL=system- 시스템 OpenSSL 라이브러리 사용 (macOS에서 필수)
추가 CMake 옵션
디버그 심볼 없이 프로덕션 빌드: Linux:재구성해야 할 경우 먼저 CMake 캐시를 지우세요 (빌드 디렉터리에서 실행):
단계 3: 코드 컴파일
병렬 컴파일로 make를 사용하여 VillageSQL을 빌드합니다. 빌드 디렉터리에서 실행하세요: 서버만 빌드 (개발에 권장):단계 4: 데이터베이스 초기화
서버를 처음 시작하기 전에 데이터 디렉터리를 초기화합니다: Linux: 프로덕션 (생성된 비밀번호 포함 - 권장):--user=root 플래그가 필요합니다:
프로덕션과 유사한 환경에서는
--initialize (비밀번호 포함)를 사용하세요. --initialize-insecure (비밀번호 없음)은 로컬 개발 및 테스트에만 사용하세요. --initialize 사용 시 일시적 비밀번호가 콘솔에 생성되어 표시됩니다: root@localhost에 대한 임시 비밀번호가 생성되었습니다: <password>단계 5: 서버 시작
VillageSQL 서버를 시작합니다: Linux:단계 6: MySQL 클라이언트로 연결
새 터미널을 열고 MySQL 클라이언트로 서버에 연결합니다: Linux:--initialize-insecure 사용 (비밀번호 없음):
--initialize 사용 (생성된 비밀번호 포함):
--initialize-insecure 사용 (비밀번호 없음):
--initialize 사용 (생성된 비밀번호 포함):
설치 확인
VillageSQL을 실행 중인지 확인합니다:단계 7: 사용자 및 데이터베이스 설정
Root 비밀번호 변경
--initialize를 사용한 경우 일시적 비밀번호를 변경합니다:
개발 사용자 생성
일상 개발을 위해 root가 아닌 사용자를 생성합니다:데이터베이스 생성
문제 해결
빌드가 누락된 종속성으로 인해 실패
플랫폼에 맞는 개발 패키지를 설치하세요. 오류 메시지에서 누락된 라이브러리 확인.서버가 시작되지 않습니다
- 데이터 디렉터리가 초기화되었는지 확인:
ls ~/mysql-data/data/ - 다른 MySQL/VillageSQL 인스턴스가 포트 3306을 사용 중인지 확인
~/mysql-data/data/*.err에서 오류 로그 검토
확장 설치 실패
- 확장 라이브러리 (
.so또는.dll)가 빌드 출력에 존재하는지 확인 - VillageSQL이 확장을 로드할 수 있는 권한이 있는지 확인
- 확장 이름 및
.veb파일 이름이 올바른지 확인
다음 단계
확장 사용
VillageSQL 확장 설치, 업데이트, 관리 방법을 배웁니다.
확장 만들기
VillageSQL용 사용자 정의 확장을 구축합니다.
빠른 시작
VillageSQL 빠른 시작 가이드.

