Skip to main content

コマンド構文

VERSIONが指定された場合、サーバーはそれをインストールされている拡張機能のバージョンと比較し、バージョンが異なる場合は処理を中止します。現在インストールされているバージョンをアンインストールするには、この句を省略します。
拡張機能をアンインストールする前に、拡張機能で使用されているすべての列、ストアドプロシージャのパラメータ、およびDECLARE変数を削除する必要があります。アンインストールプロセスでは、拡張機能によって提供されるすべての関数とタイプが削除されます。

前提条件

  • VillageSQLへの管理者アクセス
  • 拡張機能のカスタムタイプを使用しているテーブルがないこと
  • 拡張機能のカスタムタイプを使用しているパラメータまたはDECLARE変数を持つストアドプロシージャがないこと
  • 拡張機能がカスタムデータを保存している場合は、データのバックアップ

アンインストール手順

1. アンインストールを試行

アンインストールコマンドを実行します。拡張機能に依存関係がない場合、すぐに成功します。列が依存している場合、エラーメッセージには正確にどの列であるかが示されます。
拡張機能に列の依存関係がある場合、次のようなエラーが表示されます。
特定された列を削除または変更してから、再試行します。
ストアドプロシージャが拡張機能のカスタムタイプを使用している場合、次のようなエラーが表示されます。
ストアドプロシージャを削除または変更して、型付きパラメータまたは変数を削除してから、再試行します。

2. 拡張機能をアンインストール

予期しないバージョンのアンインストールを防ぐために(CI環境やローリングアップグレード後に役立ちます)、VERSION句を含めます。
1.2.0がインストールされているバージョンでない場合、サーバーはエラーを返し、拡張機能をそのままにします。
これにより削除されるもの:
  • ✅ 拡張機能によって提供されるすべてのVDF(関数)
  • ✅ 拡張機能によって登録されたカスタムタイプの定義
  • ✅ 拡張機能の登録レコード
  • ✅ 拡張機能のカスタム列メタデータ
  • mysqld-auto.cnfからの拡張機能の永続システム変数(SET PERSIST
これにより削除されないもの:
  • .vebファイルはveb_dirに残ります
  • {datadir}/.veb_expansion_cache/内の展開されたディレクトリは一時的に残ります
  • ❌ テーブルデータ(カスタムタイプを持つテーブルを最初に削除する必要があります)
{datadir}/.veb_expansion_cache/{extension}/{sha256}/内の展開ディレクトリは、サーバーの再起動時に自動的にクリーンアップされます。
UNINSTALL EXTENSIONは、拡張機能に関連する永続システム変数をmysqld-auto.cnfから削除します。以前にSET PERSIST extensionname.varname = valueを実行した場合、そのエントリはアンインストール中に自動的に削除されます。永続化された値は、サーバーのシャットダウン中に削除されることはありません。拡張機能は、次回ロード時にそれらを読み取ることができるように、再起動後も保持されます。

3. アンインストールを確認

一般的なエラー

オプション:.vebファイルを削除

.vebファイルはアンインストール後に残ります。完全に削除するには:
.vebファイルは、将来の再インストールのために安全に保持できます。削除してもサーバーのパフォーマンスに影響はありません。

再インストール

拡張機能を再インストールするには、INSTALL EXTENSIONを再度使用します(.vebファイルがまだ存在する場合)。
詳細については、拡張機能のインストールを参照してください。

次のステップ

拡張機能のインストール

必要に応じて拡張機能を再度追加します

拡張機能の管理

拡張機能を監視およびトラブルシューティングします

システムリファレンス

システムテーブルをクエリします