mysql_pluginとは?MySQLサーバーのプラグインを簡単に管理・構成する方法

mysql_pluginユーティリティの概要

mysql_pluginは、MySQL管理者がサーバーにロードされるプラグインを効率的に管理するためのコマンドラインユーティリティです。

通常、プラグインを有効化するには、サーバー起動時に--plugin-loadオプションを手動で指定するか、実行時にINSTALL PLUGINおよびUNINSTALL PLUGINステートメントを使用する必要があります。mysql_pluginを使えば、これらの操作をコマンド一つで簡単に行うことができます。

mysql_pluginの仕組み

mysql_pluginが呼び出されると、プラグインを有効化するか無効化するかに応じて、プラグインレジストリとして機能するmysql.pluginテーブルに対して、それぞれ行の挿入または削除を実行します。

通常のサーバー起動時には、mysql.pluginテーブルに登録されているプラグインが自動的にロードされ、有効化されます。

さらに細かくプラグインのアクティベーションを制御したい場合は、特定のプラグイン名を指定した--plugin_nameオプションを使用することも可能です。

基本的な使い方

mysql_pluginを実行するたびに、単一のプラグインライブラリファイルに含まれるプラグインの構成方法を決定するための設定ファイルが読み込まれます。mysql_pluginを呼び出す際は、以下のコマンド形式を使用します。

mysql_plugin [options] plugin {ENABLE|DISABLE}

• plugin:構成対象となるプラグインの名前を指定します。
• ENABLE|DISABLE:設定ファイルで指定されたプラグインライブラリのコンポーネントを有効化または無効化します。大文字と小文字は区別されません。

なお、plugin引数とENABLE/DISABLE引数の記述順序は問われません。

具体例:mypluginsライブラリの構成

Linuxでは「myplugins.so」、Windowsでは「myplugins.dll」という名前のプラグインライブラリファイルのコンポーネントを構成する場合、plugin値としてmypluginsを指定します。

このプラグインライブラリに、plugin1、plugin2、plugin3という3つのプラグインが含まれており、すべてmysql_pluginで管理したいと仮定しましょう。

慣例として、設定ファイルには拡張子「.ini」が付き、プラグインライブラリと同じベース名を持つため、このライブラリのデフォルト設定ファイル名は「myplugins.ini」になります。

設定ファイルの内容は以下のようになります。

myplugins
plugin1
plugin2
plugin3

ファイルの1行目は、.soや.dllなどの拡張子を除いたライブラリファイル名を示します。残りの行は、有効化または無効化するコンポーネントの名前です。

各値は必ず別々の行に記述してください。また、先頭文字が「#」である行はコメントとして扱われ、無視されます。

プラグインの有効化と無効化

設定ファイルに記載されたプラグインを有効化するには、以下のようにmysql_pluginを実行します。

shell> mysql_plugin myplugins ENABLE

プラグインを無効化する場合は、ENABLEの代わりにDISABLEを使用してください。

mysql_pluginで利用できる主なオプション

mysql_pluginは以下のオプションをサポートしています。これらはコマンドライン上、または任意のオプションファイルの[mysqld]グループ内で指定できます。

--help, -?

ヘルプメッセージを表示して終了します。

--basedir=dir_name, -b dir_name

サーバーのベースディレクトリを指定します。

--datadir=dir_name, -d dir_name

サーバーのデータディレクトリを指定します。

--my-print-defaults=file_name

my_print_defaultsプログラムが存在するパスを指定します。

--mysqld=file_name

mysqldサーバーへのパスを指定します。

--no-defaults

設定ファイルから値を読み込まないことを示します。このオプションにより、管理者は設定ファイルからのデフォルト値の読み込みをスキップできます。

--plugin-dir=dir_name, -p dir_name

サーバーのプラグインディレクトリを指定します。

--verbose, -v

詳細モードで実行し、プログラムの動作に関するより多くの情報を出力します。このオプションを複数回指定すると、表示される情報量を増やすことができます。

--version, -V

バージョン情報を表示して終了します。