Error database disk image is malformed sqlite の解決方法

このドキュメントの内容は、以下の通りです。

• はじめに
• MediaWikiとリレーショナルデータベースの関係
• database disk image is malformed sqlite との遭遇
• 日本語の意味は？
• 直すための試行錯誤
• 解決方法
• 解決方法２
• 注意事項
• 予防措置

はじめに

SQLiteとは、エスキューライトと読みます。 SQLiteは、ファイルベースのコンパクトで軽量なリレーショナルデータベースエンジンです。オラクルやMySQL/MariaDBといったメジャーのリレーショナルデータベースがありますが、それらは、データベースサービスのプログラムが必要です。 SQLiteは、 Mysqlサーバなどのサーバプロセスを必要としません。プログラムからSQLiteのライブラリを通して、直接、データベースのファイルを読み書きします。

MediaWiki のデータベースに使っている、 SQLite でエラーが発生しました。SQLiteのデータベースが壊れた、と思いました。データベースが壊れたときに、データベースを修復するために、いろいろ試そうとされると思いますが、何かする前に、データベースのファイルのバックアップをとっておくことをお勧めします。修理をするために、いろいろ試しているうちに、自分で破壊してしまうこともあると思います。バックアップは非常に大事だと思います。

また、このようなエラーと遭遇する前に、バックアップをとっておくべき、ということを付け加えておきます。

MediaWikiとリレーショナルデータベースの関係

MediaWikiとは、WikiPedia でも採用されている Wikiのエンジンです。MediaWikiは、オープンソースソフトウェアの１つです。

MediaWikiを利用して、 Wiki(ウィキ) を作成しています。 MediaWikiでは、書き込まれたデータを管理するために、リレーショナルデータベースを利用します。たとえば、データの書き込み先に MySQL を利用することができます。いろいろなリレーショナルデータベースを利用でき、その１つに SQLiteもあります。

database disk image is malformed sqlite との遭遇

MediaWikiの SQLiteのデータベースにアクセスしたときに、

database disk image is malformed sqlite

というエラーが発生しました。

データベースにアクセスが完全にできないわけではないのですが、特定のテーブルにアクセスしようとすると、上記のエラーが出ました。

日本語の意味は？

そもそも、このメッセージの意味はなんでしょうか？それとなく、データベースディスクイメージがおかしいよ、という風に見えますね。

database disk image is malformed sqlite

Google翻訳さんに日本語の意味を教えてもらいました。

データベースのディスクイメージが不正な形式のsqliteです

要するに、SQLite のデータベースディスク・ファイルが壊れているようです。

直すための試行錯誤

最初にも書きましたが、いろいろ試行錯誤する前に、SQLiteのデータベースファイルのバックアップをとっておくようにしてください。バックアップがない場合、データベースの中身やデータベースのファイルを破壊してしまうと、元の状態に戻すのは難しいでしょう。

SQLiteには、 PRAGMA integrity_check があります。 英単語のintegrityというのは、完全性といった意味ですが、 integrity check は、整合性チェックということのようです。
SQLiteで pragma integrity_check を実行して、完全性/整合性のチェックをしてみると、エラーが出てきました。 integrity check は、問題がなければ、 OK が返ってきます。

解決方法

やり方は、一度、データベースをダンプして、それから新しいデータベースにインポートします。

まずは、sqlite コマンドを利用して、データベースファイルを開き、以下の命令を利用して、データベースをダンプします。

sqlite dbname
sqlite> .mode insert
sqlite> .output db.sql
sqlite> .dump
sqlite> .exit

sqliteコマンドを利用して、新しいデータベースを作ります。ここでは sqlite3 を利用しました。

sqlite3 newfile < db.sql

そして、データベースを入れ替えます。
これは、古いファイル(1)を別のファイル名(2)にして、バックアップとしてとっておきます。新しいファイルを「古いファイル(1)」にします。

mv dbname old
mv newfile dbname

解決方法２

もう少し簡単な方法は、以下のコマンドです。このやり方のほうが、新しいファイルを簡単に作成できます。

sqlite3 dbname .dump | sqlite3 newfile
mv dbname old
mv newfile dbname

注意事項

しかしながら、必ずしも、うまくいくわけでもないようです。
500MB ほどある データベースファイルをダンプしたところ、 10MB のファイルができました。
おそらく、途中までしか読めなかったのではないでしょうか。

予防措置

日頃からデータベースのバックアップは、きちんと とっておいたほうがいいでしょう。データが壊れてからでは、何もできません。また、バックアップから元に戻せることも、確認しておくべきです。バックアップをとってあるから大丈夫と思っていても、ちゃんとバックアップがとれているかどうかは、確認してみないとわかりません。また、バックアップを戻すときには、試験環境を作ってやることをお勧めします。間違った手順で、本番の環境を破壊してしますと困ります。

---