概要
VillageSQL は、明確なバージョン管理と互換性ポリシーに従い、デプロイメントとアップグレードに関する情報に基づいた意思決定を支援します。VillageSQL のバージョン管理
VillageSQL は、セマンティックバージョニング (SemVer) を使用して、各リリースの変更内容とその影響を伝えます。バージョン形式
バージョンは、MAJOR.MINOR.PATCH の形式に従います。バージョンインクリメントルール
- MAJOR バージョン (例: 1.0.0 → 2.0.0): コードの変更やデータベースの移行が必要となる可能性のある破壊的な変更
- MINOR バージョン (例: 0.1.0 → 0.2.0): 後方互換性を維持したまま追加された新機能や機能拡張
- PATCH バージョン (例: 0.0.1 → 0.0.2): 後方互換性のあるバグ修正とマイナーな改善
VillageSQL は現在、1.0 より前の開発段階（バージョン 0.x.x）にあります。この段階では、プラットフォームを安定させるために、API と拡張インターフェイスがより頻繁に変更される可能性があります。
開発ビルド
プレリリースサフィックスが付いたバージョン（例:0.0.6-dev）は、開発ビルドです。デフォルトでは、開発ビルドで初期化されたデータベースからのアップグレードは、サーバーによってブロックされます。開発ビルドは、アップグレードの互換性についてテストされておらず、破壊的なスキーマまたはプロトコルの変更が含まれる可能性があります。
これを許可するには、サーバーを --villagesql-allow-unsafe-dev-upgrade フラグ付きで起動します。
最小限のアップグレード
--upgrade=MINIMAL を付けてサーバーを起動すると、絶対に必要というわけではないアップグレード手順がスキップされます。VillageSQL のスキーマアップグレードは、スキップされる手順には含まれません。サーバーのアップグレードが必要な状態でこのモードでサーバーを起動すると、サーバーのアップグレードをスキップしたという警告がログに記録され、保存されている VillageSQL スキーマバージョンがビルドバージョンと一致しない場合は VillageSQL のスキーマアップグレードが実行されます。
--villagesql-allow-unsafe-dev-upgrade を付けて起動してください。
コードベースの変更
すべての VillageSQL バージョンは、コードベース（サーバーがビルドの基盤とするアップストリームのフォーク）に結び付けられています。たとえば、mysql-9.7_0.0.6 は mysql-9.7 コードベースのバージョン 0.0.6 です。異なるコードベースのバージョン番号は比較できないため、コードベース間の移動はサポートされるアップグレードではありません。mysql-9.7_0.0.5 から mysql-9.7_0.0.6 へのアップグレードは可能ですが、mysql-9.7_0.0.6 から mysql-8.4_0.0.6 へのアップグレードはできません。
データディレクトリは、それを作成したサーバーのコードベースを villagesql_schema_version として記録します。そのデータディレクトリ上で、異なるコードベースからビルドされたサーバーを起動すると、起動は失敗し、エラーログには、villagesql_schema_version と同じ {codebase}_{version} 形式で両方のバージョンが示されます。
--upgrade=MINIMAL は、このチェックをバイパスしません。
拡張機能の互換性
VillageSQL 拡張機能はバージョン固有です。あるバージョンの VillageSQL 用に構築された拡張機能は、別のバージョンでは動作しない場合があります。 VillageSQL をアップグレードする際には、次の手順を実行します。- 新しいバージョンに対する拡張機能の互換性を確認します。
- 必要に応じて、拡張機能を更新または再構築します。
- 本番環境にデプロイする前に、開発環境で拡張機能をテストします。