groongaやmroongaを実際に使っていて、記事を書いてもいいよ、という人を募集しています。
すでに数名の方からご応募いただいていますが、まだまだ募集中です。
詳細はgroonga普及のための協力のお願いを参照してください。

はじめに

オープンソースのカラムストア機能付き全文検索エンジンgroongaを公開しています。
この記事を書いたときの最新のバージョンは2013年2月28日にリリースした3.0.1です。

前回は、loadコマンドを使って特定のカラムを更新する方法を紹介しました。また、その中で定義したテーブルにデータを登録する方法も紹介しました。
そこで、今回は逆にgroongaのテーブルからレコードを削除する方法を紹介します。データを投入していって、不要になったレコードを削除したくなったときに使えます。

groongaにはレコードを削除する方法が次の3つあります。

主キーやIDを指定する
削除したいレコードの条件を指定する
テーブルに登録されたレコードすべてを削除する

最初に実際にレコードの削除を試すためのサンプルを示します。次に、それぞれの削除方法について簡単に紹介します。

サンプルのスキーマとデータ

以下はサンプルとして使うテーブルのスキーマです。

table_remove Books
table_create Books TABLE_HASH_KEY UInt32
column_create Books title COLUMN_SCALAR ShortText
column_create Books price COLUMN_SCALAR Int32

Booksというテーブルを作成し、本のタイトルを格納するtitleカラムと、値段を格納するpriceカラムを定義しました。
このテーブルに、前回も紹介したloadコマンドでデータを登録します。

load --table Books
[
{"_key":1, "title":"Head First Groonga", "price": 3400},
{"_key":2, "title":"Head First Mroonga", "price": 2800},
{"_key":3, "title":"Groonga command manual", "price": 1000},
{"_key":4, "title":"Head First Rroonga", "price": 2000},
{"_key":5, "title":"Mroonga manual", "price": 2500}
]

正しく登録できたかを、次のselectコマンドで確認します。

select Books --output_columns _key,title,price

上記コマンドの --output_columns _key,title,price というのは表示するカラムを指定する引数です。
上のコマンドを実行した結果を見やすいように抜粋し、整形すると以下のようになります。
（なお、以降の実行結果も適宜抜粋・整形しており、実際の実行結果には他にも情報が出力されます。詳しくは出力内容についてのドキュメントをご覧ください。）

[
  [
    [5],
    [["_key","UInt32"],["title","ShortText"],["price","Int32"]],
    [1,"Head First Groonga",3400],
    [2,"Head First Mroonga",2800],
    [3,"Groonga command manual",1000],
    [4,"Head First Rroonga",2000],
    [5,"Mroonga manual",2500]
  ]
]

実行結果を見ると、loadコマンドで登録した5つのレコードがBooksテーブルにあることがわかります。

主キーやIDを指定する

レコードを削除するには、deleteコマンドを使用します。
deleteコマンドはテーブル名と、削除するレコードの主キーの値やIDの値、もしくは後述しますが条件式を指定できます。
今回は、次のように_keyカラムの値が2のレコードを削除してみます。

delete Books 2

正しく削除が行われると、次のように実行結果が表示されます。

[true]

もし削除できなかった場合は [false] が返ってくるので、テーブル内のレコードの内容と実行したdeleteコマンドを確認してください。
さて、正しく削除されたかどうかをselectコマンドで確認してみましょう。先ほどと同じように、Booksテーブルの中身を確認してみます。

select Books --output_columns _key,title,price

正しく削除されている場合、次のような結果が返ってきます。

[
  [
    [4],
    [["_key","UInt32"],["title","ShortText"],["price","Int32"]],
    [1,"Head First Groonga",3400],
    [3,"Groonga command manual",1000],
    [4,"Head First Rroonga",2000],
    [5,"Mroonga manual",2500]
  ]
]

実行結果を見ると、レコード数が5つから4つに減り、主キーが2のレコードが削除されていることがわかります。

もし、主キーの値でなく、IDの値を指定したい場合は、まず次のようなselectコマンドでIDの値を確認します。

select Books --output_columns _id,_key,title,price

先ほど実行したselectコマンドとの違いは、 --output_columns 引数に対して _id という文字列を指定しているところです。これはレコードのIDを表示するためです。このselectコマンドを実行すると、次のように結果が返ってきます。

[
  [
    [4],
    [["_id","UInt32"],["_key","UInt32"],["title","ShortText"],["price","Int32"]],
    [1,1,"Head First Groonga",3400],
    [3,3,"Groonga command manual",1000],
    [4,4,"Head First Rroonga",2000],
    [5,5,"Mroonga manual",2500]
  ]
]

上記の実行結果のうち、各レコードの最初の値がそのレコードのIDです。
このうち、IDが5のレコードを消すには、次のように --id 引数を指定してdeleteコマンドを実行してください。

delete Books --id 5

正しく削除できていると、次のように実行結果が表示されます。

[true]

先ほどと同じselectコマンドを実行してみましょう。

select Books --output_columns _id,_key,title,price

正しく削除できている場合は、実行すると次のような実行結果が返ってきます。

[
  [
    [3],
    [["_id","UInt32"],["_key","UInt32"],["title","ShortText"],["price","Int32"]],
    [1,1,"Head First Groonga",3400],
    [3,3,"Groonga command manual",1000],
    [4,4,"Head First Rroonga",2000]
  ]
]

IDが5のレコードが削除されているのがわかります。

削除したいレコードの条件を指定する

先ほどの方法だと1つずつしかレコードを削除できません。例えば、"Groonga"という文字列がタイトルに含まれているレコードを先ほどの方法で削除しようとすると、titleカラムの値を見ながら1つずつ主キーの値を指定してdeleteコマンドを実行しなくてはなりません。
このように、削除したいレコードの条件が決まっているときには、deleteコマンドにfilter引数を指定することで条件を満たしたレコードを削除することができます。
条件はgroongaのスクリプト構文という記法に従って書きます。これはselectコマンドで全文検索するときにも使える記法です。そのため、deleteコマンドを使って全文検索し、ヒットしたレコードを削除することができます。スクリプト構文の詳しい書き方についてはリンク先をご覧下さい。

ここでは、「titleカラムに"Groonga"という単語が含まれている」という条件に当てはまったレコードを削除してみます。次のようにdeleteコマンドを実行してください。 'title @ "Groonga"' の部分が上記の条件を示しています。

delete Books --filter 'title @ "Groonga"'

これも、削除が成功すると次のように表示されます。

[true]

レコードが削除されているか、selectコマンドで確かめてみましょう。
なお、先ほど実行したselectコマンドの結果を見ると、"Groonga"という文字列が含まれるタイトルは主キーの値が1と3のレコードがもっていました。

select Books --output_columns _key,title,price

正しく削除されているなら次のような実行結果になります。

[
  [
    [1],
    [["_key","UInt32"],["title","ShortText"],["price","Int32"]],
    [4,"Head First Rroonga",2000]
  ]
]

selectコマンドの実行結果を見ると、確かに主キーの値が1と3のレコードが削除され、レコードの数が1つになっていることがわかります。

テーブルに登録されたレコードすべてを削除する

条件を指定せず、テーブルに登録されたレコードを全て削除するには、truncateコマンドを利用します。truncateコマンドはテーブル名を指定すると、そのテーブル内にあるレコードをすべて削除します。
それでは、残っているレコードを削除してみましょう。残っているのは主キーの値が4のレコードでした。次のコマンドを実行してください。

truncate Books

truncateコマンドには、レコードを指定するための値を何も指定していないのがわかります。
上記のコマンドが成功すると次のような実行結果になります。

[true]

次のselectコマンドで、Booksテーブルにレコードがないことを確認しましょう。

select Books --output_columns _key,title,price

[
  [
    [0],
    [["_key","UInt32"],["title","ShortText"],["price","Int32"]]
  ]
]

レコードの件数が0になっており、何もレコードが出力されていないことから、Booksテーブルからレコードがすべて削除されたことがわかります。

なお、deleteコマンドとtruncateコマンドどちらを使った場合でも、いちど削除したレコードを戻すことはできません。もし消してもいいか不安がある場合はデータベースをバックアップしておくと安心です。（バックアップにはdumpコマンドが利用できます。）

まとめ

今回はgroongaで不要になったレコードを削除するための方法について紹介しました。

groongaに興味を持ったなら、まずはインストールして試してみてください。

groongaの基本的な動作を知るためのチュートリアルもあります。