> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Percona ビルド

> Percona Server for MySQL 8.4 上に構築された VillageSQL。

VillageSQL は **Percona Server** 上にもビルドできます。Percona Server は MySQL とソース互換のフォークであり、独自のストレージ機能、パフォーマンス機能、および可観測性機能を追加しています。

<h2 id="what-this-is">
  これは何か
</h2>

アップストリームの MySQL 8.4 ではなく、Percona 8.4 のコードベースに対してビルドされた VillageSQL サーバーです。VillageSQL Extension Framework、その SQL コマンド、およびその拡張機能は、どちらでも同じように動作します。Percona ビルドは、同じ VillageSQL の表層の下にある異なる基盤です。

VillageSQL は Percona 独自の機能については文書化しません。Percona Server 自体に関すること (ストレージエンジン、チューニングオプション、構成など) については、[Percona の公式ドキュメント](https://docs.percona.com/percona-server/8.4/)を参照してください。

<h2 id="identifying-a-percona-build">
  Percona ビルドの識別
</h2>

Percona ビルドは、バージョン文字列で異なるコードベースを報告します。

```sql theme={null}
SELECT @@villagesql_server_version;
-- Example output: percona-8.4_0.0.6
```

この変数の意味については、[システムリファレンス](/docs/ja/mysql-8.4/stable/reference#villagesql_server_version)を参照してください。VillageSQL は、あるコードベース (たとえば `mysql-8.4`) の datadir を、別のコードベース (たとえば `percona-8.4`) で実行中のサーバーへアップグレードすることを拒否します。

<h2 id="installing">
  インストール
</h2>

Percona ビルドは MySQL 8.4 ビルドと並行して提供され、3 つのインストール方法すべてで選べます。

**インストールスクリプト** 最初の質問で **Percona 8.4** を選びます。端末がない場合は、環境変数で直接指定します。

```bash theme={null}
curl -fsSL https://install.villagesql.com | \
  VSQL_CODEBASE=percona-8.4 INSTALL_METHOD=prebuilt bash
```

**Docker** イメージはコードベースごと、アーキテクチャごとに公開されています。

```bash theme={null}
docker run -d --name vsql -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -p 3306:3306 villagesql/server:percona-8.4_0.0.6-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
```

**リリースのダウンロード** [0.0.6 リリース](https://github.com/villagesql/villagesql-server/releases/tag/release/0.0.6) にある `villagesql-dev-server-percona-8.4_0.0.6-<os>-<arch>.tar.gz` は、Linux の x86\_64 と aarch64、および macOS の arm64 に対応します。

**ソース** `percona-8.4` ブランチをビルドします。リリースが提供したコードそのものをビルドするには `publish/percona-8.4_0.0.6` タグを使います。ビルド手順そのものは[ソースコードからのビルド](/docs/ja/mysql-8.4/stable/source)を参照してください。

datadir は、それを作成したコードベースに属します。VillageSQL は `mysql-8.4` の datadir を `percona-8.4` のサーバーで開くことを拒否するため、このビルドは既存のディレクトリを指すのではなく、専用のディレクトリにインストールしてください。