Hatena::ブログ(Diary)

Y-Ken Studio - 日々クリエイション このページをアンテナに追加 RSSフィード

2012-02-04 MySQL の INSTALL PLUGIN に失敗する時の処方箋(mroonga-1.20編) このエントリーを含むブックマーク このエントリーのブックマークコメント

MySQLにストレージプラグインを登録しようとした際、予期せぬエラーが起きる事があります。

mroonga の事例を用いて、その原因と解消法を紹介します。

Case.1: API version for STORAGE ENGINE plugin is too different

mysql> INSTALL PLUGIN groonga SONAME 'ha_groonga.so';
ERROR 1126 (HY000): Can't open shared library 'ha_groonga.so' (errno: 0 API version for STORAGE ENGINE plugin is too different)

原因:異なる(おそらく古い)MySQL向けにコンパイルされたプラグインをMySQLに読み込ませた事によるエラーです。

解決法:そのプラグインが推奨するMySQLのバージョンを利用するか、プラグインを再コンパイルしましょう。

Case.2: errno: 13 undefined symbol: ○○○

mysql> INSTALL PLUGIN groonga SONAME 'ha_groonga.so';
ERROR 1126 (HY000): Can't open shared library '/usr/lib/mysql/plugin/ha_groonga.so' (errno: 13 undefined symbol: _db_pargs_)

原因:Case.1と同様、組み合わせの不一致によるものです。

解決法:そのプラグインが推奨するMySQLのバージョンを利用するか、プラグインを再コンパイルしましょう。

mroongaに限って言えば、groonga-repositoryにて再配布されているMySQLのrpmをを使わずに、remi等の外部リポジトリを利用してインストールすると、このエラーが起きます。

mysql-groonga-0.4.2で発生していたエラーを引用しました

Case.3: Can't find symbol '○○○' in library

mysql> INSTALL PLUGIN groonga SONAME 'ha_mroonga.so';
ERROR 1127 (HY000): Can't find symbol 'groonga' in library

原因:プラグイン名の指定を間違えてます。

解決法:.soファイルに対応した名前を用いて下さい。

Case.4: Duplicate entry '○○○' for key 'PRIMARY'

mysql> INSTALL PLUGIN groonga SONAME 'ha_groonga.so';
ERROR 1062 (23000): Duplicate entry 'mroonga' for key 'PRIMARY'

原因:プラグインの管理テーブル(mysql.plugin)に不整合が起きています。

解決法:該当テーブルの調整を行う必要があります。少々手間が掛かるため、次の項にて解説します。

Case.4 の解決法

Case.4のMySQLのプラグイン管理テーブルに不整合が発生した場合の解決法を紹介します。

実はこちら、mroonga-1.2.0のリリースノートに以下の気になる事象が記載されていたので、意図的に不整合を起こし、復旧を行った記録です。

> 今のmroongaのRPMの作りがあまりよくなくて"yum remove"を忘れるとプラグイン管理テーブル(?)が壊れてしまいます。

> http://mroonga.github.com/ja/blog/2012/01/29/release.html


さて、順を追って見てみましょう。


インストール時に出たエラー

カジュアルに「yum upgrade mysql-mroonga」と実行してしまうと、インストール中に以下のエラーが出ます。

/usr/bin/mysql -u root -e " INSTALL PLUGIN mroonga SONAME 'ha_mroonga.so'; CREATE FUNCTION last_insert_grn_id RETURNS INTEGER soname 'ha_mroonga.so'; "
ERROR 1062 (23000) at line 1: Duplicate entry 'mroonga' for key 'PRIMARY'

プラグイン状況を確認

登録に失敗しているので、もちろん一覧には出ません。

mysql> show engines;
+--------------------+---------+----------------------------------------------------------------+--------------+------+------------+
| Engine             | Support | Comment                                                        | Transactions | XA   | Savepoints |
+--------------------+---------+----------------------------------------------------------------+--------------+------+------------+
| MRG_MYISAM         | YES     | Collection of identical MyISAM tables                          | NO           | NO   | NO         |
| CSV                | YES     | CSV storage engine                                             | NO           | NO   | NO         |
| MyISAM             | YES     | MyISAM storage engine                                          | NO           | NO   | NO         |
| BLACKHOLE          | YES     | /dev/null storage engine (anything you write to it disappears) | NO           | NO   | NO         |
| MEMORY             | YES     | Hash based, stored in memory, useful for temporary tables      | NO           | NO   | NO         |
| InnoDB             | DEFAULT | Supports transactions, row-level locking, and foreign keys     | YES          | YES  | YES        |
| ARCHIVE            | YES     | Archive storage engine                                         | NO           | NO   | NO         |
| PERFORMANCE_SCHEMA | YES     | Performance Schema                                             | NO           | NO   | NO         |
| FEDERATED          | NO      | Federated MySQL storage engine                                 | NULL         | NULL | NULL       |
+--------------------+---------+----------------------------------------------------------------+--------------+------+------------+
9 rows in set (0.00 sec)

mysql> show plugins;
+-----------------------+----------+--------------------+---------+---------+
| Name                  | Status   | Type               | Library | License |
+-----------------------+----------+--------------------+---------+---------+
| binlog                | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| mysql_native_password | ACTIVE   | AUTHENTICATION     | NULL    | GPL     |
| mysql_old_password    | ACTIVE   | AUTHENTICATION     | NULL    | GPL     |
| MRG_MYISAM            | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| MyISAM                | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| MEMORY                | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| CSV                   | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| InnoDB                | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| INNODB_TRX            | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| INNODB_LOCKS          | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| INNODB_LOCK_WAITS     | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| INNODB_CMP            | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| INNODB_CMP_RESET      | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| INNODB_CMPMEM         | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| INNODB_CMPMEM_RESET   | ACTIVE   | INFORMATION SCHEMA | NULL    | GPL     |
| PERFORMANCE_SCHEMA    | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| BLACKHOLE             | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| FEDERATED             | DISABLED | STORAGE ENGINE     | NULL    | GPL     |
| ARCHIVE               | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
| partition             | ACTIVE   | STORAGE ENGINE     | NULL    | GPL     |
+-----------------------+----------+--------------------+---------+---------+
20 rows in set (0.00 sec)

プラグイン管理テーブルの内容を確認

「Duplicate entry」と言われているので、mysqlの管理DBのpluginテーブルの内容を確認してみましょう。

残骸が残っていますね。

mysql> select * from mysql.plugin;
+---------+---------------+
| name    | dl            |
+---------+---------------+
| mroonga | ha_mroonga.so |
+---------+---------------+
1 row in set (0.00 sec)

余計なデータを削除

SUPER権限があれば消せるので、さくっとDELETE文を発行します。

mysql> delete from mysql.plugin where name = 'mroonga';
Query OK, 1 row affected (0.00 sec)

プラグインの再登録

再度 INSTALL PLUGIN を掛けると、問題なく入ります。

mysql> INSTALL PLUGIN mroonga SONAME 'ha_mroonga.so'; CREATE FUNCTION last_insert_grn_id RETURNS INTEGER soname 'ha_mroonga.so'; 
Query OK, 0 rows affected (0.01 sec)

Query OK, 0 rows affected (0.00 sec)

インストール確認

無事、プラグインの登録に成功しました。

mysql> show engines;
+--------------------+---------+----------------------------------------------------------------+--------------+------+------------+
| Engine             | Support | Comment                                                        | Transactions | XA   | Savepoints |
+--------------------+---------+----------------------------------------------------------------+--------------+------+------------+
| MRG_MYISAM         | YES     | Collection of identical MyISAM tables                          | NO           | NO   | NO         |
| CSV                | YES     | CSV storage engine                                             | NO           | NO   | NO         |
| MyISAM             | YES     | MyISAM storage engine                                          | NO           | NO   | NO         |
| BLACKHOLE          | YES     | /dev/null storage engine (anything you write to it disappears) | NO           | NO   | NO         |
| MEMORY             | YES     | Hash based, stored in memory, useful for temporary tables      | NO           | NO   | NO         |
| InnoDB             | DEFAULT | Supports transactions, row-level locking, and foreign keys     | YES          | YES  | YES        |
| mroonga            | YES     | CJK-ready fulltext search, column store                        | NO           | NO   | NO         |
| PERFORMANCE_SCHEMA | YES     | Performance Schema                                             | NO           | NO   | NO         |
| FEDERATED          | NO      | Federated MySQL storage engine                                 | NULL         | NULL | NULL       |
| ARCHIVE            | YES     | Archive storage engine                                         | NO           | NO   | NO         |
+--------------------+---------+----------------------------------------------------------------+--------------+------+------------+
10 rows in set (0.00 sec)

最後に

mroonga-1.2.0へのアップグレード時にmysql-groongaのアンインストールを忘れても上記手順でリカバリ出来ますが、

groongaストレージエンジンで作成したテーブルのmysqldump及びdrop tableを忘れた場合はどうにもなりません。

該当テーブルは「unknown storage engine 'groonga'」となり、削除も参照も出来なくなります。

その場合には再度古いバージョンに戻して、mysqldumpとdrop tableを実行し、アップグレードを行う必要があります。


それでは、良いストレージプラグインライフをお過ごし下さい。

参考サイト

http://www.howtoforge.com/sphinx-as-mysql-storage-engine-sphinxse

RR 2012/02/17 09:27 Case.2についての解決方法を具体的に教えてもらえないでしょうか?(知識不足で・・・)

トラックバック - http://d.hatena.ne.jp/yoshi-ken/20120204
Connection: close