RubyGems - rroonga - Versions diffs - 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32 - Mend

rroonga 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (398) hide show

data/vendor/local/share/doc/groonga/ja/html/commands/select.html CHANGED Viewed

@@ -9,7 +9,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.3.17. select &mdash; groonga v2.0.0ドキュメント</title>
+    <title>7.3.17. select &mdash; groonga v2.0.1ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -17,7 +17,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '2.0.0',
+        VERSION:     '2.0.1',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -28,7 +28,7 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <script type="text/javascript" src="../_static/translations.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="groonga v2.0.0ドキュメント" href="../index.html" />
+    <link rel="top" title="groonga v2.0.1ドキュメント" href="../index.html" />
     <link rel="up" title="7.3. コマンド" href="../commands.html" />
     <link rel="next" title="7.3.18. shutdown" href="shutdown.html" />
     <link rel="prev" title="7.3.16. quit" href="quit.html" />
@@ -63,7 +63,7 @@
         <li class="right" >
           <a href="quit.html" title="7.3.16. quit"
              accesskey="P">前へ</a> |</li>
-        <li><a href="../index.html">groonga v2.0.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">groonga v2.0.1ドキュメント</a> &raquo;</li>
           <li><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
           <li><a href="../commands.html" accesskey="U">7.3. コマンド</a> &raquo;</li>
       </ul>
@@ -76,157 +76,558 @@
   <div class="section" id="select">
 <h1>7.3.17. select<a class="headerlink" href="#select" title="このヘッドラインへのパーマリンク">¶</a></h1>
-<div class="section" id="id1">
-<h2>7.3.17.1. 名前<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>select - テーブルの中から条件にマッチするレコードを検索して出力する</p>
-</div>
-<div class="section" id="id2">
-<h2>7.3.17.2. 書式<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<div class="highlight-none"><div class="highlight"><pre>select table [match_columns [query [filter [scorer [sortby [output_columns
-             [offset [limit [drilldown [drilldown_sortby [drilldown_output_columns
-             [drilldown_offset [drilldown_limit [cache
-             [match_escalation_threshold [query_expansion]]]]]]]]]]]]]]]]
+<div class="section" id="summary">
+<h2>7.3.17.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p><tt class="docutils literal"><span class="pre">select</span></tt> はテーブルから指定された条件にマッチするレコードを検索し、見つかったレコードを出力します。</p>
+<p><tt class="docutils literal"><span class="pre">select</span></tt> は最も重要なgroongaのコマンドです。groongaの力を最大限に活かすためには <tt class="docutils literal"><span class="pre">select</span></tt> を理解する必要があります。</p>
+</div>
+<div class="section" id="syntax">
+<h2>7.3.17.2. 構文<a class="headerlink" href="#syntax" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p><tt class="docutils literal"><span class="pre">select</span></tt> には多くの引数があります。必須の引数は <tt class="docutils literal"><span class="pre">table</span></tt> だけで、残りは省略できます。:</p>
+<div class="highlight-none"><div class="highlight"><pre>select table
+       [match_columns=null]
+       [query=null]
+       [filter=null]
+       [scorer=null]
+       [sortby=null]
+       [output_columns=&quot;_id, _key, *&quot;]
+       [offset=0]
+       [limit=10]
+       [drilldown=null]
+       [drilldown_sortby=null]
+       [drilldown_output_columns=null]
+       [drilldown_offset=0]
+       [drilldown_limit=10]
+       [cache=yes]
+       [match_escalation_threshold=0]
+       [query_expansion=null]
 </pre></div>
 </div>
 </div>
-<div class="section" id="id3">
-<h2>7.3.17.3. 説明<a class="headerlink" href="#id3" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>groonga組込コマンドの一つであるselectについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。</p>
-<p>selectは、使用しているデータベースのテーブルの中から条件にマッチするレコードを検索して出力します。</p>
+<div class="section" id="usage">
+<h2>7.3.17.3. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>例を使いながら <tt class="docutils literal"><span class="pre">select</span></tt> の使い方を学びましょう。このセクションではよく使われる使い方を紹介します。</p>
+<p>使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create Entries TABLE_HASH_KEY ShortText
+[[0,1335594537.43378,0.000381708145141602],true]
+&gt; column_create Entries content COLUMN_SCALAR Text
+[[0,1335594537.63582,0.000931501388549805],true]
+&gt; table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
+[[0,1335594537.83776,0.000288009643554688],true]
+&gt; column_create Terms entries_key_index COLUMN_INDEX|WITH_POSITION Entries _key
+[[0,1335594538.03901,0.0059964656829834],true]
+&gt; column_create Terms entries_content_index COLUMN_INDEX|WITH_POSITION Entries content
+[[0,1335594538.24584,0.00617790222167969],true]
+&gt; load --table Entries
+&gt; [
+&gt; {&quot;_key&quot;: &quot;The first post!&quot;, &quot;content&quot;: &quot;Welcome! This is my first post!&quot;},
+&gt; {&quot;_key&quot;: &quot;Groonga&quot;, &quot;content&quot;: &quot;I started to use groonga. It&#39;s very fast!&quot;}
+&gt; {&quot;_key&quot;: &quot;Mroonga&quot;, &quot;content&quot;: &quot;I also started to use mroonga. It&#39;s also very fast! Really fast!&quot;}
+&gt; ]
+</pre></div>
 </div>
-<div class="section" id="id4">
-<h2>7.3.17.4. 引数<a class="headerlink" href="#id4" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><tt class="docutils literal"><span class="pre">table</span></tt></p>
-<blockquote>
-<div>検索対象のテーブルを指定します。存在しないテーブルを指定した場合はエラーになります。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">match_columns</span></tt></p>
-<blockquote>
-<div><p>query引数に指定する検索条件文字列でデフォルトの検索対象となるカラムを指定します。</p>
-<blockquote>
-<div>カラム名</div></blockquote>
-<p>カラム名の後ろに'* 数値'を指定することによって、そのカラムにヒットした際のスコアに積算される重みを指定することができます。</p>
-<blockquote>
-<div>カラム名 * 重み</div></blockquote>
-<p>複数のカラムを'||'で結合して指定することもできます。</p>
-<blockquote>
-<div>カラム名1 * 重み1 || カラム名2 * 重み2</div></blockquote>
-<p>また、カラム名ではなく、検索に使用するインデックス名を指定することもできます。</p>
-</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">query</span></tt></p>
-<blockquote>
-<div>以下の形式の文字列によって検索条件を指定します。</div></blockquote>
-<div class="section" id="id5">
-<h3>7.3.17.4.1. 条件式<a class="headerlink" href="#id5" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p>以下の条件式が使用できます。</p>
-<dl class="docutils">
-<dt>文字列</dt>
-<dd>全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)</dd>
-<dt>&quot;文字列&quot;</dt>
-<dd>フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)</dd>
-<dt>カラム名:値</dt>
-<dd>一致条件(カラム値 == 値)</dd>
-<dt>カラム名:!値</dt>
-<dd>不一致条件(カラム値 != 値)</dd>
-<dt>カラム名:&lt;値</dt>
-<dd>比較条件(カラム値 &lt; 値)</dd>
-<dt>カラム名:&gt;値</dt>
-<dd>比較条件(カラム値 &gt; 値)</dd>
-<dt>カラム名:&lt;=値</dt>
-<dd>比較条件(カラム値 &lt;= 値)</dd>
-<dt>カラム名:&gt;=値</dt>
-<dd>比較条件(カラム値 &gt;= 値)</dd>
-<dt>カラム名:&#64;文字列</dt>
-<dd>全文検索条件(カラム値が指定された文字列を含んでいる)</dd>
-</dl>
-</div>
-<div class="section" id="id6">
-<h3>7.3.17.4.2. 結合演算子<a class="headerlink" href="#id6" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p>複数の条件式を結合するために以下の演算子が使用できます。</p>
-<dl class="docutils">
-<dt>a OR b</dt>
-<dd>論理和(aとbといずれかの条件がマッチする)</dd>
-<dt>a + b</dt>
-<dd>論理積(aとbの両方がマッチする)</dd>
-<dt>a - b</dt>
-<dd>aにマッチし、bにはマッチしない</dd>
-<dt>( )</dt>
-<dd>複数の条件をまとめる</dd>
-</dl>
-<p><tt class="docutils literal"><span class="pre">filter</span></tt></p>
-<blockquote>
-<div><p>絞り込み条件をscript形式のgrn_expr文字列によって指定します。</p>
-<p>query引数とfilter引数をどちらも指定した場合は、両方の条件を満足するレコードのみがヒットします。どちらも指定しない場合は全件がヒットします。</p>
-</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">scorer</span></tt></p>
+<p>ブログエントリ用の <tt class="docutils literal"><span class="pre">Entries</span></tt> テーブルがあります。各エントリはタイトルと内容を持っています。タイトルは <tt class="docutils literal"><span class="pre">Entries</span></tt> のキーとします。内容は <tt class="docutils literal"><span class="pre">Entries.content</span></tt> カラムの値とします。</p>
+<p><tt class="docutils literal"><span class="pre">Entries._key</span></tt> カラムと <tt class="docutils literal"><span class="pre">Entries.content</span></tt> カラムには <tt class="docutils literal"><span class="pre">TokenBigram</span></tt> トークナイザーを使ってのインデックスを作成します。そのため、 <tt class="docutils literal"><span class="pre">Entries._key</span></tt> と <tt class="docutils literal"><span class="pre">Entries.content</span></tt> は両方とも全文検索できます。</p>
+<p>これで例を示すためのスキーマとデータの準備ができました。</p>
+<div class="section" id="simple-usage">
+<h3>7.3.17.3.1. 簡単な使い方<a class="headerlink" href="#simple-usage" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>上記のスキーマとデータを使った一番簡単な使い方を示します。この例では <tt class="docutils literal"><span class="pre">Entries</span></tt> テーブルのすべてのレコードを出力します。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries
+[
+  [
+    0,
+    1335519592.67133,
+    0.000493049621582031
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          &quot;_id&quot;,
+          &quot;UInt32&quot;
+        ],
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;content&quot;,
+          &quot;Text&quot;
+        ]
+      ],
+      [
+        1,
+        &quot;The first post!&quot;,
+        &quot;Welcome! This is my first post!&quot;
+      ],
+      [
+        2,
+        &quot;Groonga&quot;,
+        &quot;I started to use groonga. It&#39;s very fast!&quot;
+      ],
+      [
+        3,
+        &quot;Mroonga&quot;,
+        &quot;I also started to use mroonga. It&#39;s also very fast! Really fast!&quot;
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p>どうしてこのコマンドがすべてのレコードを出力するのでしょうか？理由は2つです。1つ目の理由はこのコマンドが検索条件を何も指定していないからです。検索条件を指定しないとすべてのレコードがマッチします。2つ目の理由は全レコード数が2だからです。 <tt class="docutils literal"><span class="pre">select</span></tt> コマンドはデフォルトでは最大10レコードを出力します。この例では3レコードしかありません。これは10よりも少ないのですべてのレコードを出力します。</p>
+</div>
+<div class="section" id="search-conditions">
+<h3>7.3.17.3.2. 検索条件<a class="headerlink" href="#search-conditions" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>検索条件は <tt class="docutils literal"><span class="pre">query</span></tt> または <tt class="docutils literal"><span class="pre">filter</span></tt> で指定します。 <tt class="docutils literal"><span class="pre">query</span></tt> と <tt class="docutils literal"><span class="pre">filter</span></tt> を両方指定することもできます。この場合は <tt class="docutils literal"><span class="pre">query</span></tt> と <tt class="docutils literal"><span class="pre">filter</span></tt> の両方の条件にマッチしたレコードが出力されます。</p>
+<div class="section" id="search-condition-query">
+<h4>7.3.17.3.2.1. 検索条件: <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#search-condition-query" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p><tt class="docutils literal"><span class="pre">query</span></tt> はWebページの検索ボックス用に用意されています。例えば、google.co.jpにあるような検索ボックスです。 <tt class="docutils literal"><span class="pre">query</span></tt> の検索条件はスペース区切りでキーワードを指定します。例えば、 <tt class="docutils literal"><span class="pre">検索</span> <span class="pre">エンジン</span></tt> は <tt class="docutils literal"><span class="pre">検索</span></tt> と <tt class="docutils literal"><span class="pre">エンジン</span></tt> という2つのキーワードを含むレコードを検索します。</p>
+<p>通常は <tt class="docutils literal"><span class="pre">query</span></tt> パラメータは全文検索条件を指定するために使います。全文検索条件以外も指定できますが、その用途には <tt class="docutils literal"><span class="pre">filter</span></tt> パラメータの方が向いています。</p>
+<p><tt class="docutils literal"><span class="pre">query</span></tt> パラメータで全文検索条件を指定する場合は、 <tt class="docutils literal"><span class="pre">match_columns</span></tt> パラメータと一緒に使います。 <tt class="docutils literal"><span class="pre">match_columns</span></tt> はどのカラムまたはインデックスを使って <tt class="docutils literal"><span class="pre">query</span></tt> を検索するかを指定します。</p>
+<p>以下は簡単な <tt class="docutils literal"><span class="pre">query</span></tt> の使用例です。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --match_columns content --query fast
+[
+  [
+    0,
+    1335519592.87374,
+    0.000868797302246094
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          &quot;_id&quot;,
+          &quot;UInt32&quot;
+        ],
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;content&quot;,
+          &quot;Text&quot;
+        ]
+      ],
+      [
+        2,
+        &quot;Groonga&quot;,
+        &quot;I started to use groonga. It&#39;s very fast!&quot;
+      ],
+      [
+        3,
+        &quot;Mroonga&quot;,
+        &quot;I also started to use mroonga. It&#39;s also very fast! Really fast!&quot;
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p>この <tt class="docutils literal"><span class="pre">select</span></tt> コマンドは <tt class="docutils literal"><span class="pre">Entries</span></tt> テーブルの中から <tt class="docutils literal"><span class="pre">content</span></tt> カラムの値に <tt class="docutils literal"><span class="pre">fast</span></tt> を含んでいるレコードを検索します。</p>
+<p><tt class="docutils literal"><span class="pre">query</span></tt> はクエリ構文という構文を使いますが、詳細はここでは説明しません。詳細は <a class="reference internal" href="../spec/query_syntax.html"><em>クエリ構文</em></a> を参照してください。</p>
+</div>
+<div class="section" id="search-condition-filter">
+<h4>7.3.17.3.2.2. 検索条件: <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#search-condition-filter" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p><tt class="docutils literal"><span class="pre">filter</span></tt> は複雑な検索条件を指定するために用意されています。ECMAScriptのような構文で  <tt class="docutils literal"><span class="pre">filter</span></tt> に検索条件を指定します。</p>
+<p>以下は簡単な <tt class="docutils literal"><span class="pre">filter</span></tt> の使用例です。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --filter &#39;content @ &quot;fast&quot; &amp;&amp; _key == &quot;Groonga&quot;&#39;
+[
+  [
+    0,
+    1335520300.98383,
+    0.000544071197509766
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          &quot;_id&quot;,
+          &quot;UInt32&quot;
+        ],
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;content&quot;,
+          &quot;Text&quot;
+        ]
+      ],
+      [
+        2,
+        &quot;Groonga&quot;,
+        &quot;I started to use groonga. It&#39;s very fast!&quot;
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p>この <tt class="docutils literal"><span class="pre">select</span></tt> コマンドは <tt class="docutils literal"><span class="pre">Entries</span></tt> テーブルの中の <tt class="docutils literal"><span class="pre">content</span></tt> カラムの値に <tt class="docutils literal"><span class="pre">fast</span></tt> という単語を含んでいて、かつ、 <tt class="docutils literal"><span class="pre">_key</span></tt> が <tt class="docutils literal"><span class="pre">Groonga</span></tt> のレコードを検索します。このコマンドの中には <tt class="docutils literal"><span class="pre">&#64;</span></tt> と <tt class="docutils literal"><span class="pre">&amp;&amp;</span></tt> と <tt class="docutils literal"><span class="pre">==</span></tt> という3つの演算子があります。 <tt class="docutils literal"><span class="pre">&#64;</span></tt> は全文検索用の演算子です。 <tt class="docutils literal"><span class="pre">&amp;&amp;</span></tt> と <tt class="docutils literal"><span class="pre">==</span></tt> はECMAScriptと同じ意味です。 <tt class="docutils literal"><span class="pre">&amp;&amp;</span></tt> が論理和用の演算子で <tt class="docutils literal"><span class="pre">==</span></tt> が等価演算子です。</p>
+<p><tt class="docutils literal"><span class="pre">filter</span></tt> にはもっと演算子や構文があります。例えば、 <tt class="docutils literal"><span class="pre">(...)</span></tt> を使った検索条件のグループ化などです。しかし、ここでは詳細は説明しません。詳細は <a class="reference internal" href="../spec/script_syntax.html"><em>スクリプト構文</em></a> を参照してください。</p>
+</div>
+</div>
+<div class="section" id="paging">
+<h3>7.3.17.3.3. ページング<a class="headerlink" href="#paging" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><tt class="docutils literal"><span class="pre">offset</span></tt> と <tt class="docutils literal"><span class="pre">limit</span></tt> を指定することで出力されるレコードの範囲を指定できます。以下は2番目のレコードだけを出力する例です。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --offset 1 --limit 1
+[
+  [
+    0,
+    1335519593.28077,
+    0.000288248062133789
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          &quot;_id&quot;,
+          &quot;UInt32&quot;
+        ],
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;content&quot;,
+          &quot;Text&quot;
+        ]
+      ],
+      [
+        2,
+        &quot;Groonga&quot;,
+        &quot;I started to use groonga. It&#39;s very fast!&quot;
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p><tt class="docutils literal"><span class="pre">offset</span></tt> は0基点です。 <tt class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></tt> は2番目以降のレコードを出力するという意味になります。</p>
+<p><tt class="docutils literal"><span class="pre">limit</span></tt> は出力レコード数の最大値を指定します。 <tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">1</span></tt> は多くても1レコードを出力するという意味になります。もし、1つもレコードがマッチしていなければ <tt class="docutils literal"><span class="pre">select</span></tt> コマンドはどのレコードも出力しません。</p>
+</div>
+<div class="section" id="the-total-number-of-records">
+<h3>7.3.17.3.4. 全レコード数<a class="headerlink" href="#the-total-number-of-records" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></tt> を使うとレコードの内容は取得せずに全レコード数だけを取得できます。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --limit 0
+[
+  [
+    0,
+    1335519593.48351,
+    0.000329017639160156
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          &quot;_id&quot;,
+          &quot;UInt32&quot;
+        ],
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;content&quot;,
+          &quot;Text&quot;
+        ]
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p><tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></tt> はマッチしたレコード数だけを取得したいときにも便利です。</p>
+</div>
+</div>
+<div class="section" id="parameters">
+<h2>7.3.17.4. 引数<a class="headerlink" href="#parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このセクションではすべての引数について説明します。引数はカテゴリわけしています。</p>
+<div class="section" id="required-parameter">
+<h3>7.3.17.4.1. 必須引数<a class="headerlink" href="#required-parameter" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><tt class="docutils literal"><span class="pre">table</span></tt> だけが必須の引数です。</p>
+<div class="section" id="table">
+<h4>7.3.17.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt><a class="headerlink" href="#table" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>検索対象のテーブルを指定します。 <tt class="docutils literal"><span class="pre">table</span></tt> は必ず指定しなければいけません。</p>
+<p>存在しないテーブルを指定するとエラーが返ります。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Nonexistent
+[
+  [
+    -22,
+    1335519593.68574,
+    0.000583171844482422,
+    &quot;invalid table name: &lt;Nonexistent&gt;&quot;,
+    [
+      [
+        &quot;grn_select&quot;,
+        &quot;proc.c&quot;,
+        542
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="search-related-parameters">
+<h3>7.3.17.4.2. 検索関係の引数<a class="headerlink" href="#search-related-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>検索関係の引数がいくつかあります。一般的には、検索ボックスを実装するために <tt class="docutils literal"><span class="pre">match_columns</span></tt> と <tt class="docutils literal"><span class="pre">query</span></tt> 引数を使い、複雑な検索機能を実装するために <tt class="docutils literal"><span class="pre">filter</span></tt> 引数を使います。</p>
+<p><tt class="docutils literal"><span class="pre">query</span></tt> と <tt class="docutils literal"><span class="pre">filter</span></tt> を指定した場合は、 <tt class="docutils literal"><span class="pre">query</span></tt> と <tt class="docutils literal"><span class="pre">filter</span></tt> にマッチしたレコードが選択されます。 <tt class="docutils literal"><span class="pre">query</span></tt> と <tt class="docutils literal"><span class="pre">filter</span></tt> のどちらも指定しなかった場合はすべてのレコードが選択されます。</p>
+<div class="section" id="match-columns">
+<h4>7.3.17.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt><a class="headerlink" href="#match-columns" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p><tt class="docutils literal"><span class="pre">query</span></tt> 引数の値で全文検索をするときに使うデフォルトの検索対象カラムを指定します。全文検索対象のカラムは <tt class="docutils literal"><span class="pre">query</span></tt> 引数でも指定できます。検索対象カラムを <tt class="docutils literal"><span class="pre">match_columns</span></tt> で指定する場合と <tt class="docutils literal"><span class="pre">query</span></tt> で指定する場合の違いは重みを指定できるかどうかです。 <tt class="docutils literal"><span class="pre">match_columns</span></tt> では重みを指定できますが、 <tt class="docutils literal"><span class="pre">query</span></tt> では指定できません。</p>
+<p>重みは検索対象カラムの相対的な重要度です。重みの大きい検索対象カラムでマッチした場合は小さい検索対象カラムでマッチした場合よりも多くのヒットスコアがつきます。デフォルトの重みは1です。</p>
+<p>以下は簡単な <tt class="docutils literal"><span class="pre">match_columns</span></tt> の使用例です。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --match_columns content --query fast --output_columns &#39;_key, _score&#39;
+[
+  [
+    0,
+    1335519593.88754,
+    0.000384092330932617
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;_score&quot;,
+          &quot;Int32&quot;
+        ]
+      ],
+      [
+        &quot;Groonga&quot;,
+        1
+      ],
+      [
+        &quot;Mroonga&quot;,
+        2
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p><tt class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">content</span></tt> はデフォルトの全文検索対象カラムに <tt class="docutils literal"><span class="pre">content</span></tt> カラムを使用し、その重みは1、という意味になります。 <tt class="docutils literal"><span class="pre">--output_columns</span> <span class="pre">'_key,</span> <span class="pre">_score'</span></tt> はこの <tt class="docutils literal"><span class="pre">select</span></tt> コマンドがマッチしたレコードの <tt class="docutils literal"><span class="pre">_key</span></tt> の値と <tt class="docutils literal"><span class="pre">_score</span></tt> の値を出力する、ということを指定しています。</p>
+<p><tt class="docutils literal"><span class="pre">_score</span></tt> の値に注目してください。 <tt class="docutils literal"><span class="pre">_score</span></tt> の値は <tt class="docutils literal"><span class="pre">query</span></tt> 引数の値に何個マッチしたかになっています。この例では、 <tt class="docutils literal"><span class="pre">query</span></tt> 引数の値は <tt class="docutils literal"><span class="pre">fast</span></tt> です。 <tt class="docutils literal"><span class="pre">_score</span></tt> の値が1ということは <tt class="docutils literal"><span class="pre">content</span></tt> カラムの中に <tt class="docutils literal"><span class="pre">fast</span></tt> が1つだけあるということです。 <tt class="docutils literal"><span class="pre">_score</span></tt> の値が2ということは <tt class="docutils literal"><span class="pre">content</span></tt> カラムの中に <tt class="docutils literal"><span class="pre">fast</span></tt> が2つあるということです。</p>
+<p>重みを指定するためには <tt class="docutils literal"><span class="pre">column</span> <span class="pre">*</span> <span class="pre">weight</span></tt> という構文を使います。以下は重みの使用例です。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --match_columns &#39;content * 2&#39; --query fast --output_columns &#39;_key, _score&#39;
+[
+  [
+    0,
+    1335519594.08917,
+    0.0003814697265625
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;_score&quot;,
+          &quot;Int32&quot;
+        ]
+      ],
+      [
+        &quot;Groonga&quot;,
+        2
+      ],
+      [
+        &quot;Mroonga&quot;,
+        4
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p><tt class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'content</span> <span class="pre">*</span> <span class="pre">2'</span></tt> はデフォルトの全文検索用カラムとして <tt class="docutils literal"><span class="pre">content</span></tt> カラムを使い、その重みは2という意味です。</p>
+<p><tt class="docutils literal"><span class="pre">_score</span></tt> の値に注目してください。 <tt class="docutils literal"><span class="pre">_score</span></tt> の値が2倍になっています。これは重みを2にしたからです。</p>
+<p>デフォルトの全文検索対象カラムとして複数のカラムを指定することができます。複数のカラムを指定した場合はすべてのカラムに対して全文検索が行われ、ヒットスコアが積算されます。つまり、 <tt class="docutils literal"><span class="pre">query</span></tt> 引数の値がどれか1つでも全文検索対象カラムにマッチしたら、そのレコードはマッチしたものとして扱われます。</p>
+<p>複数のカラムを指定するには <tt class="docutils literal"><span class="pre">column1</span> <span class="pre">*</span> <span class="pre">weight1</span> <span class="pre">||</span> <span class="pre">column2</span> <span class="pre">*</span> <span class="pre">weight2</span> <span class="pre">||</span> <span class="pre">...</span></tt> という構文を追加います。 <tt class="docutils literal"><span class="pre">*</span> <span class="pre">weight</span></tt> は省略することができます。省略した場合は重みが1になります。以下は複数カラムの使用例です。</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select Entries --match_columns &#39;_key * 10 || content&#39; --query groonga --output_columns &#39;_key, _score&#39;
+[
+  [
+    0,
+    1335594540.29792,
+    0.000547885894775391
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          &quot;_key&quot;,
+          &quot;ShortText&quot;
+        ],
+        [
+          &quot;_score&quot;,
+          &quot;Int32&quot;
+        ]
+      ],
+      [
+        &quot;Groonga&quot;,
+        11
+      ]
+    ]
+  ]
+]
+</pre></div>
+</div>
+<p><tt class="docutils literal"><span class="pre">--match_columns</span> <span class="pre">'_key</span> <span class="pre">*</span> <span class="pre">10</span> <span class="pre">||</span> <span class="pre">content'</span></tt> はデフォルト検索対象カラムが <tt class="docutils literal"><span class="pre">_key</span></tt> カラムと <tt class="docutils literal"><span class="pre">content</span></tt> カラムで、 <tt class="docutils literal"><span class="pre">_key</span></tt> カラムの重みは10、 <tt class="docutils literal"><span class="pre">content</span></tt> カラムの重みは1という意味です。この重み付けは <tt class="docutils literal"><span class="pre">_key</span></tt> カラムの値は <tt class="docutils literal"><span class="pre">content</span></tt> カラムの値よりも重要だという意味になります。この例では、ブログエントリのタイトルはブログエントリの内容よりも重要だということです。</p>
+</div>
+<div class="section" id="query">
+<h4>7.3.17.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#query" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write short description and add example.</p>
+<p><a class="reference internal" href="../spec/query_syntax.html"><em>クエリ構文</em></a> を参照してください。</p>
+</div>
+<div class="section" id="filter">
+<h4>7.3.17.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#filter" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write short description and add example.</p>
+<p><a class="reference internal" href="../spec/script_syntax.html"><em>スクリプト構文</em></a> を参照してください。</p>
+</div>
+</div>
+<div class="section" id="advanced-search-parameters">
+<h3>7.3.17.4.3. 高度な検索のための引数<a class="headerlink" href="#advanced-search-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<div class="section" id="match-escalation-threshold">
+<h4>7.3.17.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt><a class="headerlink" href="#match-escalation-threshold" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: add example.</p>
+<p>検索方法をエスカレーションするかどうかを決定するための閾値を指定します。この閾値はマッチしたレコード数との比較に使われます。マッチしたレコード数がこの閾値以下の場合は検索方法をエスカレーションします。検索方法のエスカレーションについては <a class="reference internal" href="../spec/search.html"><em>検索</em></a> を参照してください。</p>
+<p>デフォルトの閾値は0です。これは1つもレコードがマッチしなかったときだけ検索方法をエスカレーションするということです。</p>
+<p>デフォルトの閾値は以下の方法でカスタマイズできます。</p>
 <blockquote>
-<div><p>検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。</p>
-<p>scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。</p>
+<div><ul class="simple">
+<li>configureの <tt class="docutils literal"><span class="pre">--with-match-escalation-threshold</span></tt> オプション</li>
+<li>groongaコマンドの <tt class="docutils literal"><span class="pre">--match-escalation-threshold</span></tt> オプション</li>
+<li>設定ファイルの <tt class="docutils literal"><span class="pre">match-escalation-threshold</span></tt> 設定項目</li>
+</ul>
 </div></blockquote>
-<p><tt class="docutils literal"><span class="pre">sortby</span></tt></p>
-<blockquote>
-<div><p>ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。:</p>
+</div>
+<div class="section" id="query-expansion">
+<h4>7.3.17.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt><a class="headerlink" href="#query-expansion" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p><tt class="docutils literal"><span class="pre">query</span></tt> 引数の値を拡張（置換）するために使うカラムを指定します。</p>
+<p>query_expansionパラメータには、queryパラメータに指定された文字列を置換(拡張)する条件となるテーブル・カラムを指定します。フォーマットは「${テーブル名}.${カラム名}」となります。指定するテーブルは文字列を主キーとするハッシュ型あるいはパトリシア木型のテーブルで、一つ以上の文字列型のカラムが定義されている必要があります。(ここでは置換テーブルと呼びます。)</p>
+<p>queryパラメータに指定された文字列が、指定されたテーブルの主キーと完全一致する場合、その文字列を指定されたカラム値の文字列に置換します。queryパラメータが、空白、括弧、演算子などを含む場合は、その演算子によって区切られた文字列の単位で置換が実行されます。ダブルクォート(&quot;&quot;)で括られた範囲は、その内部に空白を含んでいても一つの置換される単位と見なされます。検索文字列と置換テーブルの主キー値との比較に際して大文字小文字等を区別したくない場合には、置換テーブルを定義する際にKEY_NORMALIZEを指定します。置換後の文字列となるカラムの値には、括弧や*, ORなど、queryパラメータで利用可能な全ての演算子を指定することができます。</p>
+</div>
+</div>
+<div class="section" id="output-related-parameters">
+<h3>7.3.17.4.4. 出力関連の引数<a class="headerlink" href="#output-related-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<div class="section" id="output-columns">
+<h4>7.3.17.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt><a class="headerlink" href="#output-columns" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>出力するカラム名のリストをカンマ(',')区切りで指定します。</p>
+<p>アスタリスク('*')を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、'_id, _key, *')</p>
+</div>
+<div class="section" id="sortby">
+<h4>7.3.17.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt><a class="headerlink" href="#sortby" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。:</p>
 <div class="highlight-none"><div class="highlight"><pre>[-]カラム名1, [-]カラム名2, [-]カラム名3, ...
 </pre></div>
 </div>
 <p>カラム名1の値でソートし、値が同一である場合はカラム名2でソート、と順次比較を行いソートします。カラム名の前に - を付加した場合は降順にソートします。付加しない場合には昇順にソートします。</p>
 <p>query引数またはfilter引数を指定した場合はカラム名に'_score'を使えます。'_score'を指定することでスコアでソートすることができます。query引数もfilter引数も指定していない状態で'_score'を指定するとエラーになります。</p>
-</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">output_columns</span></tt></p>
-<blockquote>
-<div><p>出力するカラム名のリストをカンマ(',')区切りで指定します。</p>
-<p>アスタリスク('*')を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、'_id, _key, *')</p>
-</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">offset</span></tt></p>
-<blockquote>
-<div>検索条件にマッチしたレコードのうち、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。offsetに負の値を指定した場合は、ヒットした件数 + offset によって算出される値が指定されたものとみなされます。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">limit</span></tt></p>
-<blockquote>
-<div>検索条件にマッチしたレコードのうち、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、offset + limit がヒットした件数を超えない範囲でレコードが出力されます。limitに負の値を指定した場合は、ヒットした件数 + limit + 1 によって算出される値が指定されたものとみなされます。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">drilldown</span></tt></p>
-<blockquote>
-<div>グループ化のキーとなるカラム名のリストをカンマ(',')区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt></p>
-<blockquote>
-<div>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt></p>
-<blockquote>
-<div>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(',')区切りで指定します。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">drilldown_offset</span></tt></p>
-<blockquote>
-<div>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">drilldown_limit</span></tt></p>
-<blockquote>
-<div>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">cache</span></tt></p>
-<blockquote>
-<div><p>クエリキャッシュに関する動作を設定します。</p>
-<blockquote>
-<div><p><tt class="docutils literal"><span class="pre">no</span></tt></p>
+</div>
+<div class="section" id="offset">
+<h4>7.3.17.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt><a class="headerlink" href="#offset" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>検索条件にマッチしたレコードのうち、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。offsetに負の値を指定した場合は、ヒットした件数 + offset によって算出される値が指定されたものとみなされます。</p>
+</div>
+<div class="section" id="limit">
+<h4>7.3.17.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt><a class="headerlink" href="#limit" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>検索条件にマッチしたレコードのうち、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、offset + limit がヒットした件数を超えない範囲でレコードが出力されます。limitに負の値を指定した場合は、ヒットした件数 + limit + 1 によって算出される値が指定されたものとみなされます。</p>
+</div>
+<div class="section" id="scorer">
+<h4>7.3.17.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt><a class="headerlink" href="#scorer" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。</p>
+<p>scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。</p>
+</div>
+</div>
+<div class="section" id="facet-related-parameters">
+<h3>7.3.17.4.5. ファセット関連の引数<a class="headerlink" href="#facet-related-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<div class="section" id="drilldown">
+<h4>7.3.17.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt><a class="headerlink" href="#drilldown" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>グループ化のキーとなるカラム名のリストをカンマ(',')区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。</p>
+</div>
+<div class="section" id="drilldown-sortby">
+<h4>7.3.17.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt><a class="headerlink" href="#drilldown-sortby" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。</p>
+</div>
+<div class="section" id="drilldown-output-columns">
+<h4>7.3.17.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt><a class="headerlink" href="#drilldown-output-columns" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(',')区切りで指定します。</p>
+</div>
+<div class="section" id="drilldown-offset">
+<h4>7.3.17.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt><a class="headerlink" href="#drilldown-offset" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。</p>
+</div>
+<div class="section" id="drilldown-limit">
+<h4>7.3.17.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt><a class="headerlink" href="#drilldown-limit" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。</p>
+</div>
+</div>
+<div class="section" id="cache-related-parameter">
+<h3>7.3.17.4.6. キャッシュ関連の引数<a class="headerlink" href="#cache-related-parameter" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<div class="section" id="cache">
+<h4>7.3.17.4.6.1. <tt class="docutils literal"><span class="pre">cache</span></tt><a class="headerlink" href="#cache" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO: write in English and add example.</p>
+<p>クエリキャッシュに関する動作を設定します。</p>
+<p><tt class="docutils literal"><span class="pre">no</span></tt></p>
 <blockquote>
 <div>検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。</div></blockquote>
-</div></blockquote>
-</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt></p>
-<blockquote>
-<div><p>検索の挙動をエスカレーションするかどうかの閾値を設定します。デフォルト値は0です。デフォルト値は以下のいずれかの方法で設定できます。</p>
-<blockquote>
-<div><ul class="simple">
-<li>configureの--with-match-escalation-thresholdオプション</li>
-<li>groongaコマンド起動時の--match-escalation-thresholdオプション</li>
-<li>設定ファイル中のmatch-escalation-threshold設定項目</li>
-</ul>
-</div></blockquote>
-<p>クエリのヒット件数が閾値を越えない場合は <a class="reference internal" href="../spec/search.html"><em>検索</em></a> で説明している方法で検索方法をエスカレーションしてきます。</p>
-</div></blockquote>
-<p><tt class="docutils literal"><span class="pre">query_expansion</span></tt></p>
-<blockquote>
-<div><p>query_expansionパラメータには、queryパラメータに指定された文字列を置換(拡張)する条件となるテーブル・カラムを指定します。フォーマットは「${テーブル名}.${カラム名}」となります。指定するテーブルは文字列を主キーとするハッシュ型あるいはパトリシア木型のテーブルで、一つ以上の文字列型のカラムが定義されている必要があります。(ここでは置換テーブルと呼びます。)</p>
-<p>queryパラメータに指定された文字列が、指定されたテーブルの主キーと完全一致する場合、その文字列を指定されたカラム値の文字列に置換します。queryパラメータが、空白、括弧、演算子などを含む場合は、その演算子によって区切られた文字列の単位で置換が実行されます。ダブルクォート(&quot;&quot;)で括られた範囲は、その内部に空白を含んでいても一つの置換される単位と見なされます。検索文字列と置換テーブルの主キー値との比較に際して大文字小文字等を区別したくない場合には、置換テーブルを定義する際にKEY_NORMALIZEを指定します。置換後の文字列となるカラムの値には、括弧や*, ORなど、queryパラメータで利用可能な全ての演算子を指定することができます。</p>
-</div></blockquote>
 </div>
 </div>
-<div class="section" id="id7">
-<h2>7.3.17.5. 返値<a class="headerlink" href="#id7" title="このヘッドラインへのパーマリンク">¶</a></h2>
+</div>
+<div class="section" id="id1">
+<h2>7.3.17.5. 返値<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>TODO: write in English and add example.</p>
 <p>以下のようなjson形式で値が返却されます。</p>
 <div class="highlight-none"><div class="highlight"><pre>[[リターンコード, 処理開始時間, 処理時間], [検索結果, ドリルダウン結果]]
 </pre></div>
@@ -280,18 +681,14 @@
 <div>drilldown_output_columns, drilldown_offset, drilldown_limitによって指定された条件に従って各レコードの値が出力されます。</div></blockquote>
 </div></blockquote>
 </div>
-<div class="section" id="id8">
-<h2>7.3.17.6. 例<a class="headerlink" href="#id8" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>テーブルEntryの全レコード・全カラムの値を出力します。:</p>
-<div class="highlight-none"><div class="highlight"><pre>select Entry
-[[[2],[[&quot;_id&quot;, &quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;body&quot;,&quot;ShortText&quot;]],[1,&quot;abandon&quot;,&quot;放棄する&quot;],[2,&quot;abbreviate&quot;,&quot;短縮する&quot;]]]
-</pre></div>
-</div>
-</div>
-<div class="section" id="id9">
-<h2>7.3.17.7. 関連項目<a class="headerlink" href="#id9" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><a class="reference internal" href="../expr.html"><em>grn_expr</em></a></p>
+<div class="section" id="see-also">
+<h2>7.3.17.6. 参考<a class="headerlink" href="#see-also" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<blockquote>
+<div><ul class="simple">
+<li><a class="reference internal" href="../spec/query_syntax.html"><em>クエリ構文</em></a></li>
+<li><a class="reference internal" href="../spec/script_syntax.html"><em>スクリプト構文</em></a></li>
+</ul>
+</div></blockquote>
 </div>
 </div>
@@ -304,17 +701,59 @@
   <h3><a href="../index.html">目次</a></h3>
   <ul>
 <li><a class="reference internal" href="#">7.3.17. select</a><ul>
-<li><a class="reference internal" href="#id1">7.3.17.1. 名前</a></li>
-<li><a class="reference internal" href="#id2">7.3.17.2. 書式</a></li>
-<li><a class="reference internal" href="#id3">7.3.17.3. 説明</a></li>
-<li><a class="reference internal" href="#id4">7.3.17.4. 引数</a><ul>
-<li><a class="reference internal" href="#id5">7.3.17.4.1. 条件式</a></li>
-<li><a class="reference internal" href="#id6">7.3.17.4.2. 結合演算子</a></li>
+<li><a class="reference internal" href="#summary">7.3.17.1. 概要</a></li>
+<li><a class="reference internal" href="#syntax">7.3.17.2. 構文</a></li>
+<li><a class="reference internal" href="#usage">7.3.17.3. 使い方</a><ul>
+<li><a class="reference internal" href="#simple-usage">7.3.17.3.1. 簡単な使い方</a></li>
+<li><a class="reference internal" href="#search-conditions">7.3.17.3.2. 検索条件</a><ul>
+<li><a class="reference internal" href="#search-condition-query">7.3.17.3.2.1. 検索条件: <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
+<li><a class="reference internal" href="#search-condition-filter">7.3.17.3.2.2. 検索条件: <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#paging">7.3.17.3.3. ページング</a></li>
+<li><a class="reference internal" href="#the-total-number-of-records">7.3.17.3.4. 全レコード数</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#parameters">7.3.17.4. 引数</a><ul>
+<li><a class="reference internal" href="#required-parameter">7.3.17.4.1. 必須引数</a><ul>
+<li><a class="reference internal" href="#table">7.3.17.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#search-related-parameters">7.3.17.4.2. 検索関係の引数</a><ul>
+<li><a class="reference internal" href="#match-columns">7.3.17.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt></a></li>
+<li><a class="reference internal" href="#query">7.3.17.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
+<li><a class="reference internal" href="#filter">7.3.17.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#advanced-search-parameters">7.3.17.4.3. 高度な検索のための引数</a><ul>
+<li><a class="reference internal" href="#match-escalation-threshold">7.3.17.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt></a></li>
+<li><a class="reference internal" href="#query-expansion">7.3.17.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#output-related-parameters">7.3.17.4.4. 出力関連の引数</a><ul>
+<li><a class="reference internal" href="#output-columns">7.3.17.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt></a></li>
+<li><a class="reference internal" href="#sortby">7.3.17.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt></a></li>
+<li><a class="reference internal" href="#offset">7.3.17.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt></a></li>
+<li><a class="reference internal" href="#limit">7.3.17.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt></a></li>
+<li><a class="reference internal" href="#scorer">7.3.17.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#facet-related-parameters">7.3.17.4.5. ファセット関連の引数</a><ul>
+<li><a class="reference internal" href="#drilldown">7.3.17.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-sortby">7.3.17.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-output-columns">7.3.17.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-offset">7.3.17.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-limit">7.3.17.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#cache-related-parameter">7.3.17.4.6. キャッシュ関連の引数</a><ul>
+<li><a class="reference internal" href="#cache">7.3.17.4.6.1. <tt class="docutils literal"><span class="pre">cache</span></tt></a></li>
+</ul>
+</li>
 </ul>
 </li>
-<li><a class="reference internal" href="#id7">7.3.17.5. 返値</a></li>
-<li><a class="reference internal" href="#id8">7.3.17.6. 例</a></li>
-<li><a class="reference internal" href="#id9">7.3.17.7. 関連項目</a></li>
+<li><a class="reference internal" href="#id1">7.3.17.5. 返値</a></li>
+<li><a class="reference internal" href="#see-also">7.3.17.6. 参考</a></li>
 </ul>
 </li>
 </ul>
@@ -359,7 +798,7 @@
         <li class="right" >
           <a href="quit.html" title="7.3.16. quit"
              >前へ</a> |</li>
-        <li><a href="../index.html">groonga v2.0.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">groonga v2.0.1ドキュメント</a> &raquo;</li>
           <li><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
           <li><a href="../commands.html" >7.3. コマンド</a> &raquo;</li>
       </ul>