devkuma – SQLite

SQLite | SQLite のインストール

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite はデータベースサーバーを使わず、データベースごとに1つのファイルで管理します。データベースサーバーを使わないため、サーバーとして常時起動しておく別のアプリケーションはありません。コマンドラインから使うには、別途コマンドラインインターフェイスのプログラムを使用します。PHP や Ruby on Rails などから使用する場合は DLL が必要です。ここでは、SQLite のコマンドラインプログラムと DLL をダウンロードしてインストールする方法について説明します。

SQLite | SQLite のインストール | SQLite コマンドラインツールのダウンロードとインストール

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite をコマンドラインから使用するための、コマンドラインプログラムのダウンロード方法とインストール方法について説明します。2019年10月時点の最新バージョンは SQLite 3.30.1 (2019-10-11) です。

SQLite のダウンロード

ブラウザで SQLite の公式ページにアクセスします。

https://www.sqlite.org/

画面上部のメニューから「Download」と書かれたメニューをクリックします。

使用している OS に合ったツールのバイナリ、たとえば sqlite-tools-xxx のようなファイル名のファイルをクリックしてダウンロードし、任意の場所に保存します。

SQLite コマンドラインプログラムのインストール

ダウンロードしたファイルは圧縮ファイルです。任意のディレクトリに展開するだけでインストールは完了です。

$ ls -al
total 5016
drwxr-xr-x@  5 kimkc  staff      170 10 11 18:32 .
drwxr-xr-x  41 kimkc  staff     1394 10 14 23:41 ..
-rwxr-xr-x@  1 kimkc  staff   691768 10 11 18:31 sqldiff
-rwxr-xr-x@  1 kimkc  staff  1152260 10 11 18:32 sqlite3
-rwxr-xr-x@  1 kimkc  staff   719796 10 11 18:31 sqlite3_analyzer

圧縮ファイルには、コマンドラインツールである sqlite3、2つのデータベースの差分を確認できる sqldiff、データベース分析レポートを表示できる sqlite3_analyzer の3つのファイルが含まれています。

SQLite | SQLite のインストール | SQLite コマンドラインツールのテスト

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

ダウンロードした SQLite コマンドラインツールを実際に使い、動作するか確認してみます。

コマンドラインツールでデータベースとテーブルを作成する

まず、コマンドプロンプトを起動します。PATH は別途設定していないため、sqlite3 実行ファイルがあるディレクトリへ移動します。

データベースを作成してみましょう。コマンドラインツールを使ってデータベースを作成するには、次の形式を使用します。

sqlite3 データベース名

データベース名を指定して sqlite3 プログラムを実行すると、指定した名前のデータベースがすでに存在する場合はそのデータベースに接続し、存在しない場合は新しいデータベースを作成してから接続します。

データベース名は何でも構いませんが、指定したデータベース名でファイルが作成されます。たとえば sampledb.sqlite3 や sampledb.db などです。拡張子なしで sampledb としても問題ありません。ここでは sample.sqlite3 とします。

sqlite3 sample.sqlite3

$ sqlite3 sample.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite>

sample.sqlite3 というデータベースが新しく作成され、データベースに接続されました。ただし、実際にファイルが作成されるのは、データベース内にテーブルなどを作成したときです。SQLite に接続している間は、sqlite> プロンプトが表示されます。

次に、データベース内にテーブルを1つ作成してみます。次のように実行します。

create table user(id, name);

$ sqlite3 sample.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> create table user(id, name);
sqlite>

テーブルが作成されました。今回はデータベースを作成し、そのデータベース内にテーブルを作成しました。

データベースとの接続を終了するには、.exit と入力します。

.exit

$ sqlite3 sample.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> create table user(id, name);
sqlite> .exit

データベースとの接続が切断されました。

データベースが保存されるファイル

データベースを作成したあと、テーブルなどを作成するとデータベースファイルに保存されます。作成場所を別途指定していないため、sqlite3 実行ファイルがあるディレクトリにデータベースファイルが作成されています。

$ ls
sample.sqlite3   sqldiff          sqlite3          sqlite3_analyzer

sample.sqlite3 というファイルが新しく作成されていることがわかります。このファイルには、先ほど作成した sample.sqlite3 データベースのデータが保存されています。このように SQLite は、データベースごとに1つのファイルを作成して管理します。ただし、場合によっては複数のファイルを使用することもあります。

SQLite | SQLite のインストール | sqlite3.dll のダウンロード

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite はコマンドラインから使用することもできますが、PHP や Rails など、ほかのアプリケーションから使用されることのほうが多くあります。アプリケーションから使用するには sqlite3.dll が必要です。ここでは、sqlite3.dll ファイルをダウンロードする方法について説明します。

sqlite3.dll のダウンロード

sqlite3.dll をダウンロードするには、次の URL にアクセスします。

https://www.sqlite.org/download.html

ブラウザで SQLite の公式ページにアクセスします。

Windows 64bit 環境の場合は、「Precompiled Binaries for Windows」ブロックにある sqlite-dll-win64-x64-3300100.zip というリンクをクリックしてダウンロードし、任意の場所に保存します。

sqlite3.dll を PATH が設定されたフォルダにコピーする

ダウンロードして保存した sqlite-dll-win64-x64-3300100.zip 圧縮ファイルを展開すると、sqlite3.dll と sqlite3.def の2つのファイルが出てきます。このうち sqlite3.dll ファイルを、PATH が設定されたフォルダに保存します。たとえば C:\Windows\System32 に入れても構いません。

sqlite3.def sqlite3.dll

実際には、PHP をインストールすると SQLite を使用するために必要な DLL も一緒にインストールされています。そのため、必ずしも別途ダウンロードする必要はありません。

SQLite

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

ここでは、データベース SQLite の使い方について説明します。SQLite はデータベースサーバーとしてではなく、主に1つのアプリケーション内で動作します。インストールが簡単で非常にコンパクトなため、アプリケーションと一緒に配布されることも多くあります。ここでは、SQLite を使ってデータベースやテーブルを作成する方法、データを追加または検索する方法を順に説明します。

SQLite | SQLite のインストール | SQLite ドキュメントの参照

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite のドキュメントを参照する方法について説明します。インターネット上で閲覧できるほか、ダウンロードして参照することもできます。

オンラインドキュメントを参照する

オンラインドキュメントを参照するには、SQLite 公式ページ上部のメニューから「Documentation」をクリックするか、次のリンクを開きます。

https://www.sqlite.org/docs.html

たとえば、「Programming Interfaces」を展開して「SQL Syntax」メニューをクリックします。

SQLite で利用できる SQL についての説明を確認できます。

このほかにも、SQLite に関するさまざまなドキュメントを参照できます。

ドキュメントをダウンロードする

ドキュメントをローカルにダウンロードしたい場合は、画面上部の「Download」と書かれたメニューをクリックするか、次のリンクを開きます。

https://www.sqlite.org/download.html

「Documentation」ブロックにある「sqlite-doc-3300100.zip」リンクをクリックすると、ドキュメントをダウンロードできます。

ダウンロードが完了したら、圧縮ファイルを展開します。次のように多数の HTML ファイルが表示されます。

ここで index.html ファイルを探して開いてみましょう。

インターネット上の公式サイトで見たページと同じ画面が表示されます。画面上部の「Documentation」メニューをクリックすると、オフラインでもドキュメントを参照できるようになります。

SQLite | SQLite の基礎知識

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite を利用するうえで知っておきたい基礎知識について説明します。

SQLite | SQLite の基礎知識 | コマンドラインツールで SQL 文とコマンドを入力する方法

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite では、コマンドラインツールを使ってデータベースを作成したり、データを検索したりできます。ここでは、SQLite コマンドラインツールを使用するときに、どのように入力すればよいかを説明します。

コマンドを実行する

SQLite コマンドラインツールを実行するには、コマンドプロンプトを起動したあと、sqlite3 をインストールしたディレクトリへ移動し、次のように実行します。ツールが起動し、引数に指定したデータベースに接続します。

sqlite3 データベース名

今回は、以前作成した sample.sqlite3 データベースに接続するため、次のように実行します。以前作成したファイルを削除していたり、存在しなかったりしても接続コマンド自体は実行できます。

$ sqlite3 sample.sqlite3 
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite>

コマンドラインツールでは、コマンドラインツールの設定を行う SQLite コマンドなどを実行したり、任意の SQL 文を実行したりできます。

SQLite コマンド .show を実行してみましょう。コマンドは、必要に応じて引数を入力し、Enter キーを押すと実行されます。

$ sqlite3 sample.sqlite3 
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> .show
        echo: off
         eqp: off
     explain: auto
     headers: off
        mode: list
   nullvalue: ""
      output: stdout
colseparator: "|"
rowseparator: "\n"
       stats: off
       width: 
    filename: sample.sqlite3
sqlite>

SQL 文を実行する

次に、簡単な SQL 文を実行してみます。SQL 文の場合、最後にセミコロン (;) を入力するまでが1つの SQL 文として処理されます。; まで入力したあと Enter キーを押すと実行されます。

sqlite> create table user(id, name);
sqlite> insert into user(id, name) values (1, 'devkuma');
sqlite> insert into user(id, name) values (2, 'araikuma');
sqlite> select * from user;
1|devkuma
2|araikuma
sqlite>

以前作成した user テーブルがすでに存在する場合、最初の行は実行しなくてもかまいません。

長い SQL 文を分割して入力する

SQL 文では、1つの文が長くなることがあります。すべての文を一度に入力しようとすると、入力しづらかったり、どこまで入力したのかわかりにくかったりする場合があります。

sqlite> select id as user_id, name as user_name from user where id = 1 and name = 'devkuma' order by name desc;
1|devkuma
sqlite>

このように長い場合、コマンドラインツールでは分割して入力することもできます。入力途中で Enter キーを押します。

sqlite> select id as user_id, name as user_name 
   ...>

SQL 文は、最後に ; が現れるまでが1つの文として判断されます。; が入力されていない状態で Enter キーを押した場合、まだ入力途中だと判断され、続けて入力できます。

それでは残りをすべて入力してみましょう。先ほどと同じように、適切なタイミングで Enter キーを押します。

sqlite> select id as user_id, name as user_name 
   ...> from user
   ...> where id = 1 and name = 'devkuma'
   ...> order by name desc
   ...>

Enter キーを押すときに、空白を1つ入れておく必要はありません。コマンドの途中で Enter キーを押すと、前後の文は自動的に別の単語として処理されます。

SQL 文の場合、; を含む行を入力して Enter キーを押した時点で、文の入力が完了したと判断され、SQL 文が実行されます。

sqlite> select id as user_id, name as user_name 
   ...> from user
   ...> where id = 1 and name = 'devkuma'
   ...> order by name desc
   ...> ;
1|devkuma
sqlite>

文を1行で入力した場合も、分割して入力した場合も、結果は同じです。状況に応じて使い分けてください。

–

ここまで、SQLite コマンドラインツールでコマンドや SQL 文をどのように入力するかについて説明しました。

SQLite | SQLite の基礎知識 | SQLite で定義されているキーワードの注意点

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite には多くのキーワードが定義されています。これらのキーワードは通常、テーブル名やカラム名などには使用できませんが、適切な書き方をすれば使用できる場合もあります。ここでは、SQLite で定義されているキーワードの注意点とキーワード一覧について説明します。

キーワードを識別子として使用する方法

SQLite には多くのキーワードが定義されています。後ほど一覧を示しますが、TABLE や SELECT などの単語はキーワードです。キーワードは予約語とも呼ばれます。

テーブル名やデータベース名は識別子と呼ばれます。識別子は、アルファベットや数字などを組み合わせて指定できます。たとえば、booktable や name などは使用できます。ただし、SQLite のキーワードはそのまま識別子として使用できません。たとえば、select をテーブル名として使用しようとするとエラーが発生します。

create table select(id, name);

sqlite> create table select(id, name);
Error: near "select": syntax error
sqlite>

キーワードをテーブル名やデータベース名などに使用することは、できるだけ避けたほうがよいでしょう。ただし、何らかの理由でキーワードを識別子として使用する必要がある場合は、次の4つの方法のいずれかを使用します。

'keyword'
"keyword"
[keyword]
`keyword`

キーワードをシングルクォート (') で囲むと文字列値として処理されます。識別子を書くべき場所にシングルクォートで囲んだ文字列値を書くと識別子として処理されるため、次のように指定できます。

create table 'select'(id, name);

sqlite> create table 'select'(id, name);
sqlite>

キーワードをダブルクォート (")、角括弧 ([])、バッククォート (`) で囲んだ場合は識別子として処理されます。また、文字列を書くべき場所にダブルクォートで囲んだ識別子を書くと文字列として処理されます。

create table "select"(id, name);

sqlite> create table "select"(id, name);
Error: table "select" already exists
sqlite> drop table 'select';
sqlite> create table "select"(id, name);
sqlite>

角括弧は Access や SQL Server で使用される方式で、バッククォートは MySQL で使用される方式です。この2つの方式は、それぞれのデータベースとの互換性のために用意されています。そのため、通常はシングルクォートまたはダブルクォートを使用します。

キーワード一覧

SQLite のキーワードとして定義されているものを以下に示します。これは次の公式サイトに掲載されています。

SQLite Keywords

ABORT	ACTION	ADD	AFTER	ALL
ALTER	ANALYZE	AND	AS	ASC
ATTACH	AUTOINCREMENT	BEFORE	BEGIN	BETWEEN
BY	CASCADE	CASE	CAST	CHECK
COLLATE	COLUMN	COMMIT	CONFLICT	CONSTRAINT
CREATE	CROSS	CURRENT	CURRENT_DATE	CURRENT_TIME
CURRENT_TIMESTAMP	DATABASE	DEFAULT	DEFERRABLE	DEFERRED
DELETE	DESC	DETACH	DISTINCT	DO
DROP	EACH	ELSE	END	ESCAPE
EXCEPT	EXCLUSIVE	EXISTS	EXPLAIN	FAIL
FILTER	FOLLOWING	FOR	FOREIGN	FROM
FULL	GLOB	GROUP	HAVING	IF
IGNORE	IMMEDIATE	IN	INDEX	INDEXED
INITIALLY	INNER	INSERT	INSTEAD	INTERSECT
INTO	IS	ISNULL	JOIN	KEY
LEFT	LIKE	LIMIT	MATCH	NATURAL
NO	NOT	NOTHING	NOTNULL	NULL
OF	OFFSET	ON	OR	ORDER
OUTER	OVER	PARTITION	PLAN	PRAGMA
PRECEDING	PRIMARY	QUERY	RAISE	RANGE RECURSIVE
REFERENCES	REGEXP	REINDEX	RELEASE	RENAME
REPLACE	RESTRICT	RIGHT	ROLLBACK	ROW
ROWS	SAVEPOINT	SELECT	SET	TABLE
TEMP	TEMPORARY	THEN	TO	TRANSACTION
TRIGGER	UNBOUNDED	UNION	UNIQUE	UPDATE
USING	VACUUM	VALUES	VIEW	VIRTUAL
WHEN	WHERE	WINDOW	WITH	WITHOUT

これらのキーワードの中には、シングルクォートやダブルクォートなどで囲まなくても識別子として使用できるものもあります。ただし、キーワードをそのまま識別子として使用するとわかりにくくなるため、あまり望ましい方法ではありません。

テーブルなどを作成するときに原因不明のエラーが発生した場合は、テーブル名やカラム名がキーワードになっていないか確認してみてください。

SQLite | SQLite の基礎知識 | SQL 文にコメントを書く

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQL 文にコメントを構成する形式について説明します。

コメントを書く

SQL 文に何らかの意見や説明を残したい場合など、SQLite で SQL 文にコメントを追加するには次の2つの方法があります。

-- コメント

/* コメント */

コメントが書かれていても、SQL 文を実行するときには無視されるため、実行結果には影響しません。

-- コメント 形式でコメントを書く場合、-- から行末までに書かれた文字列がコメントになります。たとえば、次のように書きます。

select * from user; -- 一覧

sqlite> select * from user; -- 一覧
1|devkuma
2|araikuma
sqlite>

/* コメント */ のような形式でコメントを書く場合、/* から */ までに書かれた文字列がコメントになります。

select * from /* コメント */ user;

sqlite> select * from /* コメント */ user;
1|devkuma
2|araikuma
sqlite>

コマンドラインツールでコメントを書く機会はそれほど多くないかもしれませんが、複数の SQL 文を外部ファイルに書いておき、それを取り込んで SQLite で実行する場合には、コメントを書いておくとよいでしょう。

SQLite | データベース

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite3 を使ってデータベースを作成する方法と、作成したデータベースを削除する方法について説明します。

SQLite | データベース | データベースの作成と接続

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite データベースを新しく作成する方法と、作成済みのデータベースに接続する方法について説明します。

データベースの作成

データベースを新しく作成するには、コマンドプロンプトで次のように入力します。

sqlite3 データベース名

たとえば、myfriend.sqlite3 というデータベースを作成するとします。コマンドプロンプトを起動し、sqlite3 ファイルがあるディレクトリへ移動してから、次のように実行します。

$ sqlite3 myfriend.sqlite3

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite>

myfriend.sqlite3 データベースが存在しない場合、新しいデータベース myfriend.sqlite3 が作成され、作成されたデータベースへそのまま接続されます。

データベースに接続された状態なので、テーブルなどをデータベース内に作成できます。何も作成しないとデータベースファイルは実際には作成されないため、ここでは簡単なテーブルを作成してみます。テーブルを作成する詳しい方法は別のページで説明します。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> create table customer (id, name);
$

コマンドラインツールを終了するには .exit と入力します。これで接続中のデータベースから切断されます。

.exit

実際に確認してみましょう。まず myfriend.sqlite3 データベースに接続し、.exit を入力します。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite>.exit
$

次に、sqlite3 が作成したデータベースファイルを確認します。

$ ls
myfriend.sqlite3 sample.sqlite3   sqldiff          sqlite3          sqlite3_analyzer

データベース名として指定した名前と同じ名前のファイルが作成されています。SQLite では、このようにデータベースを作成すると同じ名前のファイルが作成され、データベースに含まれるすべてのデータがこのファイルに保存されます。

また、sqlite3 ファイルがあるディレクトリ以外の場所にデータベースファイルを作成したい場合は、次のようにパスと一緒に指定します。

sqlite3 パス/データベース名

たとえば、絶対パス /Users/devkuma/sqlite/test ディレクトリに sample.sqlite3 データベースを作成するには、次のように実行します。

$ sqlite3 /Users/devkuma/sqlite/test/sample.sqlite3

データベース名について

データベース名には任意の名前を指定できます。先ほどは myfriend.sqlite3 と指定しましたが、どのような形式でもかまいません。

myfriend
myfriend.db
myfriend.sqlite
myfriend.sqlite3

データベースを作成すると、SQLite はデータベース名と同じ名前のファイルを作成してデータを保存します。たとえばデータベース名が myfriend の場合、作成されるファイル名も myfriend となり、拡張子のないファイルが作成されるため、後から見たときに何のファイルなのか分かりにくくなります。

そのため、データベース名を決めるときは、データベースが保存されるファイル名も考慮して指定するとよいでしょう。一般的にどの拡張子が使われるかはいくつかありますが、ここでは .sqlite3 拡張子に統一します。

データベースへの接続

データベースに対してさまざまな操作を行うには、まずデータベースに接続する必要があります。新規データベースを作成した場合は作成と同時に接続されますが、すでに作成済みのデータベースに接続するには、コマンドプロンプトで次のように入力します。

sqlite3 データベース名

見て分かるように、新しいデータベースを作成するときと同じ形式です。引数にすでに存在するデータベース名を指定すると、新しいデータベースは作成されず、引数に指定したデータベースに接続されます。

それでは、先ほど作成した myfriend.sqlite3 データベースに接続してみましょう。コマンドプロンプトを起動し、sqlite3 があるディレクトリへ移動してから、次のように実行します。

$ sqlite3 myfriend.sqlite3

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite>

新しいデータベースが作成されたのではなく、既存のデータベースに接続されていることを確認するため、既存のデータベースに作成したテーブルを .tables コマンドで確認します。

.tables

実際に確認してみましょう。まず myfriend.sqlite3 データベースに接続し、.tables を入力します。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> .tables
customer
sqlite>

customer テーブルが作成されていることを確認できます。このように、新しいデータベースを作成する場合と既存のデータベースに接続する場合は、同じコマンドと同じ形式を使うため注意してください。

SQLite | データベース | 接続中のデータベースを確認する

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite で現在接続しているデータベースと、そのデータベースが保存されているファイル名の情報を確認する方法について説明します。

接続中のデータベースの情報

データベースに接続しているとき、現在接続しているデータベース名と、データベースが保存されているファイル名を確認するには、SQLite コマンド .databases を使用します。

.databases

実際に確認してみましょう。まず myfriend.sqlite3 データベースに接続し、.databases を入力します。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> .databases
main: /Users/devkuma/sqlite/myfriend.sqlite3
sqlite>

次のように画面に表示されました。

main がデータベース名です。そして /Users/devkuma/sqlite/myfriend.sqlite3 がデータベースを保存しているファイル名です。

データベース名と言うと分かりにくいかもしれませんが、main はテーブル名やカラム名と同じように、SQL 文でデータベース名を指定する必要がある場合に使われる名前です。sqlite3 データベース名 で接続したデータベースには、自動的に main というデータベース名が指定されます。つまり、データベース名が main の項目が接続中のデータベースです。

この main という名前は気になるかもしれませんが、今は無視してかまいません。詳しい説明はここでは行いませんが、接続されたデータベースがある場合、.databases コマンドを実行すると同じように一覧へ表示されます。表示されるデータベース名は、接続時に指定した名前です。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> 
sqlite> attach database 'myaddress.sqlite3' as address;
sqlite> 
main: /Users/devkuma/sqlite/myfriend.sqlite3
address: /Users/devkuma/sqlite/myaddress.sqlite3
sqlite>

このように .databases コマンドを使用すると、現在接続されているデータベースの情報を確認できます。

SQLite | データベース | データベースのバックアップと削除

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite で作成したデータベースファイルをコピーしてバックアップする方法と、データベースを削除する方法について説明します。

データベースのバックアップ

SQLite ではデータベースごとに1つのファイルを作成し、すべての情報はそのファイルに保存されます。そのため、特定のデータベースをバックアップするには、そのデータベースが使用しているファイルを単純にコピーすればよいです。

実際に確認してみましょう。現在 myfriend.sqlite3 データベースが作成されているものとして、このデータベースに接続します。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite>

.tables コマンドを実行してデータベースに作成されているテーブルを確認すると、customer というテーブルが作成されています。

$ sqlite3 myfriend.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> .tables
customer
sqlite>

それではデータベースとの接続を切断します。そして myfriend.sqlite3 ファイルをコピーし、別名の myfriendbackup.sqlite3 として保存します。ファイル名は任意です。

$ cp myfriend.sqlite3 myfriendbackup.sqlite3

これで既存のデータベースと同じデータベースが作成されました。次に、バックアップとして作成した myfriendbackup.sqlite3 データベースに接続し、.tables コマンドを実行してデータベースに作成されているテーブル一覧を表示してみます。

$ sqlite3 myfriendbackup.sqlite3
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> .tables
customer
sqlite>

既存のデータベースと同じテーブルが作成されていることを確認できます。簡単な確認だけですが、データベースが複製されていることが分かります。このように SQLite では、データベースのデータが含まれるファイルをコピーするだけでバックアップできます。

この方法だけでなく、バックアップを行う方法として .backup コマンドと .restore コマンドを使用する「バックアップと復元」も用意されています。

データベースの削除

SQLite ではデータベースごとに1つのファイルとして独立して管理しているため、データベースを削除するには、データベースを保存しているファイルを削除します。SQLite 側で別途行うことはありません。

SQLite | データベース | 空き領域の整理 (VACUUM)

kc@example.com (kc kim) — Mon, 14 Oct 2019 23:19:51 +0900

SQLite データベースでデータの追加や削除を繰り返していると、保存されているデータ量に比べてファイルサイズが大きくなることがあります。ここでは、VACUUM 文を使用して未使用領域を回収する方法について説明します。

VACUUM の使用

SQLite データベースを作成すると1つのファイルが作成され、テーブルや保存されたデータはそのファイルに保存されます。テーブルにデータを追加していくとデータベースファイルのサイズも少しずつ大きくなりますが、テーブルからデータを削除しても、データベースファイルのサイズはすぐには小さくなりません。ファイル内で使用されていた領域はすぐに削除されるのではなく、次にデータが追加されたときに再利用するために残されるためです。

通常は気にする必要はありませんが、ファイルサイズが気になる場合は、VACUUM 文を実行して未使用領域を回収し、ファイルサイズを小さくできます。

VACUUM 文は次のように実行します。

VACUUM;

VACUUM 文を実行すると、データベースの内容を一度一時データベースへ移し、その後で戻す処理が行われます。これにより空き領域をなくし、データを順番に保存し直して整理します。

注意点として、VACUUM の対象になるのは main データベースだけです。接続されたデータベースは VACUUM の対象になりません。また、INTEGER PRIMARY KEY が設定されたカラムがないテーブルの場合、保存されているデータに割り当てられた ROWID は変更されることがあります。

実習

それでは実習してみます。次のように、データベースのファイルサイズが 16,384 バイトの sample.sqlite3 ファイルがあります。

$ ls -al
total 5048
drwxr-xr-x@ 7 kimkc  staff      238 10 19 23:20 .
drwxr-xr-x  9 kimkc  staff      306 10 17 23:49 ..
drwxr-xr-x  6 kimkc  staff      204 10 19 23:20 bak
-rw-r--r--  1 kimkc  staff    16384 10 19 23:20 sample.sqlite3
-rwxr-xr-x@ 1 kimkc  staff   691768 10 11 18:31 sqldiff
-rwxr-xr-x@ 1 kimkc  staff  1152260 10 11 18:32 sqlite3
-rwxr-xr-x@ 1 kimkc  staff   719796 10 11 18:31 sqlite3_analyzer

データベースに接続し、データベース内にあるテーブルを1つ削除します。

$ sqlite3 sample.sqlite3 
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> .tables
select    user      username
sqlite> drop table user;
sqlite>

テーブルを削除してからデータベースのファイルサイズを確認すると、削除前と変わらず 16,384 バイトのままです。

$ ls -al
total 5048
drwxr-xr-x@ 7 kimkc  staff      238 10 19 23:24 .
drwxr-xr-x  9 kimkc  staff      306 10 17 23:49 ..
drwxr-xr-x  6 kimkc  staff      204 10 19 23:20 bak
-rw-r--r--  1 kimkc  staff    16384 10 19 23:24 sample.sqlite3
-rwxr-xr-x@ 1 kimkc  staff   691768 10 11 18:31 sqldiff
-rwxr-xr-x@ 1 kimkc  staff  1152260 10 11 18:32 sqlite3
-rwxr-xr-x@ 1 kimkc  staff   719796 10 11 18:31 sqlite3_analyzer

このように、テーブルやデータを削除しても、すぐにデータベースのファイルサイズが小さくなるわけではありません。それでは、データベースに再度接続して VACUUM 文を実行してみましょう。

$ sqlite3 sample.sqlite3 
SQLite version 3.19.3 2017-06-27 16:48:08
Enter ".help" for usage hints.
sqlite> vacuum;
sqlite>

VACUUM 文を実行した後にデータベースのファイルサイズを確認すると、12,288 バイトに小さくなっていることが分かります。

$ ls -al
total 5040
drwxr-xr-x@ 7 kimkc  staff      238 10 19 23:29 .
drwxr-xr-x  9 kimkc  staff      306 10 17 23:49 ..
drwxr-xr-x  6 kimkc  staff      204 10 19 23:20 bak
-rw-r--r--  1 kimkc  staff    12288 10 19 23:29 sample.sqlite3
-rwxr-xr-x@ 1 kimkc  staff   691768 10 11 18:31 sqldiff
-rwxr-xr-x@ 1 kimkc  staff  1152260 10 11 18:32 sqlite3
-rwxr-xr-x@ 1 kimkc  staff   719796 10 11 18:31 sqlite3_analyzer
kimkcui-MacBook-Pro:sqlite-tools-osx-x86-3300100 kimkc$

このように VACUUM を実行すると、未使用領域を回収してファイルサイズを小さくできます。ファイルサイズが気になる場合は VACUUM を実行しましょう。