groonga 0.0.7 → 0.9.0

data/ext/rb-grn-table.c

@@ -1,6 +1,6 @@
 /* -*- c-file-style: "ruby" -*- */
 /*
-  Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2010  Kouhei Sutou <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -22,6 +22,17 @@
 
 VALUE rb_cGrnTable;
 
+static ID id_array_reference;
+static ID id_array_set;
+
+/*
+ * Document-class: Groonga::Table < Groonga::Object
+ *
+ * Ruby/groongaが提供するテーブルのベースとなるクラス。このクラス
+ * からGroonga::Array, Groonga::Hash, Groonga::PatriciaTrie
+ * が継承されている。
+ */
+
 grn_obj *
 rb_grn_table_from_ruby_object (VALUE object, grn_ctx **context)
 {
@@ -46,6 +57,7 @@ rb_grn_table_finalizer (grn_ctx *context, grn_obj *object,
     if (context && rb_grn_table->value)
 	grn_obj_close(context, rb_grn_table->value);
     rb_grn_table->value = NULL;
+    rb_grn_table->columns = Qnil;
 }
 
 void
@@ -57,6 +69,7 @@ rb_grn_table_bind (RbGrnTable *rb_grn_table,
     rb_grn_object = RB_GRN_OBJECT(rb_grn_table);
     rb_grn_table->value = grn_obj_open(context, GRN_BULK, 0,
 				       rb_grn_object->range_id);
+    rb_grn_table->columns = rb_ary_new();
 }
 
 void
@@ -67,7 +80,8 @@ rb_grn_table_deconstruct (RbGrnTable *rb_grn_table,
 			  grn_obj **domain,
 			  grn_obj **value,
 			  grn_id *range_id,
-			  grn_obj **range)
+			  grn_obj **range,
+			  VALUE *columns)
 {
     RbGrnObject *rb_grn_object;
 
@@ -78,17 +92,20 @@ rb_grn_table_deconstruct (RbGrnTable *rb_grn_table,
 
     if (value)
 	*value = rb_grn_table->value;
+    if (columns)
+	*columns = rb_grn_table->columns;
 }
 
 static void
 rb_grn_table_mark (void *data)
 {
     RbGrnObject *rb_grn_object = data;
+    RbGrnTable *rb_grn_table = data;
     grn_ctx *context;
     grn_obj *table;
-    grn_obj *column_ids;
-    int n;
-    grn_table_cursor *cursor;
+
+    if (!rb_grn_object)
+	return;
 
     context = rb_grn_object->context;
     table = rb_grn_object->object;
@@ -101,31 +118,7 @@ rb_grn_table_mark (void *data)
     if (grn_obj_name(context, table, NULL, 0) == 0)
 	return;
 
-    column_ids = grn_table_create(context, NULL, 0, NULL,
-				  GRN_TABLE_HASH_KEY, NULL, 0);
-    n = grn_table_columns(context, table, NULL, 0, column_ids);
-    if (n == 0) {
-	grn_obj_close(context, column_ids);
-	return;
-    }
-
-    cursor = grn_table_cursor_open(context, column_ids, NULL, 0, NULL, 0,
-				   0, 0, GRN_CURSOR_ASCENDING);
-    while (grn_table_cursor_next(context, cursor) != GRN_ID_NIL) {
-	void *key;
-	grn_id *column_id;
-	grn_obj *column;
-	RbGrnObject *rb_grn_column;
-
-	grn_table_cursor_get_key(context, cursor, &key);
-	column_id = key;
-	column = grn_ctx_at(context, *column_id);
-	rb_grn_column = grn_obj_user_data(context, column)->ptr;
-	if (rb_grn_column)
-	    rb_gc_mark(rb_grn_column->self);
-    }
-    grn_table_cursor_close(context, cursor);
-    grn_obj_close(context, column_ids);
+    rb_gc_mark(rb_grn_table->columns);
 }
 
 static VALUE
@@ -134,76 +127,6 @@ rb_grn_table_alloc (VALUE klass)
     return Data_Wrap_Struct(klass, rb_grn_table_mark, rb_grn_object_free, NULL);
 }
 
-VALUE
-rb_grn_table_s_create (int argc, VALUE *argv, VALUE klass,
-		       grn_obj_flags key_store)
-{
-    grn_ctx *context;
-    grn_obj *key_type = NULL, *value_type = NULL, *table;
-    const char *name = NULL, *path = NULL;
-    unsigned name_size = 0;
-    grn_obj_flags flags = key_store;
-    VALUE rb_table;
-    VALUE options, rb_context, rb_name, rb_path, rb_persistent;
-    VALUE rb_key_normalize, rb_key_with_sis, rb_key_type;
-    VALUE rb_value_type;
-
-    rb_scan_args(argc, argv, "01", &options);
-
-    rb_grn_scan_options(options,
-			"context", &rb_context,
-			"name", &rb_name,
-                        "path", &rb_path,
-			"persistent", &rb_persistent,
-			"key_normalize", &rb_key_normalize,
-			"key_with_sis", &rb_key_with_sis,
-			"key_type", &rb_key_type,
-			"value_type", &rb_value_type,
-			NULL);
-
-    context = rb_grn_context_ensure(&rb_context);
-
-    if (!NIL_P(rb_name)) {
-        name = StringValuePtr(rb_name);
-	name_size = RSTRING_LEN(rb_name);
-	flags |= GRN_OBJ_PERSISTENT;
-    }
-
-    if (!NIL_P(rb_path)) {
-        path = StringValueCStr(rb_path);
-	flags |= GRN_OBJ_PERSISTENT;
-    }
-
-    if (RVAL2CBOOL(rb_persistent))
-	flags |= GRN_OBJ_PERSISTENT;
-
-    if (RVAL2CBOOL(rb_key_normalize))
-	flags |= GRN_OBJ_KEY_NORMALIZE;
-
-    if (RVAL2CBOOL(rb_key_with_sis))
-	flags |= GRN_OBJ_KEY_WITH_SIS;
-
-    if (NIL_P(rb_key_type)) {
-	flags |= GRN_OBJ_KEY_VAR_SIZE;
-    } else {
-	key_type = RVAL2GRNOBJECT(rb_key_type, &context);
-    }
-
-    if (!NIL_P(rb_value_type))
-	value_type = RVAL2GRNOBJECT(rb_value_type, &context);
-
-    table = grn_table_create(context, name, name_size, path,
-			     flags, key_type, value_type);
-    rb_table = rb_grn_object_alloc(klass);
-    rb_grn_table_assign(rb_table, rb_context, context, table, RB_GRN_TRUE);
-    rb_grn_context_check(context, rb_table);
-
-    if (rb_block_given_p())
-        return rb_ensure(rb_yield, rb_table, rb_grn_object_close, rb_table);
-    else
-        return rb_table;
-}
-
 grn_obj *
 rb_grn_table_open_raw (int argc, VALUE *argv,
 		       grn_ctx **context, VALUE *rb_context)
@@ -249,6 +172,27 @@ rb_grn_table_initialize (int argc, VALUE *argv, VALUE self)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   Groonga::Table.open(options={})                -> Groonga::Table
+ *   Groonga::Table.open(options={}) {|table| ... }
+ *
+ * 既存のテーブルを開く。ブロックを指定すると、そのブロック
+ * に開かれたテーブルが渡され、ブロックを抜けると自動的にテ
+ * ーブルが破棄される。
+ *
+ * _options_に指定可能な値は以下の通り。
+ *
+ * [+:context+]
+ *   テーブルが利用するGroonga::Context。省略すると
+ *   Groonga::Context.defaultを用いる。
+ *
+ * [+:name+]
+ *   開こうとするテーブルの名前。
+ *
+ * [+:path+]
+ *   開こうとするテーブルのパス。
+ */
 static VALUE
 rb_grn_table_s_open (int argc, VALUE *argv, VALUE klass)
 {
@@ -285,8 +229,7 @@ rb_grn_table_s_open (int argc, VALUE *argv, VALUE klass)
 	    }
 	}
 
-	rb_table = rb_grn_object_alloc(klass);
-	rb_grn_object_assign(klass, rb_table, rb_context, context, table);
+	rb_table = GRNOBJECT2RVAL(klass, context, table, RB_GRN_TRUE);
     }
 
     if (rb_block_given_p())
@@ -298,12 +241,19 @@ rb_grn_table_s_open (int argc, VALUE *argv, VALUE klass)
 static VALUE
 rb_grn_table_inspect_content (VALUE self, VALUE inspected)
 {
+    RbGrnTable *rb_grn_table;
     grn_ctx *context = NULL;
     grn_obj *table;
+    VALUE columns;
 
-    rb_grn_table_deconstruct(SELF(self), &table, &context,
+    rb_grn_table = SELF(self);
+    if (!rb_grn_table)
+	return inspected;
+
+    rb_grn_table_deconstruct(rb_grn_table, &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     &columns);
 
     if (!table)
 	return inspected;
@@ -338,9 +288,22 @@ rb_grn_table_inspect_content (VALUE self, VALUE inspected)
     }
     rb_str_cat2(inspected, ">");
 
+    /*
+    rb_str_cat2(inspected, ", ");
+    rb_str_cat2(inspected, "columns: <");
+    rb_str_concat(inspected, rb_inspect(columns));
+    rb_str_cat2(inspected, ">");
+    */
+
     return inspected;
 }
 
+/*
+ * call-seq:
+ *   _table_.inspect -> String
+ *
+ * テーブルの中身を人に見やすい文字列で返す。
+ */
 static VALUE
 rb_grn_table_inspect (VALUE self)
 {
@@ -355,6 +318,43 @@ rb_grn_table_inspect (VALUE self)
     return inspected;
 }
 
+/*
+ * call-seq:
+ *   table.define_column(name, value_type, options={}) ->
+ *     Groonga::FixSizeColumnかGroonga::VariableSizeColumn
+ *
+ * テーブルに名前が_name_で型が_value_type_のカラムを定義
+ * し、新しく定義されたカラムを返す。
+ *
+ * _options_に指定可能な値は以下の通り。
+ *
+ * [+:path+]
+ *   カラムを保存するパス。
+ *
+ * [+:persistent+]
+ *   +true+を指定すると永続カラムとなる。省略した場合は永
+ *   続カラムとなる。+:path+を省略した場合は自動的にパスが
+ *   付加される。
+ *
+ * [+:type+]
+ *   カラムの値の格納方法について指定する。省略した場合は、
+ *   +:scalar+になる。
+ *
+ *   [+:scalar+]
+ *     スカラ値(単独の値)を格納する。
+ *
+ *   [+:vector+]
+ *     値の配列を格納する。
+ *
+ * [+:compress+]
+ *   値の圧縮方法を指定する。省略した場合は、圧縮しない。
+ *
+ *   [+:zlib+]
+ *     値をzlib圧縮して格納する。
+ *
+ *   [+:lzo+]
+ *     値をlzo圧縮して格納する。
+ */
 static VALUE
 rb_grn_table_define_column (int argc, VALUE *argv, VALUE self)
 {
@@ -366,10 +366,13 @@ rb_grn_table_define_column (int argc, VALUE *argv, VALUE self)
     grn_obj_flags flags = 0;
     VALUE rb_name, rb_value_type;
     VALUE options, rb_path, rb_persistent, rb_compress, rb_type;
+    VALUE columns;
+    VALUE rb_column;
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     &columns);
 
     rb_scan_args(argc, argv, "21", &rb_name, &rb_value_type, &options);
 
@@ -385,13 +388,20 @@ rb_grn_table_define_column (int argc, VALUE *argv, VALUE self)
 
     value_type = RVAL2GRNOBJECT(rb_value_type, &context);
 
-    if (!NIL_P(rb_path)) {
-	path = StringValueCStr(rb_path);
+    if ((NIL_P(rb_persistent) && grn_obj_path(context, table)) ||
+	RVAL2CBOOL(rb_persistent)) {
 	flags |= GRN_OBJ_PERSISTENT;
     }
 
-    if (RVAL2CBOOL(rb_persistent))
+    if (!NIL_P(rb_path)) {
+	path = StringValueCStr(rb_path);
+	if ((flags & GRN_OBJ_PERSISTENT) != GRN_OBJ_PERSISTENT) {
+	    rb_raise(rb_eArgError,
+		     "should not pass :path if :persistent is false: <%s>",
+		     path);
+	}
 	flags |= GRN_OBJ_PERSISTENT;
+    }
 
     if (NIL_P(rb_type) ||
 	(rb_grn_equal_option(rb_type, "scalar"))) {
@@ -421,9 +431,46 @@ rb_grn_table_define_column (int argc, VALUE *argv, VALUE self)
 			       path, flags, value_type);
     rb_grn_context_check(context, self);
 
-    return GRNCOLUMN2RVAL(Qnil, context, column, RB_GRN_TRUE);
+    rb_column = GRNCOLUMN2RVAL(Qnil, context, column, RB_GRN_TRUE);
+    rb_ary_push(columns, rb_column);
+    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column)),
+				 name, name_size);
+
+    return rb_column;
 }
 
+/*
+ * call-seq:
+ *   table.define_index_column(name, value_type, options={}) -> Groonga::IndexColumn
+ *
+ * テーブルに名前が_name_で型が_value_type_のインデックスカ
+ * ラムを定義し、新しく定義されたカラムを返す。
+ *
+ * _options_に指定可能な値は以下の通り。
+ *
+ * [+:path+]
+ *   カラムを保存するパス。
+ *
+ * [+:persistent+]
+ *   +true+を指定すると永続カラムとなる。省略した場合は永
+ *   続カラムとなる。+:path+を省略した場合は自動的にパスが
+ *   付加される。
+ *
+ * [+:with_section+]
+ *   転置索引にsection(段落情報)を合わせて格納する。
+ *
+ * [+:with_weight+]
+ *   転置索引にweight情報を合わせて格納する。
+ *
+ * [+:with_position+]
+ *   転置索引に出現位置情報を合わせて格納する。
+ *
+ * [+:source+]
+ *  インデックス対象となるカラムを指定する。+:sources+との併用はできない。
+ *
+ * [+:sources+]
+ *  インデックス対象となる複数のカラムを指定する。+:source+との併用はできない。
+ */
 static VALUE
 rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
 {
@@ -437,10 +484,12 @@ rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
     VALUE options, rb_path, rb_persistent;
     VALUE rb_with_section, rb_with_weight, rb_with_position;
     VALUE rb_column, rb_source, rb_sources;
+    VALUE columns;
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     &columns);
 
     rb_scan_args(argc, argv, "21", &rb_name, &rb_value_type, &options);
 
@@ -459,13 +508,20 @@ rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
 
     value_type = RVAL2GRNOBJECT(rb_value_type, &context);
 
-    if (!NIL_P(rb_path)) {
-	path = StringValueCStr(rb_path);
+    if ((NIL_P(rb_persistent) && grn_obj_path(context, table)) ||
+	RVAL2CBOOL(rb_persistent)) {
 	flags |= GRN_OBJ_PERSISTENT;
     }
 
-    if (RVAL2CBOOL(rb_persistent))
+    if (!NIL_P(rb_path)) {
+	path = StringValueCStr(rb_path);
+	if ((flags & GRN_OBJ_PERSISTENT) != GRN_OBJ_PERSISTENT) {
+	    rb_raise(rb_eArgError,
+		     "should not pass :path if :persistent is false: <%s>",
+		     path);
+	}
 	flags |= GRN_OBJ_PERSISTENT;
+    }
 
     if (RVAL2CBOOL(rb_with_section))
 	flags |= GRN_OBJ_WITH_SECTION;
@@ -505,9 +561,20 @@ rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
     if (!NIL_P(rb_sources))
 	rb_funcall(rb_column, rb_intern("sources="), 1, rb_sources);
 
+    rb_ary_push(columns, rb_column);
+    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column)),
+				 name, name_size);
+
     return rb_column;
 }
 
+/*
+ * call-seq:
+ *  table.add_column(name, value_type, path)
+ *
+ * _value_type_を値の型として、_path_に保存されている永続的
+ * なカラムを、テーブルの_name_に対応するカラムとして開く。
+ */
 static VALUE
 rb_grn_table_add_column (VALUE self, VALUE rb_name, VALUE rb_value_type,
 			 VALUE rb_path)
@@ -518,10 +585,12 @@ rb_grn_table_add_column (VALUE self, VALUE rb_name, VALUE rb_value_type,
     char *name = NULL, *path = NULL;
     unsigned name_size = 0;
     VALUE rb_column;
+    VALUE columns;
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     &columns);
 
     name = StringValuePtr(rb_name);
     name_size = RSTRING_LEN(rb_name);
@@ -536,29 +605,48 @@ rb_grn_table_add_column (VALUE self, VALUE rb_name, VALUE rb_value_type,
 
     rb_column = GRNCOLUMN2RVAL(Qnil, context, column, RB_GRN_TRUE);
     rb_iv_set(rb_column, "table", self);
+    rb_ary_push(columns, rb_column);
+    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column)),
+				 name, name_size);
+
     return rb_column;
 }
 
-static VALUE
+/*
+ * call-seq:
+ *   table.column(name) -> Groonga::Column or nil
+ *
+ * テーブルの_name_に対応するカラムを返す。カラムが存在しな
+ * い場合は+nil+を返す。
+ */
+VALUE
 rb_grn_table_get_column (VALUE self, VALUE rb_name)
 {
+    grn_user_data *user_data;
     grn_ctx *context = NULL;
     grn_obj *table;
     grn_obj *column;
-    char *name = NULL;
+    const char *name = NULL;
     unsigned name_size = 0;
     rb_grn_boolean owner;
     VALUE rb_column;
+    VALUE columns;
+    VALUE *raw_columns;
+    long i, n;
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     &columns);
 
     switch (TYPE(rb_name)) {
       case T_SYMBOL:
-	rb_name = rb_str_new2(rb_id2name(SYM2ID(rb_name)));
+	name = rb_id2name(SYM2ID(rb_name));
+	name_size = strlen(name);
 	break;
       case T_STRING:
+	name = StringValuePtr(rb_name);
+	name_size = RSTRING_LEN(rb_name);
 	break;
       default:
 	rb_raise(rb_eArgError,
@@ -566,19 +654,66 @@ rb_grn_table_get_column (VALUE self, VALUE rb_name)
 		 rb_grn_inspect(rb_name));
 	break;
     }
-    name = StringValuePtr(rb_name);
-    name_size = RSTRING_LEN(rb_name);
+
+    raw_columns = RARRAY_PTR(columns);
+    n = RARRAY_LEN(columns);
+    for (i = 0; i < n; i++) {
+	VALUE rb_column = raw_columns[i];
+	RbGrnNamedObject *rb_grn_named_object;
+
+	rb_grn_named_object = RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column));
+	if (rb_grn_named_object->name_size > 0 &&
+	    strncmp(name, rb_grn_named_object->name, name_size) == 0) {
+	    return rb_column;
+	}
+    }
 
     column = grn_obj_column(context, table, name, name_size);
     rb_grn_context_check(context, self);
+    if (!column)
+	return Qnil;
 
-    owner = (column && column->header.type == GRN_ACCESSOR);
+    user_data = grn_obj_user_data(context, column);
+    if (user_data) {
+	RbGrnObject *rb_grn_object;
+	rb_grn_object = user_data->ptr;
+	if (rb_grn_object) {
+	    rb_ary_push(columns, rb_grn_object->self);
+	    return rb_grn_object->self;
+	}
+    }
+
+    owner = column->header.type == GRN_ACCESSOR;
     rb_column = GRNCOLUMN2RVAL(Qnil, context, column, owner);
-    if (owner)
+    if (owner) {
 	rb_iv_set(rb_column, "table", self);
+    }
+    rb_ary_push(columns, rb_column);
+
     return rb_column;
 }
 
+VALUE
+rb_grn_table_get_column_surely (VALUE self, VALUE rb_name)
+{
+    VALUE rb_column;
+
+    rb_column = rb_grn_table_get_column(self, rb_name);
+    if (NIL_P(rb_column)) {
+	rb_raise(rb_eGrnNoSuchColumn,
+		 "no such column: <%s>: <%s>",
+		 rb_grn_inspect(rb_name), rb_grn_inspect(self));
+    }
+    return rb_column;
+}
+
+/*
+ * call-seq:
+ *   table.columns(name=nil) -> Groonga::Columnの配列
+ *
+ * テーブルの全てのカラムを返す。_name_が指定された場合はカ
+ * ラム名の先頭が_name_で始まるカラムを返す。
+ */
 static VALUE
 rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
 {
@@ -594,7 +729,8 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_scan_args(argc, argv, "01", &rb_name);
 
@@ -613,7 +749,7 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
 	return rb_columns;
 
     cursor = grn_table_cursor_open(context, columns, NULL, 0, NULL, 0,
-				   0, 0, GRN_CURSOR_ASCENDING);
+				   0, -1, GRN_CURSOR_ASCENDING);
     rb_grn_context_check(context, self);
     while (grn_table_cursor_next(context, cursor) != GRN_ID_NIL) {
 	void *key;
@@ -644,18 +780,23 @@ rb_grn_table_open_grn_cursor (int argc, VALUE *argv, VALUE self,
     grn_table_cursor *cursor;
     void *min_key = NULL, *max_key = NULL;
     unsigned min_key_size = 0, max_key_size = 0;
+    int offset = 0, limit = -1;
     int flags = 0;
     VALUE options, rb_min, rb_max, rb_order, rb_greater_than, rb_less_than;
+    VALUE rb_offset, rb_limit;
 
     rb_grn_table_deconstruct(SELF(self), &table, context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_scan_args(argc, argv, "01", &options);
 
     rb_grn_scan_options(options,
 			"min", &rb_min,
                         "max", &rb_max,
+                        "offset", &rb_offset,
+                        "limit", &rb_limit,
 			"order", &rb_order,
 			"greater_than", &rb_greater_than,
 			"less_than", &rb_less_than,
@@ -669,6 +810,10 @@ rb_grn_table_open_grn_cursor (int argc, VALUE *argv, VALUE self,
 	max_key = StringValuePtr(rb_max);
 	max_key_size = RSTRING_LEN(rb_max);
     }
+    if (!NIL_P(rb_offset))
+	offset = NUM2INT(rb_offset);
+    if (!NIL_P(rb_limit))
+	limit = NUM2INT(rb_limit);
 
     if (NIL_P(rb_order)) {
     } else if (rb_grn_equal_option(rb_order, "asc") ||
@@ -689,16 +834,55 @@ rb_grn_table_open_grn_cursor (int argc, VALUE *argv, VALUE self,
     if (RVAL2CBOOL(rb_less_than))
 	flags |= GRN_CURSOR_LT;
 
-    /* FIXME: should support offset and limit */
     cursor = grn_table_cursor_open(*context, table,
 				   min_key, min_key_size,
 				   max_key, max_key_size,
-				   0, 0, flags);
+				   offset, limit, flags);
     rb_grn_context_check(*context, self);
 
     return cursor;
 }
 
+/*
+ * call-seq:
+ *   table.open_cursor(options={}) -> Groonga::TableCursor
+ *   table.open_cursor(options={}) {|cursor| ... }
+ *
+ * カーソルを生成して返す。ブロックを指定すると、そのブロッ
+ * クに生成したカーソルが渡され、ブロックを抜けると自動的に
+ * カーソルが破棄される。
+ *
+ * _options_に指定可能な値は以下の通り。
+ *
+ * [+:min+]
+ *  キーの下限
+ *
+ * [+:max+]
+ *  キーの上限
+ *
+ * [+:offset+]
+ *   該当する範囲のレコードのうち、(0ベースで)_:offset_番目
+ *   からレコードを取り出す。
+ *
+ * [+:limit+]
+ *   該当する範囲のレコードのうち、_:limit_件のみを取り出す。
+ *   省略された場合または-1が指定された場合は、全件が指定され
+ *   たものとみなす。
+ *
+ * [+:order+]
+ *   +:asc+または+:ascending+を指定すると昇順にレコードを取
+ *   り出す。
+ *   +:desc+または+:descending+を指定すると降順にレコードを
+ *   取り出す。
+ *
+ * [+:greater_than+]
+ *   +true+を指定すると+:min+で指定した値に一致した[+key+]を
+ *   範囲に含まない。
+ *
+ * [+:less_than+]
+ *   +true+を指定すると+:max+で指定した値に一致した[+key+]を
+ *   範囲に含まない。
+ */
 static VALUE
 rb_grn_table_open_cursor (int argc, VALUE *argv, VALUE self)
 {
@@ -715,6 +899,13 @@ rb_grn_table_open_cursor (int argc, VALUE *argv, VALUE self)
 	return rb_cursor;
 }
 
+/*
+ * call-seq:
+ *   table.records -> Groonga::Recordの配列
+ *
+ * テーブルに登録されている全てのレコードが入っている配列を
+ * 返す。
+ */
 static VALUE
 rb_grn_table_get_records (int argc, VALUE *argv, VALUE self)
 {
@@ -733,6 +924,12 @@ rb_grn_table_get_records (int argc, VALUE *argv, VALUE self)
     return records;
 }
 
+/*
+ * call-seq:
+ *   table.size -> レコード数
+ *
+ * テーブルに登録されているレコード数を返す。
+ */
 static VALUE
 rb_grn_table_get_size (VALUE self)
 {
@@ -742,11 +939,18 @@ rb_grn_table_get_size (VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
     size = grn_table_size(context, table);
     return UINT2NUM(size);
 }
 
+/*
+ * call-seq:
+ *   table.truncate
+ *
+ * テーブルの全レコードを一括して削除する。
+ */
 static VALUE
 rb_grn_table_truncate (VALUE self)
 {
@@ -756,29 +960,42 @@ rb_grn_table_truncate (VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
     rc = grn_table_truncate(context, table);
     rb_grn_rc_check(rc, self);
 
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table.each {|record| ...}
+ *
+ * テーブルに登録されているレコードを順番にブロックに渡す。
+ */
 static VALUE
 rb_grn_table_each (VALUE self)
 {
+    RbGrnTable *rb_table;
+    RbGrnObject *rb_grn_object;
     grn_ctx *context = NULL;
     grn_obj *table;
     grn_table_cursor *cursor;
     VALUE rb_cursor;
     grn_id id;
 
-    rb_grn_table_deconstruct(SELF(self), &table, &context,
+    rb_table = SELF(self);
+    rb_grn_table_deconstruct(rb_table, &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
     cursor = grn_table_cursor_open(context, table, NULL, 0, NULL, 0,
-				   0, 0, GRN_CURSOR_ASCENDING);
+				   0, -1, GRN_CURSOR_ASCENDING);
     rb_cursor = GRNTABLECURSOR2RVAL(Qnil, context, cursor);
-    while ((id = grn_table_cursor_next(context, cursor)) != GRN_ID_NIL) {
+    rb_grn_object = RB_GRN_OBJECT(rb_table);
+    while (rb_grn_object->object &&
+	   (id = grn_table_cursor_next(context, cursor)) != GRN_ID_NIL) {
 	rb_yield(rb_grn_record_new(self, id, Qnil));
     }
     rb_grn_object_close(rb_cursor);
@@ -786,6 +1003,12 @@ rb_grn_table_each (VALUE self)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table.delete(id)
+ *
+ * テーブルの_id_に対応するレコードを削除する。
+ */
 VALUE
 rb_grn_table_delete (VALUE self, VALUE rb_id)
 {
@@ -796,7 +1019,8 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     id = NUM2UINT(rb_id);
     rc = grn_table_delete_by_id(context, table, id);
@@ -805,6 +1029,32 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
     return Qnil;
 }
 
+/*
+ * call-seq:
+ *   table.sort(keys, options={}) -> Groonga::Recordの配列
+ *
+ * テーブルに登録されているレコードを_keys_で指定されたルー
+ * ルに従ってソートしたレコードの配列を返す。
+ *
+ *   [
+ *    {:key => "カラム名", :order => :asc, :ascending,
+ *                                   :desc, :descendingのいずれか},
+ *    {:key => "カラム名", :order => :asc, :ascending,
+ *                                   :desc, :descendingのいずれか},
+ *    ...,
+ *   ]
+ *
+ * _options_に指定可能な値は以下の通り。
+ *
+ * [+:offset+]
+ *   ソートされたレコードのうち、(0ベースで)_:offset_番目
+ *   からレコードを取り出す。
+ *
+ * [+:limit+]
+ *   ソートされたレコードのうち、_:limit_件のみを取り出す。
+ *   省略された場合または-1が指定された場合は、全件が指定され
+ *   たものとみなす。
+ */
 static VALUE
 rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
 {
@@ -819,10 +1069,12 @@ rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
     VALUE *rb_sort_keys;
     grn_table_cursor *cursor;
     VALUE rb_result;
+    VALUE exception;
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_scan_args(argc, argv, "11", &rb_keys, &options);
 
@@ -889,10 +1141,15 @@ rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
 			      NULL, table);
     n_records = grn_table_sort(context, table, offset, limit,
 			       result, keys, n_keys);
+    exception = rb_grn_context_to_exception(context, self);
+    if (!NIL_P(exception)) {
+        grn_obj_close(context, result);
+        rb_exc_raise(exception);
+    }
 
     rb_result = rb_ary_new();
     cursor = grn_table_cursor_open(context, result, NULL, 0, NULL, 0,
-				   0, 0, GRN_CURSOR_ASCENDING);
+				   0, -1, GRN_CURSOR_ASCENDING);
     while (grn_table_cursor_next(context, cursor) != GRN_ID_NIL) {
 	void *value;
 	grn_id *id;
@@ -904,11 +1161,20 @@ rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
     grn_table_cursor_close(context, cursor);
     grn_obj_close(context, result);
 
-    rb_grn_context_check(context, self); /* FIXME: here is too late */
-
     return rb_result;
 }
 
+/*
+ * call-seq:
+ *   table.group(column, options={}) -> Groonga::Hash
+ *   table.group(column1, column2, ..., options={}) -> [Groonga::Hash, ...]
+ *
+ * _table_のレコードを_column1_, _column2_, _..._で指定したカ
+ * ラムの値でグループ化する。カラムはカラム名（文字列）でも
+ * 指定可能。
+ *
+ * このAPIは将来変更されます。
+ */
 static VALUE
 rb_grn_table_group (int argc, VALUE *argv, VALUE self)
 {
@@ -924,16 +1190,17 @@ rb_grn_table_group (int argc, VALUE *argv, VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
-    rb_scan_args(argc, argv, "10", &rb_keys);
-
-    if (!RVAL2CBOOL(rb_obj_is_kind_of(rb_keys, rb_cArray)))
-	rb_raise(rb_eArgError, "keys should be an array of key: <%s>",
-		 rb_grn_inspect(rb_keys));
+    rb_scan_args(argc, argv, "00*", &rb_keys);
 
     n_keys = RARRAY_LEN(rb_keys);
     rb_sort_keys = RARRAY_PTR(rb_keys);
+    if (n_keys == 1 && TYPE(rb_sort_keys[0]) == T_ARRAY) {
+	n_keys = RARRAY_LEN(rb_sort_keys[0]);
+	rb_sort_keys = RARRAY_PTR(rb_sort_keys[0]);
+    }
     keys = ALLOCA_N(grn_table_sort_key, n_keys);
     for (i = 0; i < n_keys; i++) {
 	VALUE rb_sort_options, rb_key;
@@ -992,12 +1259,20 @@ rb_grn_table_group (int argc, VALUE *argv, VALUE self)
  * Document-method: []
  *
  * call-seq:
- *   table[id] -> 値
+ *   table[id] -> Groonga::Record
  *
- * _table_の_id_に対応する値を返す。
+ * _table_の_id_に対応するGroonga::Recordを返す。
+ *
+ * 0.9.0から値ではなくGroonga::Recordを返すようになった。
  */
 VALUE
 rb_grn_table_array_reference (VALUE self, VALUE rb_id)
+{
+    return rb_grn_record_new_raw(self, rb_id, Qnil);
+}
+
+VALUE
+rb_grn_table_get_value (VALUE self, VALUE rb_id)
 {
     grn_id id;
     grn_ctx *context;
@@ -1007,30 +1282,54 @@ rb_grn_table_array_reference (VALUE self, VALUE rb_id)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     &value, NULL, &range);
+			     &value, NULL, &range,
+			     NULL);
 
     id = NUM2UINT(rb_id);
     GRN_BULK_REWIND(value);
     grn_obj_get_value(context, table, id, value);
     rb_grn_context_check(context, self);
 
-    if (GRN_BULK_EMPTYP(value))
-	return Qnil;
-    else
-	return rb_str_new(GRN_BULK_HEAD(value), GRN_BULK_VSIZE(value));
+    return GRNBULK2RVAL(context, value, range, self);
 }
 
 /*
- * Document-method: []=
+ * Document-method: value
  *
  * call-seq:
- *   table[id] = value
+ *   table.value(id) -> 値
+ *   table.value(id, :id => true) -> 値
+ *
+ * _table_の_id_に対応する値を返す。
  *
- * _table_の_id_に対応する値を設定する。既存の値は上書きさ
- * れる。
+ * <tt>:id => true</tt>が指定できるのは利便性のため。
+ * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * 同じ引数で動くようになる。
  */
+static VALUE
+rb_grn_table_get_value_convenience (int argc, VALUE *argv, VALUE self)
+{
+    VALUE rb_id, rb_options;
+
+    rb_scan_args(argc, argv, "11", &rb_id, &rb_options);
+    if (!NIL_P(rb_options)) {
+	VALUE rb_option_id;
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	if (!(NIL_P(rb_option_id) || RVAL2CBOOL(rb_option_id))) {
+	    rb_raise(rb_eArgError, ":id options must be true or nil: %s: %s",
+		     rb_grn_inspect(rb_option_id),
+		     rb_grn_inspect(rb_ary_new3(2,
+						self, rb_ary_new4(argc, argv))));
+	}
+    }
+
+    return rb_grn_table_get_value(self, rb_id);
+}
+
 VALUE
-rb_grn_table_array_set (VALUE self, VALUE rb_id, VALUE rb_value)
+rb_grn_table_set_value (VALUE self, VALUE rb_id, VALUE rb_value)
 {
     grn_id id;
     grn_ctx *context;
@@ -1041,7 +1340,8 @@ rb_grn_table_array_set (VALUE self, VALUE rb_id, VALUE rb_value)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     &value, NULL, &range);
+			     &value, NULL, &range,
+			     NULL);
 
     id = NUM2UINT(rb_id);
     GRN_BULK_REWIND(value);
@@ -1053,6 +1353,152 @@ rb_grn_table_array_set (VALUE self, VALUE rb_id, VALUE rb_value)
     return Qnil;
 }
 
+/*
+ * Document-method: set_value
+ *
+ * call-seq:
+ *   table.set_value(id, value)
+ *   table.set_value(id, value, :id => true)
+ *
+ * _table_の_id_に対応する値として_value_設定する。既存の値は
+ * 上書きされる。
+ *
+ * <tt>:id => true</tt>が指定できるのは利便性のため。
+ * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * 同じ引数で動くようになる。
+ */
+static VALUE
+rb_grn_table_set_value_convenience (int argc, VALUE *argv, VALUE self)
+{
+    VALUE rb_id, rb_value, rb_options;
+
+    rb_scan_args(argc, argv, "21", &rb_id, &rb_value, &rb_options);
+    if (!NIL_P(rb_options)) {
+	VALUE rb_option_id;
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	if (!(NIL_P(rb_option_id) || RVAL2CBOOL(rb_option_id))) {
+	    rb_raise(rb_eArgError, ":id options must be true or nil: %s: %s",
+		     rb_grn_inspect(rb_option_id),
+		     rb_grn_inspect(rb_ary_new3(2,
+						self, rb_ary_new4(argc, argv))));
+	}
+    }
+
+    return rb_grn_table_set_value(self, rb_id, rb_value);
+}
+
+VALUE
+rb_grn_table_get_column_value_raw (VALUE self, grn_id id, VALUE rb_name)
+{
+    VALUE rb_column;
+
+    rb_column = rb_grn_table_get_column_surely(self, rb_name);
+
+    /* TODO: improve speed. */
+    return rb_funcall(rb_column, id_array_reference, 1, INT2NUM(id));
+}
+
+VALUE
+rb_grn_table_get_column_value (VALUE self, VALUE rb_id, VALUE rb_name)
+{
+    return rb_grn_table_get_column_value_raw(self, NUM2INT(rb_id), rb_name);
+}
+
+/*
+ * Document-method: column_value
+ *
+ * call-seq:
+ *   table.column_value(id, name) -> 値
+ *   table.column_value(id, name, :id => true) -> 値
+ *
+ * _table_の_id_に対応するカラム_name_の値を返す。
+ *
+ * <tt>:id => true</tt>が指定できるのは利便性のため。
+ * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * 同じ引数で動くようになる。
+ */
+static VALUE
+rb_grn_table_get_column_value_convenience (int argc, VALUE *argv, VALUE self)
+{
+    VALUE rb_id, rb_name, rb_options;
+
+    rb_scan_args(argc, argv, "21", &rb_id, &rb_name, &rb_options);
+    if (!NIL_P(rb_options)) {
+	VALUE rb_option_id;
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	if (!(NIL_P(rb_option_id) || RVAL2CBOOL(rb_option_id))) {
+	    rb_raise(rb_eArgError, ":id options must be true or nil: %s: %s",
+		     rb_grn_inspect(rb_option_id),
+		     rb_grn_inspect(rb_ary_new3(2,
+						self,
+						rb_ary_new4(argc, argv))));
+	}
+    }
+
+    return rb_grn_table_get_column_value(self, rb_id, rb_name);
+}
+
+VALUE
+rb_grn_table_set_column_value_raw (VALUE self, grn_id id,
+				   VALUE rb_name, VALUE rb_value)
+{
+    VALUE rb_column;
+
+    rb_column = rb_grn_table_get_column_surely(self, rb_name);
+
+    /* TODO: improve speed. */
+    return rb_funcall(rb_column, id_array_set, 2, INT2NUM(id), rb_value);
+}
+
+VALUE
+rb_grn_table_set_column_value (VALUE self, VALUE rb_id,
+			       VALUE rb_name, VALUE rb_value)
+{
+    return rb_grn_table_set_column_value_raw(self, NUM2INT(rb_id),
+					     rb_name, rb_value);
+}
+
+/*
+ * Document-method: set_column_value
+ *
+ * call-seq:
+ *   table.set_column_value(id, name, value)
+ *   table.set_column_value(id, name, value, :id => true)
+ *
+ * _table_の_id_に対応するカラム_name_の値として_value_設定す
+ * る。既存の値は上書きされる。
+ *
+ * <tt>:id => true</tt>が指定できるのは利便性のため。
+ * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * 同じ引数で動くようになる。
+ */
+static VALUE
+rb_grn_table_set_column_value_convenience (int argc, VALUE *argv, VALUE self)
+{
+    VALUE rb_id, rb_name, rb_value, rb_options;
+
+    rb_scan_args(argc, argv, "31", &rb_id, &rb_name, &rb_value, &rb_options);
+    if (!NIL_P(rb_options)) {
+	VALUE rb_option_id;
+	rb_grn_scan_options(rb_options,
+			    "id", &rb_option_id,
+			    NULL);
+	if (!(NIL_P(rb_option_id) || RVAL2CBOOL(rb_option_id))) {
+	    rb_raise(rb_eArgError, ":id options must be true or nil: %s: %s",
+		     rb_grn_inspect(rb_option_id),
+		     rb_grn_inspect(rb_ary_new3(2,
+						self,
+						rb_ary_new4(argc, argv))));
+	}
+    }
+
+    return rb_grn_table_set_column_value(self, rb_id, rb_name, rb_value);
+}
+
 /*
  * Document-method: unlock
  *
@@ -1080,7 +1526,8 @@ rb_grn_table_unlock (int argc, VALUE *argv, VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_grn_scan_options(options,
 			"id", &rb_id,
@@ -1138,7 +1585,8 @@ rb_grn_table_lock (int argc, VALUE *argv, VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_grn_scan_options(options,
 			"timeout", &rb_timeout,
@@ -1190,7 +1638,8 @@ rb_grn_table_clear_lock (int argc, VALUE *argv, VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_grn_scan_options(options,
 			"id", &rb_id,
@@ -1232,7 +1681,8 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rb_grn_scan_options(options,
 			"id", &rb_id,
@@ -1248,6 +1698,7 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table.select(options) {|record| ...} -> Groonga::Hash
  *   table.select(query, options) -> Groonga::Hash
+ *   table.select(expression, options) -> Groonga::Hash
  *
  * _table_からブロックまたは文字列で指定した条件にマッチする
  * レコードを返す。返されたテーブルには+expression+という特
@@ -1257,7 +1708,7 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  * 用のスニペットを簡単に生成できる。
  *
  *   results = table.select do |record|
- *     result["description"] =~ "groonga"
+ *     record["description"] =~ "groonga"
  *   end
  *   snippet = results.expression.snippet([["<em>", "</em>"]])
  *   results.each do |record|
@@ -1280,26 +1731,28 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *
  * [なし]
  *   [カラム値] == [値]
- * [+!+]
+ * [<tt>!</tt>]
  *   [カラム値] != [値]
- * [+<+]
+ * [<tt><</tt>]
  *   [カラム値] < [値]
- * [+>+]
+ * [<tt>></tt>]
  *   [カラム値] > [値]
- * [+<=+]
+ * [<tt><=</tt>]
  *   [カラム値] <= [値]
- * [+>=+]
+ * [<tt>>=</tt>]
  *   [カラム値] >= [値]
- * [+@+]
+ * [<tt>@</tt>]
  *   [カラム値]が[値]を含んでいるかどうか
  *
  * 例:
  *   "name:daijiro" # "name"カラムの値が"daijiro"のレコードにマッチ
- *   "description:@groonga" # "description"カラムに
+ *   "description:@groonga" # "description"カラムが
  *                          # "groonga"を含んでいるレコードにマッチ
  *
- * ブロックで条件を指定する場合はGroonga::ExpressionBuilder
- * を参照。
+ * _expression_には既に作成済みのGroonga::Expressionを渡す
+ *
+ * ブロックで条件を指定する場合は
+ * Groonga::RecordExpressionBuilderを参照。
  *
  * _options_に指定可能な値は以下の通り。
  *
@@ -1324,6 +1777,29 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *
  * [+:name+]
  *   条件の名前。省略した場合は名前を付けない。
+ *
+ * [+:syntax+]
+ *   _query_の構文。省略した場合は+:query+。
+ *
+ *   参考: Groonga::Expression#parse.
+ *
+ * [+:allow_pragma+]
+ *   query構文時にプラグマを利用するかどうか。省略した場合は
+ *   利用する。
+ *
+ *   参考: Groonga::Expression#parse.
+ *
+ * [+:allow_column+]
+ *   query構文時にカラム指定を利用するかどうか。省略した場合
+ *   は利用する。
+ *
+ *   参考: Groonga::Expression#parse.
+ *
+ * [+:allow_update+]
+ *   script構文時に更新操作を利用するかどうか。省略した場合
+ *   は利用する。
+ *
+ *   参考: Groonga::Expression#parse.
  */
 static VALUE
 rb_grn_table_select (int argc, VALUE *argv, VALUE self)
@@ -1331,31 +1807,41 @@ rb_grn_table_select (int argc, VALUE *argv, VALUE self)
     grn_ctx *context;
     grn_obj *table, *result, *expression;
     grn_operator operator = GRN_OP_OR;
-    VALUE rb_query = Qnil, query_or_options, options;
-    VALUE rb_name, rb_operator, rb_result;
-    VALUE rb_expression, builder;
+    VALUE rb_query = Qnil, condition_or_options, options;
+    VALUE rb_name, rb_operator, rb_result, rb_syntax;
+    VALUE rb_allow_pragma, rb_allow_column, rb_allow_update;
+    VALUE rb_expression = Qnil, builder;
 
-    rb_scan_args(argc, argv, "02", &query_or_options, &options);
+    rb_scan_args(argc, argv, "02", &condition_or_options, &options);
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
-
-    if (RVAL2CBOOL(rb_obj_is_kind_of(query_or_options, rb_cString))) {
-	rb_query = query_or_options;
+			     NULL, NULL, NULL,
+			     NULL);
+
+    if (RVAL2CBOOL(rb_obj_is_kind_of(condition_or_options, rb_cString))) {
+	rb_query = condition_or_options;
+    } else if (RVAL2CBOOL(rb_obj_is_kind_of(condition_or_options,
+					    rb_cGrnExpression))) {
+	rb_expression = condition_or_options;
     } else {
 	if (!NIL_P(options))
 	    rb_raise(rb_eArgError,
-		     "should be [query_string, option_hash] "
+		     "should be [query_string, option_hash], "
+		     "[expression, opion_hash] "
 		     "or [option_hash]: %s",
 		     rb_grn_inspect(rb_ary_new4(argc, argv)));
-	options = query_or_options;
+	options = condition_or_options;
     }
 
     rb_grn_scan_options(options,
 			"operator", &rb_operator,
 			"result", &rb_result,
 			"name", &rb_name,
+			"syntax", &rb_syntax,
+			"allow_pragma", &rb_allow_pragma,
+			"allow_column", &rb_allow_column,
+			"allow_update", &rb_allow_update,
 			NULL);
 
     if (!NIL_P(rb_operator))
@@ -1371,11 +1857,15 @@ rb_grn_table_select (int argc, VALUE *argv, VALUE self)
 	result = RVAL2GRNTABLE(rb_result, &context);
     }
 
-    builder = rb_grn_record_expression_builder_new(self, rb_name);
-    if (!NIL_P(rb_query)) {
-        rb_funcall(builder, rb_intern("query="), 1, rb_query);
+    if (NIL_P(rb_expression)) {
+      builder = rb_grn_record_expression_builder_new(self, rb_name);
+      rb_funcall(builder, rb_intern("query="), 1, rb_query);
+      rb_funcall(builder, rb_intern("syntax="), 1, rb_syntax);
+      rb_funcall(builder, rb_intern("allow_pragma="), 1, rb_allow_pragma);
+      rb_funcall(builder, rb_intern("allow_column="), 1, rb_allow_column);
+      rb_funcall(builder, rb_intern("allow_update="), 1, rb_allow_update);
+      rb_expression = rb_grn_record_expression_builder_build(builder);
     }
-    rb_expression = rb_grn_record_expression_builder_build(builder);
     rb_grn_object_deconstruct(RB_GRN_OBJECT(DATA_PTR(rb_expression)),
                               &expression, NULL,
 			      NULL, NULL, NULL, NULL);
@@ -1401,10 +1891,12 @@ rb_grn_table_set_operation_bang (VALUE self, VALUE rb_other,
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
     rb_grn_table_deconstruct(SELF(rb_other), &other, NULL,
 			     NULL, NULL,
-			     NULL, NULL, NULL);
+			     NULL, NULL, NULL,
+			     NULL);
 
     rc = grn_table_setoperation(context, table, other, table, operator);
     rb_grn_context_check(context, self);
@@ -1413,33 +1905,69 @@ rb_grn_table_set_operation_bang (VALUE self, VALUE rb_other,
     return self;
 }
 
+/*
+ * call-seq:
+ *   table.union!(other) -> Groonga::Table
+ *
+ * キーを比較し、_table_には登録されていない_other_のレコー
+ * ドを_table_に作成する。
+ *
+ */
 static VALUE
 rb_grn_table_union_bang (VALUE self, VALUE rb_other)
 {
-    return rb_grn_table_set_operation_bang(self ,rb_other, GRN_OP_OR);
+    return rb_grn_table_set_operation_bang(self, rb_other, GRN_OP_OR);
 }
 
+
+/*
+ * call-seq:
+ *   table.intersection!(other) -> Groonga::Table
+ *
+ * キーを比較し、_other_には登録されていないレコードを
+ * _table_から削除する。
+ *
+ */
 static VALUE
 rb_grn_table_intersection_bang (VALUE self, VALUE rb_other)
 {
-    return rb_grn_table_set_operation_bang(self ,rb_other, GRN_OP_AND);
+    return rb_grn_table_set_operation_bang(self, rb_other, GRN_OP_AND);
 }
 
+/*
+ * call-seq:
+ *   table.difference!(other) -> Groonga::Table
+ *
+ * キーを比較し、_other_にも登録されているレコードを_table_
+ * から削除する。
+ *
+ */
 static VALUE
 rb_grn_table_difference_bang (VALUE self, VALUE rb_other)
 {
-    return rb_grn_table_set_operation_bang(self ,rb_other, GRN_OP_BUT);
+    return rb_grn_table_set_operation_bang(self, rb_other, GRN_OP_BUT);
 }
 
+/*
+ * call-seq:
+ *   table.merge!(other) -> Groonga::Table
+ *
+ * キーを比較し、_other_にも登録されている_table_のレコード
+ * のスコアを_other_のスコアと同値にする。
+ *
+ */
 static VALUE
 rb_grn_table_merge_bang (VALUE self, VALUE rb_other)
 {
-    return rb_grn_table_set_operation_bang(self ,rb_other, GRN_OP_ADJUST);
+    return rb_grn_table_set_operation_bang(self, rb_other, GRN_OP_ADJUST);
 }
 
 void
 rb_grn_init_table (VALUE mGrn)
 {
+    id_array_reference = rb_intern("[]");
+    id_array_set = rb_intern("[]=");
+
     rb_cGrnTable = rb_define_class_under(mGrn, "Table", rb_cGrnObject);
     rb_define_alloc_func(rb_cGrnTable, rb_grn_table_alloc);
 
@@ -1477,7 +2005,16 @@ rb_grn_init_table (VALUE mGrn)
     rb_define_method(rb_cGrnTable, "group", rb_grn_table_group, -1);
 
     rb_define_method(rb_cGrnTable, "[]", rb_grn_table_array_reference, 1);
-    rb_define_method(rb_cGrnTable, "[]=", rb_grn_table_array_set, 2);
+    rb_undef_method(rb_cGrnTable, "[]=");
+
+    rb_define_method(rb_cGrnTable, "value",
+		     rb_grn_table_get_value_convenience, -1);
+    rb_define_method(rb_cGrnTable, "set_value",
+		     rb_grn_table_set_value_convenience, -1);
+    rb_define_method(rb_cGrnTable, "column_value",
+		     rb_grn_table_get_column_value_convenience, -1);
+    rb_define_method(rb_cGrnTable, "set_column_value",
+		     rb_grn_table_set_column_value_convenience, -1);
 
     rb_define_method(rb_cGrnTable, "lock", rb_grn_table_lock, -1);
     rb_define_method(rb_cGrnTable, "unlock", rb_grn_table_unlock, -1);