> ## 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 Server で始める

> Percona Server for MySQL 8.4.11 上に構築された VillageSQL Server 0.0.7

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

## これは何か

アップストリームの 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/)を参照してください。

## 含まれていないもの

このビルドには、Percona の機能のうち 3 つが含まれていません。

**MyRocks** RocksDB ストレージエンジンはビルドされないため、`SHOW ENGINES` に `ROCKSDB` は表示されず、`rocksdb_*` システム変数も存在しません。このエンジンを指定したテーブルは失敗します。

```sql theme={null}
CREATE TABLE t (i INT) ENGINE=ROCKSDB;
-- ERROR 1286 (42000): Unknown storage engine 'ROCKSDB'
```

Percona サーバーから取得したダンプのリストアは、このエンジンを指定した最初のテーブルで停止します。それより前に作成されたテーブルは残り、それ以降はスキップされます。

**KMIP キーリングコンポーネント** `component_keyring_file`、`component_keyring_kms`、`component_keyring_vault` はすべて同梱され、インストールできます。`component_keyring_kmip` はビルドされないため、インストールは `ERROR 1126` で失敗します。

**Percona の coredumper** `--coredumper` オプションは引き続き受け付けられます。サーバーは、ライブラリがビルドされているかどうかに関係なく、このオプションを登録するためです。ただし、ここではライブラリはビルドされていません。

Percona のその他の追加機能は通常どおり動作します。これには `percona_udf` コンポーネント、監査ログプラグイン、`USER_STATISTICS` ビューおよび `TABLE_STATISTICS` ビューが含まれます。これらのビューは `SET GLOBAL userstat = ON` の後に値が入ります。

## Percona ビルドの識別

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

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

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

## 次のステップ

> [card] [インストール](https://villagesql.com/docs/ja/8.4/stable/install-percona.md)
>
> インストールスクリプト、Docker、またはソースビルドで Percona ビルドをインストールします。

> [card] [拡張機能のインストール](https://villagesql.com/docs/ja/extensions/install.md)
>
> サーバーに新しい型と関数を追加します。

> [card] [システムリファレンス](https://villagesql.com/docs/ja/8.4/stable/reference.md)
>
> 拡張機能のメタデータとサーバー状態のためのシステムビューと変数。

> [card] [サーバー開発ガイド](https://villagesql.com/docs/ja/8.4/stable/server-development.md)
>
> サーバーコードのデバッグ、テスト、および貢献。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.