混沌のiPhone開発ブログ

データベースで各列に使うデータ型は主にint、real、charですが、それらをプログラム側とやり取りする時は以下のような感じになります。それぞれプログラム内の変数は
という場合です。

SQL文の?に埋め込む場合

データを取り出す場合

以前にSQL文がそのまま検索に使用できる時の流れは書いていますが、検索条件をプログラム内で変更したい場合も当然出てきます。その場合の方法です。説明のため、またKigenの一部ソースを引っ張ってきて手を加えています。

NSInteger level1 = 1;
sqlite3_stmt *st;
const char *sql2 = "SELECT pk FROM kigen WHERE level1=?";
if (sqlite3_prepare_v2(database, sql2, -1, &st, NULL) == SQLITE_OK) {

 作成の最終段階、実際のデータ入力です。ホームのファイルは前回のまま残っているものとします。

1. 前回と同様、ターミナルでsqlite3 test.sqlと入力しEnterを押します。
2. insert into namae(pk,name) values (1,'abc');と入力しEnterを押します。nameとして"abc"という値を持つ行が作られます。
3. 同様にinsert into namae(pk,name) values (2,'xyz');と入力しEnterを押します。さらに"xyz"という値を持つ行が作られました。
4. では確認してみましょう。select * from namae;と入力してEnterを押してください。これで２行のデータが表示されていれば、入力は成功しています。
5. .quitと入力しEnterを押して終了します。

ものすごく簡略化していますが、基本的なデータファイルの作成方法はこんな感じです。自分で使いたいデータベースの形によって、テーブルに含める列の数やデータ型等を工夫してみましょう。作成したデータファイルはホームから自分のプロジェクトフォルダにコピーして、プロジェクトのリソースにはXcode上で追加＞既存のファイル...で組み込みます。

ちなみに、上の例でpkに指定しているprimary keyというのは、各行で決して重複した値をとれないように制限を設ける設定です。上の例でもしxyzを入れるとき、pkを1にしていたらabcの行とかぶるのでエラーが出て入力できません。この設定は、データベース内のある行の値を変更したいという場合に利用できます。変更を行う場合、複数行を同時に変更するような命令は受け付けられません。そこで確実にデータベースの１行だけを狙い撃ちで指定できるprimary key設定された列があると便利なのです。なお複数行の変更は該当するpkのリストを作り、１行ずつ変更します。

 前回は何もしていないので、今度はテーブルを作成します。

1. 前回同様にターミナルを起動します。
2. 今度はsqlite3 test.sqlと入力してEnterを押します。test.sqlを作りたいことが伝わります。
3. create table namae(pk int primary key, name char);と入力してEnterを押します。これでnamaeという名称のテーブルが作られます。pk int primary keyで、テーブルに行ごとに別の整数を持つpkという名称の列を作ること、name charでnameという名称の文字列を格納する列を作ることを指示しています。データの型には他に浮動小数点型のrealなどがあります。
4. 確認のため、.tableと入力してEnterを押します。namaeと表示されていれば、テーブルが作られています。
5. 次に.schema namaeと入力してEnterを押します。namaeテーブルを作成した時の命令が表示されます。これでテーブル内の列にどのようなデータ型を指定したか確認できます。
6. 今回はここまで、ということで.quitと入力しEnterを押します。

ファイルはホームに作られています。Finderで確認してみてください。ファイルはテーブルを作った時点で作成されます。

 データベースファイルを作成する方法です。まずは基礎の基礎、SQLite3の起動と終了から。

1. Finderで場所からアプリケーションを選びます。
2. ユーティリティのターミナルを選びます。
3. sqlite3と入力しEnterを押します。SQLite Version 〜と表示されれば起動成功です。
4. .quitと入力しEnterを押すと終了します。
5. ターミナルを閉じます。

iPhone SDKがインストールされている環境なら追加でインストール等を行わなくてもSQLite3は起動するはずですが、念のための確認です。

データベースのファイルが作れたら、まずそれを開きます。以下の例はKigenのソースを元に解りやすいように一部を書き換えたものです。何をやっているかというと、カテゴリリスト画面のUITableViewに表示するデータを格納する配列の作成です。ファイルを開いて、検索して、次の検索ができるように解放するところまでで、ファイルを閉じるところは含まれていません。ファイルはプログラム自体が終了するところで閉じるからです。

// lv1はカテゴリ１行ごとのデータ(下に出てくるNamaeというデータクラス)を格納する配列で、
// 本当はクラス内で宣言しています
NSMutableArray *lv1;
// databeseはデータベースのポインタで、これも本当はクラス内で宣言してます NSString *path = [documentsDirectory stringByAppendingPathComponent:@"mydatabase.sql"];
// mydatabase.sqlに自分で用意するデータベースファイル名を入れてください
if (sqlite3_open([path UTF8String], &database) == SQLITE_OK) { } else {

SQLite3データベースの開き方はアップル提供のサンプルSQLite Book Listが参考になります。AppDelegate.mにあるcreateEditableCopyOfDatabaseIfNeededをそのまま再利用することができます。ファイル名を自分がリソースとして加えたデータベースファイルのものに変更するだけです。これでまずデータベースファイルが必ず存在する状態(発見できなければ作成する)にします。

実際にデータベースを開いてSQL文でデータを取り出す操作はinitializeDatabaseが参考になります。基本的な流れとしては、まずファイルをsqlite3_open関数で開いたあと、SQL文を作り、それを準備用の関数に渡します。文の中に変数(”?”と表記した部分)がある場合は、そこの部分に実際の変数を埋め込みます。そして実際に検索を行います。データベースに検索条件に一致するデータがあった場合には、それを順番に読み出します。データの読み出しが終わったらSQL文をデータベースから解放します。

データベースファイルを最終的に閉じる方法はapplicationWillTerminateにあるように、sqlite3_close関数を実行します。ファイルを開いたときと閉じたとき、問題が無い場合はSQLITE_OKが返ってきます。

2008.12.8追記
SQLite Book ListのcreateEditableCopyOfDatabaseIfNeededでやっているのは、ユーザーのデータ用フォルダにファイルが無い場合にリソースのSQLファイルをコピーする動作でした。初回の起動時に行われるだけで、既にユーザーデータがある場合はコピーをしません。そのため、バージョンアップを行ってもユーザーが作ったデータにサンプルデータを上書きしてしまう、というような事態は避けられるようになっています。

 自分のプログラムでSQLite3を使うには、Frameworksの項目に

libsqlite3.0.dylib

を既存のファイルを追加で加えておきます。場所はフルパスで

/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS2.1.sdk/usr/lib/libsqlite3.0.dylib

です。実際に命令を行うmファイルに対応したhファイルの頭の部分に

#import <sqlite3.h>

を加えておきます。

2010年1月31日追記：
現在のiPhone SDK 3.1.2では自分でsqlite3データベースを開く以外に、Core Dataを利用して間接的にsqlite3を利用する方法もあります。他の環境で製作したデータベースファイルを持ってくる、といった用途には向きませんが、テーブル同士で連携をさせる場合などは、Xcodeのモデルエディタを用いてグラフィカルなデータベース構築が行えるなどの利点があります。Core Dataについては初めてのCore Data on iPhone（混沌のiPhoneアプリケーション工房、プログラミング内）にて簡単な解説をしていますので、そちらも参考にしてください。