概要
ソースコードから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を使用すると、一時的なパスワードが生成され、コンソールに出力されます:A temporary password is generated for 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のクイックスタートガイド。

