groonga 0.0.7 → 0.9.0

data/test/test-type.rb

@@ -19,7 +19,7 @@ class TypeTest < Test::Unit::TestCase
   setup :setup_database
 
   def test_new
-    type = Groonga::Type.new("user-id", :option => :integer)
+    type = Groonga::Type.new("user-id", :type => :integer)
     assert_equal("user-id", type.name)
   end
 
@@ -46,7 +46,7 @@ class TypeTest < Test::Unit::TestCase
     assert_equal("#<Groonga::Type id: <#{Groonga::Type::LONG_TEXT}>, " +
                  "name: <LongText>, " +
                  "path: (temporary), " +
-                 "domain: <nil>, " +
+                 "domain: (nil), " +
                  "range: <2147483648>, " +
                  "flags: <>>",
                  context["<longtext>"].inspect)

data/test/test-variable-size-column.rb

@@ -25,17 +25,23 @@ class VariableSizeColumnTest < Test::Unit::TestCase
 
   def setup_users_table
     @users_path = @tables_dir + "users"
-    @users = Groonga::Array.create(:name => "users",
+    @users = Groonga::Array.create(:name => "Users",
                                    :path => @users_path.to_s)
 
     @users_name_column_path = @columns_dir + "name"
-    @name = @users.define_column("name", "<shorttext>",
+    @name = @users.define_column("name", "ShortText",
                                  :path => @users_name_column_path.to_s)
 
     @users_friends_column_path = @columns_dir + "friends"
     @friends = @users.define_column("friends", @users,
                                     :type => :vector,
                                     :path => @users_friends_column_path.to_s)
+
+    @users_nick_names_column_path = @columns_dir + "nick_names"
+    @nick_names =
+      @users.define_column("nick_names", "ShortText",
+                           :type => :vector,
+                           :path => @users_nick_names_column_path.to_s)
   end
 
   def setup_users
@@ -47,10 +53,10 @@ class VariableSizeColumnTest < Test::Unit::TestCase
   def test_inspect
     assert_equal("#<Groonga::VariableSizeColumn " +
                  "id: <#{@name.id}>, " +
-                 "name: <users.name>, " +
+                 "name: <Users.name>, " +
                  "path: <#{@users_name_column_path}>, " +
-                 "domain: <#{@users.inspect}>, " +
-                 "range: <#{context['<shorttext>'].inspect}>, " +
+                 "domain: <Users>, " +
+                 "range: <ShortText>, " +
                  "flags: <>" +
                  ">",
                  @name.inspect)
@@ -79,4 +85,14 @@ class VariableSizeColumnTest < Test::Unit::TestCase
     @morita.prepend("friends", @gunyara_kun)
     assert_equal([@gunyara_kun, @yu], @morita["friends"])
   end
+
+  def test_string_vector
+    omit("append/prepend for non table domain column " +
+         "isn't supported by groonga.")
+    assert_equal([], @morita["nick_names"])
+    @morita.append("nick_names", "morita")
+    assert_equal(["morita"], @morita["nick_names"])
+    @morita.prepend("nick_names", "moritapo")
+    assert_equal(["moritapo", "morita"], @morita["nick_names"])
+  end
 end

data/test/test-vector-column.rb

@@ -0,0 +1,76 @@
+# Copyright (C) 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
+# 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
+
+class VectorColumnTest < Test::Unit::TestCase
+  include GroongaTestUtils
+
+  def setup
+    setup_database
+    setup_tables
+  end
+
+  def setup_tables
+    Groonga::Schema.define do |schema|
+      schema.create_table("Users",
+                          :type => :hash,
+                          :key_type => "UInt32") do |table|
+      end
+
+      schema.create_table("Communities",
+                          :type => :hash,
+                          :key_type => "ShortText") do |table|
+        table.reference("users", "Users", :type => :vector)
+      end
+
+      schema.create_table("Areas",
+                          :type => :hash,
+                          :key_type => "ShortText") do |table|
+        table.reference("communities", "Communities", :type => :vector)
+      end
+    end
+
+    @users = Groonga::Context.default["Users"]
+    @communities = Groonga::Context.default["Communities"]
+    @areas = Groonga::Context.default["Areas"]
+  end
+
+  def test_set_records
+    groonga = @communities.add("groonga")
+    morita = @users.add(29)
+    groonga["users"] = [morita]
+
+    assert_equal([29], @users.collect {|record| record.key})
+    assert_equal([29], groonga["users"].collect {|record| record.key})
+  end
+
+  def test_set_nonexistent_keys
+    shinjuku = @areas.add("Shinjuku")
+    shinjuku["communities"] = ["groonga", "Senna"]
+
+    assert_equal(["groonga", "Senna"],
+                 @communities.collect {|record| record.key})
+    assert_equal(["groonga", "Senna"],
+                 shinjuku["communities"].collect {|record| record.key})
+  end
+
+  def test_set_nil
+    groonga = @communities.add("groonga")
+    assert_equal([], groonga["users"])
+    groonga["users"] = nil
+    assert_equal([], groonga["users"]) # should return nil?
+                                       # Can groonga tell us
+                                       # that the value is empty?
+  end
+end

data/{TUTORIAL.ja.rdoc → text/TUTORIAL.ja.rdoc}

@@ -50,14 +50,14 @@ groongaには以下の3種類のテーブルがあります。
   配列。主キーの存在しないテーブルです。レコードはIDによって
   識別します。
 
-ここではハッシュテーブルを利用して、<tt><items></tt>という名前のテー
-ブルを作成します。
+ここではハッシュテーブルを利用して、<tt>Items</tt>という名前のテー
+ブルを作成します。キーは文字列とします。
 
-  >> items = Groonga::Hash.create(:name => "<items>")
+  >> items = Groonga::Hash.create(:name => "Items", :key_type => "ShortText")
   => #<Groonga::Hash ...>
 
 
-これで<tt><items></tt>という名前のテーブルが作成できました。
+これで<tt>Items</tt>という名前のテーブルが作成できました。
 
 テーブルはRubyのHashのように扱えます。
 
@@ -69,7 +69,7 @@ groongaには以下の3種類のテーブルがあります。
 
 == レコードを追加する
 
-<tt><items></tt>テーブルにレコードを追加します。
+<tt>Items</tt>テーブルにレコードを追加します。
 
   >> items.add("http://ja.wikipedia.org/wiki/Ruby")
   => #<Groonga::Record ...>
@@ -91,26 +91,26 @@ groongaには以下の3種類のテーブルがあります。
 各itemのタイトル文字列を登録して、全文検索できるようにしてみ
 ましょう。
 
-まず<tt><items></tt>テーブルに+title+という名前のカラムを追加します。
+まず<tt>Items</tt>テーブルに+title+という名前のカラムを追加します。
 
-  >> title_column = items.define_column("title", "<text>")
+  >> title_column = items.define_column("title", "Text")
   => #<Groonga::VarSizeColumn ...>
 
 2番目の引数は、追加するカラムのデータ型を示しています。
-<tt><int></tt>、<tt><text></tt>、<tt><longtext></tt>等の型が基本型として用意されて
+<tt><int></tt>、<tt>Text</tt>、<tt><longtext></tt>等の型が基本型として用意されて
 います。
 
 全文検索するためには、文字列を分解して得られる各単語を格納す
-るためのテーブルを別途しなければなりません。ここでは<terms>と
+るためのテーブルを別途しなければなりません。ここではTermsと
 いう名前でテーブルを定義します。
 
-  >> terms = Groonga::Hash.create(:name => "<terms>",
-                                  :key_type => "<shorttext>",
-                                  :default_tokenizer => "<token:bigram>")
+  >> terms = Groonga::Hash.create(:name => "Terms",
+                                  :key_type => "ShortText",
+                                  :default_tokenizer => "TokenBigram")
   => #<Groonga::Hash ...>
 
 ここでは、トークナイザとして<tt>:default_tokenzier =>
-"<token:bigram>"</tt> を指定しています。トークナイザとは文字
+"TokenBigram"</tt> を指定しています。トークナイザとは文字
 列を単語に分解するオブジェクトのことです。デフォルトではトー
 クナイザは指定されていません。全文検索を利用するためにはトー
 クナイザを指定する必要があるので、ここではN-gramの一種である
@@ -121,22 +121,22 @@ N-gramを利用した全文検索では、分解したN文字とその出現位
 るかの文字数になります。groongaは1文字で分解するユニグラム、
 2文字のバイグラム、3文字のトリグラムをサポートしています。
 
-単語格納用テーブルの準備ができたので、<tt><items></tt>テーブ
+単語格納用テーブルの準備ができたので、<tt>Items</tt>テーブ
 ルの+title+カラムに対するインデックスを定義します。
 
   >> title_index_column = terms.define_index_column("item_title", items,
-						    :source => "<items>.title")
+						    :source => "Items.title")
   => #<Groonga::IndexColumn ...>
 
-少し違和感を感じるかも知れませんが、<tt><items></tt>テーブル
-のカラムに対するインデックスは、<tt><terms></tt>テーブルのカ
+少し違和感を感じるかも知れませんが、<tt>Items</tt>テーブル
+のカラムに対するインデックスは、<tt>Terms</tt>テーブルのカ
 ラムとして定義します。
 
-<tt><items></tt>にレコードが登録されると、その中に含まれる単
-語に該当するレコードが<tt><terms></tt>に自動的に追加されるよ
+<tt>Items</tt>にレコードが登録されると、その中に含まれる単
+語に該当するレコードが<tt>Terms</tt>に自動的に追加されるよ
 うになります。
 
-<tt><terms></tt>は、文書に含まれる語彙に相当する、やや特殊な
+<tt>Terms</tt>は、文書に含まれる語彙に相当する、やや特殊な
 テーブルだと言えます。しかし、他のテーブルと同様に語彙テーブ
 ルには自由にカラムを追加し、単語毎の様々な属性を管理すること
 ができます。これはある種の検索処理を行う際には非常に便利に機
@@ -157,9 +157,9 @@ N-gramを利用した全文検索では、分解したN文字とその出現位
   ["http://ja.wikipedia.org/wiki/Ruby", "http://www.ruby-lang.org/"]
 
 検索結果はGroonga::Hashで返されます。ハッシュのキーに見つかっ
-た<tt><items></tt>のレコードが入っています。上の例では
-+record.key+で<tt><items></tt>のレコードを取得して、さらにそ
-のキーを指定して（+record.key.key+）で<tt><items></tt>のキー
+た<tt>Items</tt>のレコードが入っています。上の例では
++record.key+で<tt>Items</tt>のレコードを取得して、さらにそ
+のキーを指定して（+record.key.key+）で<tt>Items</tt>のキー
 を返しています。
 
 
@@ -174,33 +174,33 @@ N-gramを利用した全文検索では、分解したN文字とその出現位
 
 http://qwik.jp/senna/senna2.files/rect4605.png
 
-まず、<tt><users></tt>テーブルを追加します。
+まず、<tt>Users</tt>テーブルを追加します。
 
-  >> users = Groonga::Hash.create(:name => "<users>",
-                                  :key_type => "<shorttext>")
+  >> users = Groonga::Hash.create(:name => "Users",
+                                  :key_type => "ShortText")
   => #<Groonga::Hash ...>
-  >> users.define_column("name", "<text>")
+  >> users.define_column("name", "Text")
   => #<Groonga::VarSizeColumn ...>
 
 
-次に、<tt><comments></tt>テーブルを追加します。
+次に、<tt>Comments</tt>テーブルを追加します。
 
-  >> comments = Groonga::Array.create(:name => "<comments>")
+  >> comments = Groonga::Array.create(:name => "Comments")
   => #<Groonga::Array ...>
   >> comments.define_column("item", items)
   => #<Groonga::FixSizeColumn ..>
   >> comments.define_column("author", users)
   => #<Groonga::FixSizeColumn ..>
-  >> comments.define_column("content", "<text>")
+  >> comments.define_column("content", "Text")
   => #<Groonga::VarSizeColumn ..>
-  >> comments.define_column("issued", "<time>")
+  >> comments.define_column("issued", "Time")
   => #<Groonga::FixSizeColumn ..>
 
-<tt><comments></tt>テーブルの+content+カラムを全文検索できる
+<tt>Comments</tt>テーブルの+content+カラムを全文検索できる
 ようにインデックスを定義します。
 
   >> terms.define_index_column("comment_content", comments,
-                               :source => "<comments>.content")
+                               :source => "Comments.content")
   => #<Groonga::IndexColumn ...>
 
 これでテーブルが定義できました。
@@ -218,20 +218,20 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 ユーザ+moritan+が、はてなダイアリーのとあるページをブックマーク
 したと想定します。
 
-まず対象のページが<tt><items></tt>テーブルに登録済かどうか調
+まず対象のページが<tt>Items</tt>テーブルに登録済かどうか調
 べます。
 
   >> items.find("http://d.hatena.ne.jp/brazil/20050829/1125321936")
   => nil
 
-未登録なのでまず当該ページを<tt><items></tt>に登録します。
+未登録なのでまず当該ページを<tt>Items</tt>に登録します。
 
   >> items.add("http://d.hatena.ne.jp/brazil/20050829/1125321936",
                :title => "[翻訳]JavaScript: 世界で最も誤解されたプログラミング言語")
   => #<Groonga::Record ...>
 
 次に、登録したitemを+item+カラムの値に指定して
-<tt><comments></tt>にレコードを登録します。
+<tt>Comments</tt>にレコードを登録します。
 
   >> comments.add(:item => "http://d.hatena.ne.jp/brazil/20050829/1125321936",
                   :author => "moritan",
@@ -258,9 +258,9 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
 +add_bookmark+は以下のような手順を実行しています。
 
-* <tt><items></tt>テーブルに該当ページのレコードがあるかどうか調べる。
+* <tt>Items</tt>テーブルに該当ページのレコードがあるかどうか調べる。
 * レコードがなければ追加する。
-* <tt><comments></tt>テーブルにレコードを登録する。
+* <tt>Comments</tt>テーブルにレコードを登録する。
 
 作成したメソッドを呼び出していくつかブックマークを登録してみ
 ましょう。
@@ -298,8 +298,8 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
 カラムへのアクセスは、カラム名を+.+で繋いで複合データ型の要素
 を再帰的に辿ることができます。（同様の出力を普通のRDBで実現す
-るためには、<tt><items></tt>テーブル、<tt><comments></tt>テー
-ブル、<tt><users></tt>テーブルのJOIN操作が必要になります。）
+るためには、<tt>Items</tt>テーブル、<tt>Comments</tt>テー
+ブル、<tt>Users</tt>テーブルのJOIN操作が必要になります。）
 
 上の式の中で、肝心の検索処理は、第一引数の式を評価する時点で
 完了していて、レコードセットオブジェクトとしてメモリに蓄積さ
@@ -330,7 +330,7 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
   >> records.group([".item"]).each do |record|
   >>   item = record.key
-  >>   p [record[".:nsubrecs"],
+  >>   p [record.n_sub_records,
   >>      item.key,
   >>      item[".title"]]
   >> end
@@ -338,9 +338,9 @@ http://qwik.jp/senna/senna2.files/rect4605.png
   [2, "http://practical-scheme.net/docs/cont-j.html", "なんでも継続"]
   [1, "http://d.hatena.ne.jp/higepon/20070815/1187192864", "末尾再帰"]
 
-+.:nsubrecs+というのはグループ化した単位に含まれるレコードの
-件数を示します。SQLで言えば、GROUP BY句を含むクエリのcount 関
-数のような働きです。
++n_sub_records+というのはグループ化した単位に含まれるレコード
+の件数を示します。SQLで言えば、GROUP BY句を含むクエリのcount
+関数のような働きです。
 
 == 少し複雑な検索
 
@@ -351,18 +351,18 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 ブックマークが大量に蓄積されるに従って、より的確に適合度を算
 出する必要性に迫られます。
 
-今のところ検索対象として利用できるのは<tt><items>.title</tt>
-と<tt><comments>.content</tt>ですが、<tt><items>.title</tt>は
+今のところ検索対象として利用できるのは<tt>Items.title</tt>
+と<tt>Comments.content</tt>ですが、<tt>Items.title</tt>は
 元ページから得られるやや信頼できる情報なのに対して、
-<tt><comments>.content</tt>はブックマークユーザが任意に設定で
+<tt>Comments.content</tt>はブックマークユーザが任意に設定で
 きる情報で、やや信憑性に乏しいと言えます。しかし、再現率を確
 保するためにはユーザのコメントも是非対象に含めたいところです。
 
 そこで、以下のようなポリシーで検索を行うことにします。
 
-* <tt><items>.title</tt>か<tt><comments>.content</tt>のいずれ
+* <tt>Items.title</tt>か<tt>Comments.content</tt>のいずれ
   かにマッチするitemを検索する。
-* ただし、<tt><items>.title</tt>にマッチしたレコードはスコア
+* ただし、<tt>Items.title</tt>にマッチしたレコードはスコア
   を10倍重み付けする。
 * 同一のitemに対して、キーワードにマッチする<tt>comment</tt>
   が複数存在した場合は、それぞれの<tt>comment</tt>のスコアの
@@ -373,7 +373,7 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
   >> ruby_comments = @comments.select {|record| record["content"] =~ "Ruby"}
   #<Groonga::Hash ..., size: <2>>
-  >> ruby_items = @items.select("*W1:50 title:%Ruby")
+  >> ruby_items = @items.select("*W1:50 title:@Ruby")
   #<Groonga::Hash ..., size: <2>>
 
 _ruby_comments_の結果をitem毎にグループ化し、_ruby_items_と
@@ -381,8 +381,8 @@ unionして出力します。
 
   >> ruby_items = ruby_comments.group([".item"]).union!(ruby_items)
   #<Groonga::Hash ..., size: <4>>
-  >> ruby_items.sort([{:key => ".:score", :order => "descendant"}]).each do |record|
-  >>   p [record[".:score"], record[".title"]]
+  >> ruby_items.sort([{:key => "._score", :order => "descendant"}]).each do |record|
+  >>   p [record["._score"], record[".title"]]
   >> end
   [1, "るびま"]
   [1, "オブジェクトスクリプト言語Ruby"]

data/text/expression.rdoc

@@ -0,0 +1,284 @@
+
+= grn式 (grn_expr)
+
+
+== 名前
+
+grn式 - 検索条件やデータベースへの操作を表現する文字列の形式。(読み方:"ぐるんしき")
+
+
+== 書式
+
+grn式はquery形式とscript形式のいずれかによって表現することができます。
+
+query形式
+
+[条件式]
+  以下の条件式が使用できます。
+
+  [文字列]
+    全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
+
+  ["文字列"]
+    フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
+
+  [カラム名:値]
+    一致条件(カラム値 == 値)
+
+  [カラム名:!値]
+    不一致条件(カラム値 != 値)
+
+  [カラム名:<値]
+    比較条件(カラム値 < 値)
+
+  [カラム名:>値]
+    比較条件(カラム値 > 値)
+
+  [カラム名:<=値]
+    比較条件(カラム値 <= 値)
+
+  [カラム名:>=値]
+    比較条件(カラム値 >= 値)
+
+  [カラム名:@文字列]
+    全文検索条件(カラム値が指定された文字列を含んでいる)
+
+[補助演算子 [1]]
+  全文検索条件の挙動を制御する以下の演算子が指定できます。
+
+  [~文字列]
+    文字列を含んでいた場合は、そのレコードのスコアを下げます。
+
+  [<文字列]
+    文字列を含んでいた場合に加算されるスコアの値を小さくします。
+
+  [>文字列]
+    文字列を含んでいた場合に加算されるスコアの値を大きくします。
+
+  [文字列*]
+    文字列に前方一致する条件を示します。
+
+  [*S[数値]"文字列"]
+    文字列と関連する文書を検索します。文字列から抽出する特徴語の数を数値に指定します。
+
+  [*N[数値]"文字列"]
+    文字列に含まれる複数の語が、近傍に含まれる文書を検索します。近傍の範囲の上限とな
+    る語数を数値に指定します。N-gramの場合は、文字数を指定します。
+
+[結合演算子]
+  複数の条件式を結合するために以下の演算子が使用できる。演算子を伴わずに複数の条件式 が空白('
+  ')区切りで指定された場合は、デフォルトの結合演算子が指定されたものとみな される。
+
+  [a OR b]
+    論理和(aとbといずれかの条件がマッチする)
+
+  [a + b]
+    論理積(aとbの両方がマッチする)
+
+  [a - b]
+    aにマッチし、bにはマッチしない
+
+  [( )]
+    複数の条件をまとめる
+
+[プラグマ [2]]
+  query形式文字列の先頭に、処理方法を指定するプラグマを埋め込むことができます。
+
+  プラグマは必ずクエリ文字列の冒頭に存在しなければなりません。(先頭に空白を入れては いけません)
+
+  一つのクエリに複数のプラグマを指定することができます。
+
+  複数のプラグマを指定する場合は、間に空白を入れてはいけません。
+
+  [*E数値1[,数値2]]
+    検索結果の数が数値1よりも小さい場合、完全一致→非わかち書き→部分一致の順に自動
+    的に検索処理方法を切り替えます。完全一致でヒットした文書と比べて非わかち書き一致、
+    部分一致でヒットした文書には数値2分だけ小さいスコアを付与します。数値2を省略した
+    場合は既定値(=2)と解釈されます。数値1に負の数を指定した場合は以下のように処理し ます。
+
+    -1
+
+    完全一致検索のみを行う
+
+    -2
+
+    非わかち書き検索のみを行う
+
+    -3
+
+    完全一致検索と非わかち書き検索のみを行う
+
+    -4
+
+    部分一致検索のみを行う
+
+    -5
+
+    完全一致検索と部分一致検索のみを行う
+
+    -6
+
+    非わかち書き検索と部分一致検索のみを行う
+
+    -7
+
+    完全一致検索,非わかち書き検索,部分一致検索の全てを行う
+
+    例:
+
+    *E10,3
+
+    検索結果数が10件以下だった場合に検索処理方法を順次切り替え、スコアを3ずつ小さ くします。
+
+  [*D演算子]
+    結合演算子の既定値(演算子を省略した場合にどの演算を行うか)を指定します。指定できる演 算子は、OR, +, - のいずれかです。
+
+    例1:
+
+    *D+ abc def
+
+    abcとdefを両方含む文書を検索します。
+
+    例2:
+
+    *DOR abc def
+
+    abcとdefのいずれかを含む文書を検索します。
+
+  [*W[数値[:重み][,数値[:重み]]...]
+    数値で指定されたセクション番号のみを対象に検索します。セクションごとに検索スコア
+    の倍数を指定することができます。重みは、省略された場合1となります。負の重みも指 定することができます。
+
+script形式 [3]
+
+ECMAScript風の構文で検索条件やレコードへの操作を記述します。
+
+式中のIDENTIFIER(識別子)は、以下のいずれかを指します。
+
+[引数名]
+  grn式が受け取る引数の名前
+
+[カラム名]
+  操作対象としているレコードのカラム名
+
+[型名・関数名・テーブル名]
+  データベースに定義された型・テーブル・関数の名前
+
+
+== 説明
+
+grn式は、検索条件やデータベースへの操作を表現するために使用される文字列の形式です。
+
+selectやloadなどのいくつかの組込コマンドや、API関数grn_table_select()などで使用されます。grn式はquery
+形式とscript形式という2種類の方式で記述することができます。query形式は、多くのweb検索エンジンなどで検索フォームにユーザが指定
+可能なクエリ文字列の書式に合わせた形式です。script形式は、ECMAScriptの構文から式(expression)以下の構文要素を抜粋
+した形式になっており、文(statement)や制御構造などは表現できません。
+
+query形式のgrn式もscript形式のgrn式も、共通の中間形式に翻訳された上で処理されますので、処理速度や効率には差違はありません。
+記述できる処理の範囲はscript形式の方がquery形式より広くなっています。たとえば更新系の操作はscript形式のみで記述できます。
+
+DB-APIレイヤでは、異なる形式で記述された複数のgrn式を結合することも可能です。
+
+
+== 例
+
+query形式でcolumn1の値が'hoge'に等しいという条件
+
+column1:hoge
+
+script形式でcolumn1の値が'hoge'に等しいという条件
+
+column1 == "hoge"
+
+
+== 構文
+
+query形式のgrn式で有効な式の構文を拡張BNF記法で示します。
+
+  query             ::= query_element
+            | ( query query_element )
+            | ( query "+" query_element )
+            | ( query "-" query_element )
+            | ( query "OR" query_element )
+  query_element     ::= STRING
+                    | ( "(" query ")" )
+                    | ( IDENTIFIER relative_operator query_element )
+  relative_operator ::= ( ":" | ":!" | ":<" | ":>" | ":<=" | ":>=" | ":@" )
+
+script形式のgrn式で有効な式の構文を拡張BNF記法で示します。
+
+  expression                   ::= assignment_expression
+  expression                   ::= ( expression "," assignment_expression )
+  assignment_expression        ::= conditional_expression
+                            | ( lefthand_side_expression assign_operator assignment_expression )
+  assign_operator              ::= ( "=" | "*=" | "/=" | "%=" | "+=" | "-=" | "<<=" | ">>=" | ">>>=" | "&=" | "^=" | "|=" )
+  conditional_expression       ::= logical_or_expression
+                             | ( logical_or_expression "?" assignment_expression ":" assignment_expression )
+  logical_or_expression        ::= logical_and_expression
+                            | ( logical_or_expression "||" logical_and_expression )
+  logical_and_expression       ::= bitwise_or_expression
+                             | ( logical_and_expression logical_and_operator bitwise_or_expression )
+  logical_and_operator         ::= ( "&&" | "&!" )
+  bitwise_or_expression        ::= bitwise_xor_expression
+                            | ( bitwise_or_expression "|" bitwise_xor_expression )
+  bitwise_xor_expression       ::= bitwise_and_expression
+                             | ( bitwise_xor_expression "^" bitwise_and_expression )
+  bitwise_and_expression       ::= equality_expression
+                             | bitwise_and_expression "&" equality_expression )
+  equality_expression          ::= relational_expression
+                          | ( equality_expression equality_operator relational_expression )
+  equality_operator            ::= ( "==" | "!=" )
+  relational_expression        ::= shift_expression
+                            | ( relational_expression relational_operator shift_expression )
+  relational_operator          ::= ( "<" | ">" | "<=" | ">=" | "in" | "@" )
+  shift_expression             ::= additive_expression
+                       | ( shift_expression shift_operator additive_expression )
+  shift_operator               ::= ( "<<" | ">>" | ">>>" )
+  additive_expression          ::= multiplicative_expression
+                          | ( additive_expression additive_operator multiplicative_expression )
+  additive_operator            ::= ( "+" | "-" )
+  multiplicative_expression    ::= unary_expression
+                                | ( multiplicative_expression multiplicative_operator unary_expression )
+  multiplicative_operator      ::= ( "*" | "/" | "%" )
+  unary_expression             ::= postfix_expression
+                       | ( unary_operator unary_expression )
+  unary_operator               ::= ( "delete" : "++" : "--" : "+" : "-" : "!" : "~" )
+  postfix_expression           ::= lefthand_side_expression
+                         | ( lefthand_side_expression postfix_operator )
+  postfix_operator             ::= ( "++" | "--" )
+  lefthand_side_expression     ::= (call_expression | member_expression)
+  call_expression              ::= member_expression arguments
+  member_expression            ::= primary_expression
+  member_expression            ::= member_expression member_expression_part
+  primary_expression           ::= object_literal
+                         | ( "(" expression ")" )
+                         | IDENTIFIER
+                         | array_literal
+                         | DECIMAL
+                         | HEX_INTEGER
+                         | STRING
+                         | "true"
+                         | "false
+                         | "null"
+  array_literal                ::= ( "[" elision "]" )
+                    | ( "[" `element_list elision` "]" )
+                    | ( "[" element_list "]" )
+  elision                      ::= "," | ( elision "," )
+  element_list                 ::= assignment_expression
+                   | ( elision assignment_expression )
+                   | ( element_list elision assignment_expression )
+  object_literal               ::= ( "{" property_name_and_value_list "}" )
+  property_name_and_value_list ::= ( property_name_and_value_list "," property_name_and_value )
+  property_name_and_value      ::= ( property_name ":" assignment_expression )
+  property_name                ::= IDENTIFIER | STRING | DECIMAL
+  member_expression_part       ::= "[" expression "]" | ( "." IDENTIFIER )
+  arguments                    ::= ( "(" argument_list ")" )
+  argument_list                ::= assignment_expression | ( argument_list "," assignment_expression )
+
+-[ 脚注 ]-
+
+[1] 補助演算子はv1.0でサポートされます。
+
+[2] プラグマはv1.0でサポートされます。
+
+[3] script形式のgrn式はv1.0でサポートされます。