rroonga 2.0.8-x86-mingw32 → 2.1.0-x86-mingw32

data/lib/groonga/query-logger.rb

@@ -0,0 +1,129 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012  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
+# License version 2.1 as published by the Free Software Foundation.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+module Groonga
+  class QueryLogger
+    module Flags
+      LABELS = {
+        COMMAND     => "command",
+        RESULT_CODE => "result_code",
+        DESTINATION => "destination",
+        CACHE       => "cache",
+        SIZE        => "size",
+        SCORE       => "score",
+      }
+
+      class << self
+        def parse(input, base_flags)
+          # TODO
+          base_flags
+        end
+
+        def label(flags)
+          labels = []
+          LABELS.each do |flag, label|
+            flags << label if (flags & flag) == flag
+          end
+          labels << "none" if labels.empty?
+          labels.join("|")
+        end
+      end
+    end
+
+    def log(flag, timestamp, info, message)
+      guard do
+        puts("#{timestamp}|#{info}#{message}")
+      end
+    end
+
+    def reopen
+    end
+
+    def fin
+    end
+
+    private
+    def guard
+      begin
+        yield
+      rescue Exception
+        $stderr.puts("#{$!.class}: #{$!.message}")
+        $stderr.puts($@)
+      end
+    end
+  end
+
+  class FileQueryLogger < QueryLogger
+    def initialize(file_name)
+      super()
+      @file = nil
+      @file_name = file_name
+    end
+
+    def reopen
+      guard do
+        return unless @file
+        @file.close
+        @file = nil
+      end
+    end
+
+    def fin
+      guard do
+        return unless @file
+        @file.close
+      end
+    end
+
+    private
+    def ensure_open
+      return if @file
+      @file = File.open(@file_name, "ab")
+    end
+
+    def puts(*arguments)
+      ensure_open
+      @file.puts(*arguments)
+      @file.flush
+    end
+  end
+
+  class CallbackQueryLogger < QueryLogger
+    def initialize(callback)
+      super()
+      @callback = callback
+    end
+
+    def log(flag, timestamp, info, message)
+      guard do
+        @callback.call(:log, flag, timestamp, info, message)
+      end
+    end
+
+    def reopen
+      guard do
+        @callback.call(:reopen)
+      end
+    end
+
+    def fin
+      guard do
+        @callback.call(:fin)
+      end
+    end
+  end
+end

data/lib/groonga/record.rb

@@ -140,6 +140,7 @@ module Groonga
         nil
       end
     end
+
     # レコードを一意に識別するための情報を返す。
     #
     # _record_ が所属するテーブルが {Groonga::Array} の場合はID
@@ -277,14 +278,9 @@ module Groonga
 
     # @private
     def methods(include_inherited=true)
-      _methods = super
-      return _methods unless include_inherited
-      columns.each do |column|
-        name = column.local_name
-        _methods << name
-        _methods << "#{name}="
-      end
-      _methods
+      original_methods = super
+      return original_methods unless include_inherited
+      (original_methods + dynamic_methods).uniq
     end
 
     # @private
@@ -313,6 +309,34 @@ module Groonga
       _column
     end
 
+    # @private
+    def dynamic_methods
+      @dynamic_methods ||= compute_dynamic_methods
+    end
+
+    def compute_dynamic_methods
+      methods = []
+
+      table = @table
+      while table
+        table.columns.each do |column|
+          name = column.local_name
+          methods << name.to_sym
+          methods << "#{name}=".to_sym
+        end
+        table = table.domain
+        break unless table.is_a?(Groonga::Table)
+      end
+
+      if private_methods.first.is_a?(String)
+        methods = methods.collect do |name|
+          name.to_s
+        end
+      end
+
+      methods
+    end
+
     def method_missing(name, *args, &block)
       if /=\z/ =~ name.to_s
         base_name = $PREMATCH

data/lib/groonga/schema.rb

@@ -187,137 +187,230 @@ module Groonga
       #
       # _options_ に指定可能な値は以下の通り。
       # @overload create_table(name, options= {:type => :array}, &block)
-      #   @param [::Hash] options The name and value
-      #     pairs. Omitted names are initialized as the default value.
-      #   @option options :force The force
+      #   @!macro [new] schema.create_table.array.options
+      #     @param [::Hash] options The name and value
+      #       pairs. Omitted names are initialized as the default value.
+      #     @option options :force The force
       #
-      #     +true+ を指定すると既存の同名のテーブルが
-      #     存在していても、強制的にテーブルを作成する。
-      #   @option options :type (:array) The type
+      #       +true+ を指定すると既存の同名のテーブルが
+      #       存在していても、強制的にテーブルを作成する。
+      #     @option options :type (:array) The type
       #
-      #     テーブルの型を指定する。
-      #     +:array+ , +:hash+ , +:patricia_trie+ ,
-      #     +:double_array_trie+ のいずれかを指定する。
-      #     (:key_typeの項も参照)
-      #   @option options [Groonga::Context] :context (Groonga::Context.default) The context
+      #       テーブルの型を指定する。
+      #       +:array+ , +:hash+ , +:patricia_trie+ ,
+      #       +:double_array_trie+ のいずれかを指定する。
+      #       (:key_typeの項も参照)
+      #     @option options [Groonga::Context] :context (Groonga::Context.default) The context
       #
-      #     スキーマ定義時に使用する {Groonga::Context} を指定する。
-      #   @option options :path The path
+      #       スキーマ定義時に使用する {Groonga::Context} を指定する。
+      #     @option options :path The path
       #
-      #     テーブルを保存するパスを指定する。
-      #     パスを指定すると永続テーブルになる。
-      #   @option options :persistent (true) The persistent
+      #       テーブルを保存するパスを指定する。
+      #       パスを指定すると永続テーブルになる。
+      #     @option options :persistent (true) The persistent
       #
-      #     テーブルを永続テーブルとする。 +:path+ を省略した場合は
-      #     パス名は自動的に作成される。デフォルトでは永続テーブルとなる。
-      #   @option options :value_type (nil) The value_type
+      #       テーブルを永続テーブルとする。 +:path+ を省略した場合は
+      #       パス名は自動的に作成される。デフォルトでは永続テーブルとなる。
+      #     @option options :value_type (nil) The value_type
       #
-      #     値の型を指定する。省略すると値のための領域を確保しない。
-      #     値を保存したい場合は必ず指定すること。
-      #   @option options :sub_records The sub_records
+      #       値の型を指定する。省略すると値のための領域を確保しない。
+      #       値を保存したい場合は必ず指定すること。
+      #     @option options :sub_records The sub_records
       #
-      #     +true+ を指定すると {Groonga::Table#group} で
-      #     グループ化したときに、 {Groonga::Record#n_sub_records} でグループに
-      #     含まれるレコードの件数を取得できる。
+      #       +true+ を指定すると {Groonga::Table#group} で
+      #       グループ化したときに、 {Groonga::Record#n_sub_records} でグループに
+      #       含まれるレコードの件数を取得できる。
+      #   @!macro schema.create_table.array.options
       #
       # @overload create_table(name, options= {:type => :hash}, &block)
-      #   @param [::Hash] options The name and value
-      #     pairs. Omitted names are initialized as the default value.
-      #   @option options :force The force
-      #
-      #     +true+ を指定すると既存の同名のテーブルが
-      #     存在していても、強制的にテーブルを作成する。
-      #   @option options :type (:array) The type
-      #
-      #     テーブルの型を指定する。
-      #     +:array+ , +:hash+ , +:patricia_trie+ ,
-      #     +:double_array_trie+ のいずれかを指定する。
-      #     (:key_typeの項も参照)
-      #   @option options [Groonga::Context] :context (Groonga::Context.default) The context
-      #
-      #     スキーマ定義時に使用する {Groonga::Context} を指定する。
-      #   @option options :path The path
-      #
-      #     テーブルを保存するパスを指定する。
-      #     パスを指定すると永続テーブルになる。
-      #   @option options :persistent (true) The persistent
-      #
-      #     テーブルを永続テーブルとする。 +:path+ を省略した場合は
-      #     パス名は自動的に作成される。デフォルトでは永続テーブルとなる。
-      #   @option options :value_type (nil) The value_type
-      #
-      #     値の型を指定する。省略すると値のための領域を確保しない。
-      #     値を保存したい場合は必ず指定すること。
-      #   @option options :sub_records The sub_records
-      #
-      #     +true+ を指定すると {Groonga::Table#group} で
-      #     グループ化したときに、 {Groonga::Record#n_sub_records} でグループに
-      #     含まれるレコードの件数を取得できる。
-      #   @option options :key_type The key_type
-      #
-      #     キーの種類を示すオブジェクトを指定する。
-      #     キーの種類には型名（"Int32"や"ShortText"など）または {Groonga::Type}
-      #     またはテーブル（ {Groonga::Array} 、 {Groonga::Hash} 、
-      #     {Groonga::PatriciaTrie} 、 {Groonga::DoubleArrayTrie} の
-      #     どれか）を指定する。 {Groonga::Type} を指定した場合は、その型が示す範囲の
-      #     値をキーとして使用する。ただし、キーの最大サイズは4096バイトで
-      #     あるため、 {Groonga::Type::TEXT} や {Groonga::Type::LONG_TEXT} は使用できない
-      #     。テーブルを指定した場合はレコードIDをキーとして使用する。
-      #     指定したテーブルの {Groonga::Record} をキーとして使用することもでき、
-      #     その場合は自動的に {Groonga::Record} からレコードIDを取得する。
-      #     省略した場合は文字列をキーとして使用する。
-      #     この場合、4096バイトまで使用可能である。
-      #   @option options :default_tokenizer The default_tokenizer
-      #
-      #     {Groonga::IndexColumn} で
-      #     使用するトークナイザを指定する。デフォルトでは
-      #     何も設定されていないので、テーブルに
-      #     {Groonga::IndexColumn} を定義する場合は @"TokenBigram"@
-      #     などを指定する必要がある。
-      #   @option options :key_normalize The key_normalize
-      #
-      #     +true+ を指定するとキーを正規化する。
+      #   @!macro [new] schema.create_table.hash.options
+      #     @param [::Hash] options The name and value
+      #       pairs. Omitted names are initialized as the default value.
+      #     @option options :force The force
+      #
+      #       +true+ を指定すると既存の同名のテーブルが
+      #       存在していても、強制的にテーブルを作成する。
+      #     @option options :type (:array) The type
+      #
+      #       テーブルの型を指定する。
+      #       +:array+ , +:hash+ , +:patricia_trie+ ,
+      #       +:double_array_trie+ のいずれかを指定する。
+      #       (:key_typeの項も参照)
+      #     @option options [Groonga::Context] :context (Groonga::Context.default) The context
+      #
+      #       スキーマ定義時に使用する {Groonga::Context} を指定する。
+      #     @option options :path The path
+      #
+      #       テーブルを保存するパスを指定する。
+      #       パスを指定すると永続テーブルになる。
+      #     @option options :persistent (true) The persistent
+      #
+      #       テーブルを永続テーブルとする。 +:path+ を省略した場合は
+      #       パス名は自動的に作成される。デフォルトでは永続テーブルとなる。
+      #     @option options :value_type (nil) The value_type
+      #
+      #       値の型を指定する。省略すると値のための領域を確保しない。
+      #       値を保存したい場合は必ず指定すること。
+      #     @option options :sub_records The sub_records
+      #
+      #       +true+ を指定すると {Groonga::Table#group} で
+      #       グループ化したときに、 {Groonga::Record#n_sub_records} でグループに
+      #       含まれるレコードの件数を取得できる。
+      #     @option options :key_type The key_type
+      #
+      #       キーの種類を示すオブジェクトを指定する。
+      #       キーの種類には型名（"Int32"や"ShortText"など）または {Groonga::Type}
+      #       またはテーブル（ {Groonga::Array} 、 {Groonga::Hash} 、
+      #       {Groonga::PatriciaTrie} 、 {Groonga::DoubleArrayTrie} の
+      #       どれか）を指定する。 {Groonga::Type} を指定した場合は、その型が示す範囲の
+      #       値をキーとして使用する。ただし、キーの最大サイズは4096バイトで
+      #       あるため、 {Groonga::Type::TEXT} や {Groonga::Type::LONG_TEXT} は使用できない
+      #       。テーブルを指定した場合はレコードIDをキーとして使用する。
+      #       指定したテーブルの {Groonga::Record} をキーとして使用することもでき、
+      #       その場合は自動的に {Groonga::Record} からレコードIDを取得する。
+      #       省略した場合は文字列をキーとして使用する。
+      #       この場合、4096バイトまで使用可能である。
+      #     @option options :default_tokenizer The default_tokenizer
+      #
+      #       {Groonga::IndexColumn} で
+      #       使用するトークナイザを指定する。デフォルトでは
+      #       何も設定されていないので、テーブルに
+      #       {Groonga::IndexColumn} を定義する場合は @"TokenBigram"@
+      #       などを指定する必要がある。
+      #
+      #     @option options :key_normalize (false) Keys are normalized
+      #       if this value is @true@.
+      #
+      #       @deprecated Use @:normalizer => "NormalizerAuto"@ instead.
+      #
+      #     @option options [String, Groonga::Procedure, nil] :normalizer
+      #       The normalizer that is used by {Groonga::IndexColumn}. You
+      #       can specify this by normalizer name as String such as
+      #       @"NormalizerAuto"@ or normalizer object.
+      #   @!macro schema.create_table.hash.options
       #
       # @overload create_table(name, options= {:type => :patricia_trie}, &block)
-      #   @param [::Hash] options The name and value
-      #     pairs. Omitted names are initialized as the default value.
-      #   @option options :force The force
-      #
-      #     +true+ を指定すると既存の同名のテーブルが
-      #     存在していても、強制的にテーブルを作成する。
-      #   @option options :type (:array) The type
-      #
-      #     テーブルの型を指定する。
-      #     +:array+ , +:hash+ , +:patricia_trie+ ,
-      #     +:double_array_trie+ のいずれかを指定する。
-      #     (:key_typeの項も参照)
-      #   @option options [Groonga::Context] :context (Groonga::Context.default) The context
-      #
-      #     スキーマ定義時に使用する {Groonga::Context} を指定する。
-      #   @option options :path The path
-      #
-      #     テーブルを保存するパスを指定する。
-      #     パスを指定すると永続テーブルになる。
-      #   @option options :persistent (true) The persistent
-      #
-      #     テーブルを永続テーブルとする。 +:path+ を省略した場合は
-      #     パス名は自動的に作成される。デフォルトでは永続テーブルとなる。
-      #   @option options :value_type (nil) The value_type
-      #
-      #     値の型を指定する。省略すると値のための領域を確保しない。
-      #     値を保存したい場合は必ず指定すること。
-      #   @option options :sub_records The sub_records
-      #
-      #     +true+ を指定すると {Groonga::Table#group} で
-      #     グループ化したときに、 {Groonga::Record#n_sub_records} でグループに
-      #     含まれるレコードの件数を取得できる。
-      #   @option options :key_normalize The key_normalize
-      #
-      #    +true+ を指定するとキーを正規化する。
-      #   @option options :key_with_sis The key_with_sis
-      #
-      #     +true+ を指定するとキーの文字列の
-      #     全suffixが自動的に登録される。
+      #   @!macro [new] schema.create_table.patricia_trie.options
+      #     @param [::Hash] options The name and value
+      #       pairs. Omitted names are initialized as the default value.
+      #     @option options :force The force
+      #
+      #       +true+ を指定すると既存の同名のテーブルが
+      #       存在していても、強制的にテーブルを作成する。
+      #     @option options :type (:array) The type
+      #
+      #       テーブルの型を指定する。
+      #       +:array+ , +:hash+ , +:patricia_trie+ ,
+      #       +:double_array_trie+ のいずれかを指定する。
+      #       (:key_typeの項も参照)
+      #     @option options [Groonga::Context] :context (Groonga::Context.default) The context
+      #
+      #       スキーマ定義時に使用する {Groonga::Context} を指定する。
+      #     @option options :path The path
+      #
+      #       テーブルを保存するパスを指定する。
+      #       パスを指定すると永続テーブルになる。
+      #     @option options :persistent (true) The persistent
+      #
+      #       テーブルを永続テーブルとする。 +:path+ を省略した場合は
+      #       パス名は自動的に作成される。デフォルトでは永続テーブルとなる。
+      #     @option options :value_type (nil) The value_type
+      #
+      #       値の型を指定する。省略すると値のための領域を確保しない。
+      #       値を保存したい場合は必ず指定すること。
+      #     @option options :sub_records The sub_records
+      #
+      #       +true+ を指定すると {Groonga::Table#group} で
+      #       グループ化したときに、 {Groonga::Record#n_sub_records} でグループに
+      #       含まれるレコードの件数を取得できる。
+      #
+      #     @option options :key_normalize (false) Keys are normalized
+      #       if this value is @true@.
+      #
+      #       @deprecated Use @:normalizer => "NormalizerAuto"@ instead.
+      #
+      #     @option options [String, Groonga::Procedure, nil] :normalizer
+      #       The normalizer that is used by {Groonga::IndexColumn}. You
+      #       can specify this by normalizer name as String such as
+      #       @"NormalizerAuto"@ or normalizer object.
+      #
+      #     @option options :key_with_sis The key_with_sis
+      #
+      #       +true+ を指定するとキーの文字列の
+      #       全suffixが自動的に登録される。
+      #   @!macro schema.create_table.patricia_trie.options
+      # @overload create_table(name, options= {:type => :double_array_trie})
+      #   :typeに:double_array_trieを使用した場合
+      #   @!macro [new] schema.create_table.double_array_trie.options
+      #     @param options [::Hash] The name and value
+      #       pairs. Omitted names are initialized as the default value.
+      #     @option options :force The force
+      #
+      #       +true+ を指定すると既存の同名のテーブルが
+      #       存在していても、強制的にテーブルを作成する。
+      #     @option options [Groonga::Context] :context The context
+      #
+      #       スキーマ定義時に使用する {Groonga::Context} を指定する。
+      #       省略した場合は {Groonga::Schema.new} で指定した
+      #       {Groonga::Context} を使用する。 {Groonga::Schema.new} で指
+      #       定していない場合は {Groonga::Context.default} を使用する。
+      #     @option options :path The path
+      #
+      #       テーブルを保存するパスを指定する。パスを指定すると
+      #       永続テーブルになる。
+      #     @option options :persistent (true) The persistent
+      #
+      #       テーブルを永続テーブルとする。 +:path:+ を省略した場
+      #       合はパス名は自動的に作成される。デフォルトでは永続
+      #       テーブルとなる。
+      #     @option options :value_type The value_type
+      #
+      #       値の型を指定する。省略すると値のための領域を確保しない。
+      #       値を保存したい場合は必ず指定すること。
+      #       参考: {Groonga::Type.new}
+      #     @option options :sub_records The sub_records
+      #
+      #       +true+ を指定すると {Groonga::Table#group} でグループ化
+      #       したときに、 {Groonga::Record#n_sub_records} でグループに
+      #       含まれるレコードの件数を取得できる。
+      #
+      #     @option options :key_normalize (false) Keys are normalized
+      #       if this value is @true@.
+      #
+      #       @deprecated Use @:normalizer => "NormalizerAuto"@ instead.
+      #
+      #     @option options :key_type The key_type
+      #
+      #       キーの種類を示すオブジェクトを指定する。
+      #       キーの種類には型名（"Int32"や"ShortText"など）または
+      #       {Groonga::Type} またはテーブル（ {Groonga::Array} 、
+      #       {Groonga::Hash} 、 {Groonga::PatriciaTrie} 、
+      #       {Groonga::DoubleArrayTrie} のどれか）を指定する。
+      #
+      #       {Groonga::Type} を指定した場合は、その型が示す範囲の
+      #       値をキーとして使用する。ただし、キーの最大サイズは
+      #       4096バイトであるため、 {Groonga::Type::TEXT} や
+      #       {Groonga::Type::LONG_TEXT} は使用できない。
+      #
+      #       テーブルを指定した場合はレコードIDをキーとして使用
+      #       する。指定したテーブルの {Groonga::Record} をキーとし
+      #       て使用することもでき、その場合は自動的に
+      #       {Groonga::Record} からレコードIDを取得する。
+      #
+      #       省略した場合は文字列をキーとして使用する。この場合、
+      #       4096バイトまで使用可能である。
+      #     @option options :default_tokenizer The default_tokenizer
+      #
+      #       {Groonga::IndexColumn} で使用するトークナイザを指定する。
+      #       デフォルトでは何も設定されていないので、テーブルに
+      #       {Groonga::IndexColumn} を定義する場合は
+      #       @"TokenBigram"@ などを指定する必要がある。
+      #
+      #     @option options [String, Groonga::Procedure, nil] :normalizer
+      #       The normalizer that is used by {Groonga::IndexColumn}. You
+      #       can specify this by normalizer name as String such as
+      #       @"NormalizerAuto"@ or normalizer object.
+      #   @!macro schema.create_table.double_array_trie.options
       def create_table(name, options={}, &block)
         define do |schema|
           schema.create_table(name, options, &block)
@@ -669,173 +762,16 @@ module Groonga
     #
     # テーブルの作成は {#define} を呼び出すまでは実行されないこ
     # とに注意すること。
-    # @overload create_table(name, options= {:type => :array})
-    #   :typeにデフォルトの:arrayを使用した場合
-    #   @param options [::Hash] The name and value
-    #     pairs. Omitted names are initialized as the default value.
-    #   @option options :force The force.
-    #
-    #     +true+ を指定すると既存の同名のテーブルが
-    #     存在していても、強制的にテーブルを作成する。
-    #   @option options :type (:array) The type
-    #
-    #     テーブルの型を指定する。
-    #     +:array+ , +:hash+ , +:patricia_trie+ ,
-    #     +:double_array_trie+ のいずれかを指定する。
-    #   @option options [Groonga::Context] :context The context.
-    #
-    #     スキーマ定義時に使用する {Groonga::Context} を指定する。
-    #     省略した場合は {Groonga::Schema.new} で指定した
-    #     {Groonga::Context} を使用する。 {Groonga::Schema.new} で指
-    #     定していない場合は {Groonga::Context.default} を使用する。
-    #   @option options :path The path
-    #
-    #     テーブルを保存するパスを指定する。パスを指定すると
-    #     永続テーブルになる。
-    #   @option options :persistent (true) The persistent
-    #
-    #     テーブルを永続テーブルとする。 +:path:+ を省略した場
-    #     合はパス名は自動的に作成される。デフォルトでは永続
-    #     テーブルとなる。
-    #   @option options :value_type The value_type
-    #
-    #     値の型を指定する。省略すると値のための領域を確保しない。
-    #     値を保存したい場合は必ず指定すること。
-    #     参考: {Groonga::Type.new}
-    #   @option options :sub_records The sub_records
-    #
-    #     +true+ を指定すると {Groonga::Table#group} でグループ化
-    #     したときに、 {Groonga::Record#n_sub_records} でグループに
-    #     含まれるレコードの件数を取得できる。
-    #
-    # @overload create_table(name, options= {:type => :hash})
-    #   :typeに:hashを使用した場合
-    #   @param options [::Hash] The name and value
-    #     pairs. Omitted names are initialized as the default value.
-    #   @option options :force The force
-    #
-    #     +true+ を指定すると既存の同名のテーブルが
-    #     存在していても、強制的にテーブルを作成する。
-    #   @option options :type (:array) The type
-    #
-    #     テーブルの型を指定する。
-    #     +:array+ , +:hash+ , +:patricia_trie+ ,
-    #     +:double_array_trie+ のいずれかを指定する。
-    #   @option options [Groonga::Context] :context The context
-    #
-    #     スキーマ定義時に使用する {Groonga::Context} を指定する。
-    #     省略した場合は {Groonga::Schema.new} で指定した
-    #     {Groonga::Context} を使用する。 {Groonga::Schema.new} で指
-    #     定していない場合は {Groonga::Context.default} を使用する。
-    #   @option options :path The path
-    #
-    #     テーブルを保存するパスを指定する。パスを指定すると
-    #     永続テーブルになる。
-    #   @option options :persistent (true) The persistent
-    #
-    #     テーブルを永続テーブルとする。 +:path:+ を省略した場
-    #     合はパス名は自動的に作成される。デフォルトでは永続
-    #     テーブルとなる。
-    #   @option options :value_type The value_type
-    #
-    #     値の型を指定する。省略すると値のための領域を確保しない。
-    #     値を保存したい場合は必ず指定すること。
-    #     参考: {Groonga::Type.new}
-    #   @option options :sub_records The sub_records
-    #
-    #     +true+ を指定すると {Groonga::Table#group} でグループ化
-    #     したときに、 {Groonga::Record#n_sub_records} でグループに
-    #     含まれるレコードの件数を取得できる。
-    #   @option options :key_type The key_type
-    #
-    #     キーの種類を示すオブジェクトを指定する。
-    #     キーの種類には型名（"Int32"や"ShortText"など）または
-    #     {Groonga::Type} またはテーブル（ {Groonga::Array} 、
-    #     {Groonga::Hash} 、 {Groonga::PatriciaTrie} 、
-    #     {Groonga::DoubleArrayTrie} のどれか）を指定する。
-    #
-    #     {Groonga::Type} を指定した場合は、その型が示す範囲の
-    #     値をキーとして使用する。ただし、キーの最大サイズは
-    #     4096バイトであるため、 {Groonga::Type::TEXT} や
-    #     {Groonga::Type::LONG_TEXT} は使用できない。
-    #
-    #     テーブルを指定した場合はレコードIDをキーとして使用
-    #     する。指定したテーブルの {Groonga::Record} をキーとし
-    #     て使用することもでき、その場合は自動的に
-    #     {Groonga::Record} からレコードIDを取得する。
-    #
-    #     省略した場合は文字列をキーとして使用する。この場合、
-    #     4096バイトまで使用可能である。
-    #
-    #   @option options :default_tokenizer The default_tokenizer
-    #
-    #     {Groonga::IndexColumn} で使用するトークナイザを指定する。
-    #     デフォルトでは何も設定されていないので、テーブルに
-    #     {Groonga::IndexColumn} を定義する場合は
-    #     @"TokenBigram"@ などを指定する必要がある。
     #
+    # @overload create_table(name, options= {:type => :array}, &block)
+    #   @!macro schema.create_table.array.options
+    # @overload create_table(name, options= {:type => :hash}, &block)
+    #   @!macro schema.create_table.hash.options
+    # @overload create_table(name, options= {:type => :patricia_trie}, &block)
+    #   @!macro schema.create_table.patricia_trie.options
     # @overload create_table(name, options= {:type => :double_array_trie})
     #   :typeに:double_array_trieを使用した場合
-    #   @param options [::Hash] The name and value
-    #     pairs. Omitted names are initialized as the default value.
-    #   @option options :force The force
-    #
-    #     +true+ を指定すると既存の同名のテーブルが
-    #     存在していても、強制的にテーブルを作成する。
-    #   @option options [Groonga::Context] :context The context
-    #
-    #     スキーマ定義時に使用する {Groonga::Context} を指定する。
-    #     省略した場合は {Groonga::Schema.new} で指定した
-    #     {Groonga::Context} を使用する。 {Groonga::Schema.new} で指
-    #     定していない場合は {Groonga::Context.default} を使用する。
-    #   @option options :path The path
-    #
-    #     テーブルを保存するパスを指定する。パスを指定すると
-    #     永続テーブルになる。
-    #   @option options :persistent (true) The persistent
-    #
-    #     テーブルを永続テーブルとする。 +:path:+ を省略した場
-    #     合はパス名は自動的に作成される。デフォルトでは永続
-    #     テーブルとなる。
-    #   @option options :value_type The value_type
-    #
-    #     値の型を指定する。省略すると値のための領域を確保しない。
-    #     値を保存したい場合は必ず指定すること。
-    #     参考: {Groonga::Type.new}
-    #   @option options :sub_records The sub_records
-    #
-    #     +true+ を指定すると {Groonga::Table#group} でグループ化
-    #     したときに、 {Groonga::Record#n_sub_records} でグループに
-    #     含まれるレコードの件数を取得できる。
-    #   @option options :key_normalize The key_normalize
-    #
-    #     +true+ を指定するとキーを正規化する。
-    #   @option options :key_type The key_type
-    #
-    #     キーの種類を示すオブジェクトを指定する。
-    #     キーの種類には型名（"Int32"や"ShortText"など）または
-    #     {Groonga::Type} またはテーブル（ {Groonga::Array} 、
-    #     {Groonga::Hash} 、 {Groonga::PatriciaTrie} 、
-    #     {Groonga::DoubleArrayTrie} のどれか）を指定する。
-    #
-    #     {Groonga::Type} を指定した場合は、その型が示す範囲の
-    #     値をキーとして使用する。ただし、キーの最大サイズは
-    #     4096バイトであるため、 {Groonga::Type::TEXT} や
-    #     {Groonga::Type::LONG_TEXT} は使用できない。
-    #
-    #     テーブルを指定した場合はレコードIDをキーとして使用
-    #     する。指定したテーブルの {Groonga::Record} をキーとし
-    #     て使用することもでき、その場合は自動的に
-    #     {Groonga::Record} からレコードIDを取得する。
-    #
-    #     省略した場合は文字列をキーとして使用する。この場合、
-    #     4096バイトまで使用可能である。
-    #   @option options :default_tokenizer The default_tokenizer
-    #
-    #     {Groonga::IndexColumn} で使用するトークナイザを指定する。
-    #     デフォルトでは何も設定されていないので、テーブルに
-    #     {Groonga::IndexColumn} を定義する場合は
-    #     @"TokenBigram"@ などを指定する必要がある。
+    #   @!macro schema.create_table.double_array_trie.options
     def create_table(name, options={})
       definition = TableDefinition.new(name, @options.merge(options || {}))
       yield(definition) if block_given?
@@ -1420,7 +1356,8 @@ module Groonga
                                :key_type, :value_type, :sub_records,
                                :default_tokenizer,
                                :key_normalize, :key_with_sis,
-                               :named_path]
+                               :named_path,
+                               :normalizer]
       # @private
       def validate_options(options)
         return if options.nil?
@@ -1463,6 +1400,7 @@ module Groonga
           :key_type => normalize_key_type(@options[:key_type] || "ShortText"),
           :key_normalize => @options[:key_normalize],
           :default_tokenizer => normalize_type(@options[:default_tokenizer]),
+          :normalizer => normalize_type(@options[:normalizer]),
         }
 
         if @table_type == Groonga::Array
@@ -1536,9 +1474,10 @@ module Groonga
           default_tokenizer = normalize_type(options[:default_tokenizer])
           default_tokenizer = resolve_name(default_tokenizer)
           return false unless table.default_tokenizer == default_tokenizer
-          key_normalize = options[:key_normalize]
-          key_normalize = false if key_normalize.nil?
-          return false unless table.normalize_key? == key_normalize
+          normalizer = normalize_type(options[:normalizer])
+          normalizer ||= default_normalizer_name if options[:key_normalize]
+          normalizer = resolve_name(normalizer)
+          return false unless table.normalizer == normalizer
           if table.is_a?(Groonga::PatriciaTrie)
             key_with_sis = options[:key_with_sis]
             key_with_sis = false if key_with_sis.nil?
@@ -1550,6 +1489,10 @@ module Groonga
         end
       end
 
+      def default_normalizer_name
+        "NormalizerAuto"
+      end
+
       def normalize_key_type(key_type)
         normalize_type(key_type || "ShortText")
       end