RubyGems - rroonga - Versions diffs - 0.9.5-x86-mingw32 → 1.0.1-x86-mingw32 - Mend

rroonga 0.9.5-x86-mingw32 → 1.0.1-x86-mingw32

Files changed (421) hide show

data/vendor/local/share/groonga/doc/ja/html/tutorial/tutorial05.html ADDED Viewed

@@ -0,0 +1,169 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>3.5. ドリルダウン &mdash; groonga v1.0.2 documentation</title>
+    <link rel="stylesheet" href="../_static/default.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '1.0.2',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <link rel="top" title="groonga v1.0.2 documentation" href="../index.html" />
+    <link rel="up" title="3. チュートリアル" href="../tutorial.html" />
+    <link rel="next" title="3.6. タグ検索・参照関係の逆引き" href="tutorial06.html" />
+    <link rel="prev" title="3.4. さまざまな検索条件の指定" href="tutorial04.html" />
+  </head>
+  <body>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="tutorial06.html" title="3.6. タグ検索・参照関係の逆引き"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial04.html" title="3.4. さまざまな検索条件の指定"
+             accesskey="P">previous</a> |</li>
+        <li><a href="../index.html">groonga v1.0.2 documentation</a> &raquo;</li>
+          <li><a href="../tutorial.html" accesskey="U">3. チュートリアル</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="id1">
+<h1>3.5. ドリルダウン<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<p>groongaでは、特定のカラム値で検索結果をグループ化することができます。これをドリルダウンと呼びます。</p>
+<p>Siteテーブルに２つのカラムを追加します。TLDドメイン名を格納するdomainカラムと、国名を格納するcountryカラムです。これらのカラムの型は、それぞれドメイン名を主キーとするSiteDomainテーブルと、国名を主キーとするSiteCounteryテーブルとします。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create --name SiteDomain --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378842.01708,0.06822],true]
+&gt; table_create --name SiteCountry --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378842.28607,0.066339],true]
+&gt; column_create --table Site --name domain --flags COLUMN_SCALAR --type SiteDomain
+[[0,1280378842.55314,0.066281],true]
+&gt; column_create --table Site --name country --flags COLUMN_SCALAR --type SiteCountry
+[[0,1280378842.82013,0.057988],true]
+&gt; load --table Site
+&gt; [
+&gt; {&quot;_key&quot;:&quot;http://example.org/&quot;,&quot;domain&quot;:&quot;.org&quot;,&quot;country&quot;:&quot;japan&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.net/&quot;,&quot;domain&quot;:&quot;.net&quot;,&quot;country&quot;:&quot;brazil&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.com/&quot;,&quot;domain&quot;:&quot;.com&quot;,&quot;country&quot;:&quot;japan&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.net/afr&quot;,&quot;domain&quot;:&quot;.net&quot;,&quot;country&quot;:&quot;usa&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.org/aba&quot;,&quot;domain&quot;:&quot;.org&quot;,&quot;country&quot;:&quot;korea&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.com/rab&quot;,&quot;domain&quot;:&quot;.com&quot;,&quot;country&quot;:&quot;china&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.net/atv&quot;,&quot;domain&quot;:&quot;.net&quot;,&quot;country&quot;:&quot;china&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.org/gat&quot;,&quot;domain&quot;:&quot;.org&quot;,&quot;country&quot;:&quot;usa&quot;},
+&gt; {&quot;_key&quot;:&quot;http://example.com/vdw&quot;,&quot;domain&quot;:&quot;.com&quot;,&quot;country&quot;:&quot;japan&quot;}
+&gt; ]
+[[0,1280378843.07883,2.202888],9]
+</pre></div>
+</div>
+<p>domainカラムとcountryカラムでドリルダウンを行う例を以下に示します。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --limit 0 --drilldown domain
+[[0,1280378845.48263,0.00043],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;links&quot;,&quot;Site&quot;],[&quot;link&quot;,&quot;Site&quot;],[&quot;domain&quot;,&quot;SiteDomain&quot;],[&quot;country&quot;,&quot;SiteCountry&quot;]]],[[3],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[&quot;.org&quot;,3],[&quot;.net&quot;,3],[&quot;.com&quot;,3]]]]
+</pre></div>
+</div>
+<p>テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、_nsubrecsという仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --limit 0 --drilldown domain --drilldown_output_columns _id,_key,_nsubrecs
+[[0,1280378845.68647,0.000267],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;links&quot;,&quot;Site&quot;],[&quot;link&quot;,&quot;Site&quot;],[&quot;domain&quot;,&quot;SiteDomain&quot;],[&quot;country&quot;,&quot;SiteCountry&quot;]]],[[3],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[1,&quot;.org&quot;,3],[2,&quot;.net&quot;,3],[3,&quot;.com&quot;,3]]]]
+</pre></div>
+</div>
+<p>複数のカラムに対してドリルダウンを行うことができます。複数のカラムに対してドリルダウンを行う場合には、drilldownパラメータにカラム名をカンマ区切りで与えます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --limit 0 --drilldown domain,country
+[[0,1280378845.8903,0.000368],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;links&quot;,&quot;Site&quot;],[&quot;link&quot;,&quot;Site&quot;],[&quot;domain&quot;,&quot;SiteDomain&quot;],[&quot;country&quot;,&quot;SiteCountry&quot;]]],[[3],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[&quot;.org&quot;,3],[&quot;.net&quot;,3],[&quot;.com&quot;,3]],[[5],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[&quot;japan&quot;,3],[&quot;brazil&quot;,1],[&quot;usa&quot;,2],[&quot;korea&quot;,1],[&quot;china&quot;,2]]]]
+</pre></div>
+</div>
+<p>ドリルダウン結果を並びかえることができます。例えば、_nsubrecsパラメータの降順で並び替えることができます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs
+[[0,1280378846.09517,0.000359],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;links&quot;,&quot;Site&quot;],[&quot;link&quot;,&quot;Site&quot;],[&quot;domain&quot;,&quot;SiteDomain&quot;],[&quot;country&quot;,&quot;SiteCountry&quot;]]],[[5],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[&quot;brazil&quot;,1],[&quot;korea&quot;,1],[&quot;usa&quot;,2],[&quot;china&quot;,2],[&quot;japan&quot;,3]]]]
+</pre></div>
+</div>
+<p>ドリルダウン結果は、デフォルトでは10件のみ表示されます。drilldown_offsetパラメータと、drilldown_limitパラメータによって、offsetとlimitを指定することができます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs --drilldown_limit 2 --drilldown_offset 2
+[[0,1280378846.2992,0.000326],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;links&quot;,&quot;Site&quot;],[&quot;link&quot;,&quot;Site&quot;],[&quot;domain&quot;,&quot;SiteDomain&quot;],[&quot;country&quot;,&quot;SiteCountry&quot;]]],[[5],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[&quot;usa&quot;,2],[&quot;china&quot;,2]]]]
+</pre></div>
+</div>
+<p>文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。</p>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial04.html"
+                        title="previous chapter">3.4. さまざまな検索条件の指定</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="tutorial06.html"
+                        title="next chapter">3.6. タグ検索・参照関係の逆引き</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/tutorial/tutorial05.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="../search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="tutorial06.html" title="3.6. タグ検索・参照関係の逆引き"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial04.html" title="3.4. さまざまな検索条件の指定"
+             >previous</a> |</li>
+        <li><a href="../index.html">groonga v1.0.2 documentation</a> &raquo;</li>
+          <li><a href="../tutorial.html" >3. チュートリアル</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2009-2010, Brazil, Inc.
+      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.1.
+    </div>
+  </body>
+</html>

data/vendor/local/share/groonga/doc/ja/html/tutorial/tutorial06.html ADDED Viewed

@@ -0,0 +1,209 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>3.6. タグ検索・参照関係の逆引き &mdash; groonga v1.0.2 documentation</title>
+    <link rel="stylesheet" href="../_static/default.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '1.0.2',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <link rel="top" title="groonga v1.0.2 documentation" href="../index.html" />
+    <link rel="up" title="3. チュートリアル" href="../tutorial.html" />
+    <link rel="next" title="3.7. match_columnsパラメータ" href="tutorial07.html" />
+    <link rel="prev" title="3.5. ドリルダウン" href="tutorial05.html" />
+  </head>
+  <body>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="tutorial07.html" title="3.7. match_columnsパラメータ"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial05.html" title="3.5. ドリルダウン"
+             accesskey="P">previous</a> |</li>
+        <li><a href="../index.html">groonga v1.0.2 documentation</a> &raquo;</li>
+          <li><a href="../tutorial.html" accesskey="U">3. チュートリアル</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="id1">
+<h1>3.6. タグ検索・参照関係の逆引き<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<p>本チュートリアルで、groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。</p>
+<p>タグ検索はgroongaの転置インデックスというデータ構造を用いて高速に行われます。</p>
+<div class="section" id="id2">
+<h2>3.6.1. タグ検索<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
+<p>動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。</p>
+<p>実際に、動画情報のテーブルを作成し、検索をしてみましょう。</p>
+<p>動画の情報を保存する、Videoテーブルを作成します。Videoテーブルでは、動画のタイトルをtitleカラムに、動画のタグ情報をtagsカラムにTagテーブル型で複数格納しています。
+タグの情報を保存する、Tagテーブルを作成します。Tagテーブルでは、タグ文字列を主キーに格納し、Videoテーブルのtagsカラムに対するインデックスをindex_tagsカラムに格納しています。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create --name Video --flags TABLE_HASH_KEY --key_type UInt32
+[[0,1280378923.03769,0.060105],true]
+&gt; table_create --name Tag --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378923.29856,0.057985],true]
+&gt; column_create --table Video --name title --flags COLUMN_SCALAR --type ShortText
+[[0,1280378923.55728,0.067165],true]
+&gt; column_create --table Video --name tags --flags COLUMN_VECTOR --type Tag
+[[0,1280378923.82522,0.066382],true]
+&gt; column_create --table Tag --name index_tags --flags COLUMN_INDEX --type Video --source tags
+[[0,1280378924.0924,0.122744],true]
+&gt; load --table Video
+&gt; [
+&gt; {&quot;_key&quot;:1,&quot;title&quot;:&quot;Soccer 2010&quot;,&quot;tags&quot;:[&quot;Sports&quot;,&quot;Soccer&quot;]},
+&gt; {&quot;_key&quot;:2,&quot;title&quot;:&quot;Zenigata Kinjirou&quot;,&quot;tags&quot;:[&quot;Variety&quot;,&quot;Money&quot;]},
+&gt; {&quot;_key&quot;:3,&quot;title&quot;:&quot;groonga Demo&quot;,&quot;tags&quot;:[&quot;IT&quot;,&quot;Server&quot;,&quot;groonga&quot;]},
+&gt; {&quot;_key&quot;:4,&quot;title&quot;:&quot;Moero!! Ultra Baseball&quot;,&quot;tags&quot;:[&quot;Sports&quot;,&quot;Baseball&quot;]},
+&gt; {&quot;_key&quot;:5,&quot;title&quot;:&quot;Hex Gone!&quot;,&quot;tags&quot;:[&quot;Variety&quot;,&quot;Quiz&quot;]},
+&gt; {&quot;_key&quot;:6,&quot;title&quot;:&quot;Pikonyan 1&quot;,&quot;tags&quot;:[&quot;Animation&quot;,&quot;Pikonyan&quot;]},
+&gt; {&quot;_key&quot;:7,&quot;title&quot;:&quot;Draw 8 Month&quot;,&quot;tags&quot;:[&quot;Animation&quot;,&quot;Raccoon&quot;]},
+&gt; {&quot;_key&quot;:8,&quot;title&quot;:&quot;K.O.&quot;,&quot;tags&quot;:[&quot;Animation&quot;,&quot;Music&quot;]}
+&gt; ]
+[[0,1280378924.41589,2.002628],8]
+</pre></div>
+</div>
+<p>インデックスカラムを作成すると、全文検索が高速に行えるようになります。インデックスカラムは、対象のカラムに保存されたデータに更新があったとき、自動的に更新されます。</p>
+<p>「ある語句が付与されている動画の一覧を取得する」検索を行いましょう。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Video --query tags:@Variety --output_columns _key,title
+[[0,1280378926.6193,0.000444],[[[2],[[&quot;_key&quot;,&quot;UInt32&quot;],[&quot;title&quot;,&quot;ShortText&quot;]],[2,&quot;Zenigata Kinjirou&quot;],[5,&quot;Hex Gone!&quot;]]]]
+&gt; select --table Video --query tags:@Sports --output_columns _key,title
+[[0,1280378926.82132,0.000302],[[[2],[[&quot;_key&quot;,&quot;UInt32&quot;],[&quot;title&quot;,&quot;ShortText&quot;]],[1,&quot;Soccer 2010&quot;],[4,&quot;Moero!! Ultra Baseball&quot;]]]]
+&gt; select --table Video --query tags:@Animation --output_columns _key,title
+[[0,1280378927.02314,0.000295],[[[3],[[&quot;_key&quot;,&quot;UInt32&quot;],[&quot;title&quot;,&quot;ShortText&quot;]],[6,&quot;Pikonyan 1&quot;],[7,&quot;Draw 8 Month&quot;],[8,&quot;K.O.&quot;]]]]
+</pre></div>
+</div>
+<p>このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。</p>
+</div>
+<div class="section" id="id3">
+<h2>3.6.2. 参照関係の逆引き<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
+<p>groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。</p>
+<p>例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。</p>
+<p>以下の例では、ユーザー情報を格納するUserテーブルを作成し、ユーザー名を格納するusernameカラム、ユーザーの友人一覧を配列で格納するfriendsカラムとそのインデックスのindex_friendsカラムを追加しています。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create --name User --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378927.22516,0.091699],true]
+&gt; column_create --table User --name username --flags COLUMN_SCALAR --type ShortText
+[[0,1280378927.51764,0.067062],true]
+&gt; column_create --table User --name friends --flags COLUMN_VECTOR --type User
+[[0,1280378927.78548,0.05804],true]
+&gt; column_create --table User --name index_friends --flags COLUMN_INDEX --type User --source friends
+[[0,1280378928.04428,0.113384],true]
+&gt; load --table User
+&gt; [
+&gt; {&quot;_key&quot;:&quot;ken&quot;,&quot;username&quot;:&quot;健作&quot;,&quot;friends&quot;:[&quot;taro&quot;,&quot;jiro&quot;,&quot;tomo&quot;,&quot;moritapo&quot;]}
+&gt; {&quot;_key&quot;:&quot;moritapo&quot;,&quot;username&quot;:&quot;森田&quot;,&quot;friends&quot;:[&quot;ken&quot;,&quot;tomo&quot;]}
+&gt; {&quot;_key&quot;:&quot;taro&quot;,&quot;username&quot;:&quot;ぐるんが太郎&quot;,&quot;friends&quot;:[&quot;jiro&quot;,&quot;tomo&quot;]}
+&gt; {&quot;_key&quot;:&quot;jiro&quot;,&quot;username&quot;:&quot;ぐるんが次郎&quot;,&quot;friends&quot;:[&quot;taro&quot;,&quot;tomo&quot;]}
+&gt; {&quot;_key&quot;:&quot;tomo&quot;,&quot;username&quot;:&quot;トモちゃん&quot;,&quot;friends&quot;:[&quot;ken&quot;,&quot;hana&quot;]}
+&gt; {&quot;_key&quot;:&quot;hana&quot;,&quot;username&quot;:&quot;花子&quot;,&quot;friends&quot;:[&quot;ken&quot;,&quot;taro&quot;,&quot;jiro&quot;,&quot;moritapo&quot;,&quot;tomo&quot;]}
+&gt; ]
+[[0,1280378928.35845,1.602101],6]
+</pre></div>
+</div>
+<p>指定したユーザーを友人リストに入れているユーザーの一覧を表示してみましょう。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table User --query friends:@tomo --output_columns _key,username
+[[0,1280378930.16145,0.000464],[[[5],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;username&quot;,&quot;ShortText&quot;]],[&quot;ken&quot;,&quot;健作&quot;],[&quot;taro&quot;,&quot;ぐるんが太郎&quot;],[&quot;jiro&quot;,&quot;ぐるんが次郎&quot;],[&quot;moritapo&quot;,&quot;森田&quot;],[&quot;hana&quot;,&quot;花子&quot;]]]]
+&gt; select --table User --query friends:@jiro --output_columns _key,username
+[[0,1280378930.36419,0.000293],[[[3],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;username&quot;,&quot;ShortText&quot;]],[&quot;ken&quot;,&quot;健作&quot;],[&quot;taro&quot;,&quot;ぐるんが太郎&quot;],[&quot;hana&quot;,&quot;花子&quot;]]]]
+</pre></div>
+</div>
+<p>さらに、ドリルダウンを使って、友人リストに入っている数の一覧を表示してみましょう。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table User --limit 0 --drilldown friends
+[[0,1280378930.56663,0.000267],[[[6],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;username&quot;,&quot;ShortText&quot;],[&quot;index_friends&quot;,&quot;User&quot;],[&quot;friends&quot;,&quot;User&quot;]]],[[6],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_nsubrecs&quot;,&quot;Int32&quot;]],[&quot;taro&quot;,3],[&quot;jiro&quot;,3],[&quot;tomo&quot;,5],[&quot;moritapo&quot;,2],[&quot;ken&quot;,3],[&quot;hana&quot;,1]]]]
+</pre></div>
+</div>
+<p>このように、テーブルの参照関係を逆にたどる検索ができました。</p>
+</div>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h3><a href="../index.html">Table Of Contents</a></h3>
+  <ul>
+<li><a class="reference internal" href="#">3.6. タグ検索・参照関係の逆引き</a><ul>
+<li><a class="reference internal" href="#id2">3.6.1. タグ検索</a></li>
+<li><a class="reference internal" href="#id3">3.6.2. 参照関係の逆引き</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial05.html"
+                        title="previous chapter">3.5. ドリルダウン</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="tutorial07.html"
+                        title="next chapter">3.7. match_columnsパラメータ</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/tutorial/tutorial06.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="../search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="tutorial07.html" title="3.7. match_columnsパラメータ"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial05.html" title="3.5. ドリルダウン"
+             >previous</a> |</li>
+        <li><a href="../index.html">groonga v1.0.2 documentation</a> &raquo;</li>
+          <li><a href="../tutorial.html" >3. チュートリアル</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2009-2010, Brazil, Inc.
+      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.1.
+    </div>
+  </body>
+</html>

data/vendor/local/share/groonga/doc/ja/html/tutorial/tutorial07.html ADDED Viewed

@@ -0,0 +1,212 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>3.7. match_columnsパラメータ &mdash; groonga v1.0.2 documentation</title>
+    <link rel="stylesheet" href="../_static/default.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '1.0.2',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <link rel="top" title="groonga v1.0.2 documentation" href="../index.html" />
+    <link rel="up" title="3. チュートリアル" href="../tutorial.html" />
+    <link rel="next" title="3.8. 主キーによる前方一致検索" href="tutorial08.html" />
+    <link rel="prev" title="3.6. タグ検索・参照関係の逆引き" href="tutorial06.html" />
+  </head>
+  <body>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="tutorial08.html" title="3.8. 主キーによる前方一致検索"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial06.html" title="3.6. タグ検索・参照関係の逆引き"
+             accesskey="P">previous</a> |</li>
+        <li><a href="../index.html">groonga v1.0.2 documentation</a> &raquo;</li>
+          <li><a href="../tutorial.html" accesskey="U">3. チュートリアル</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="match-columns">
+<h1>3.7. match_columnsパラメータ<a class="headerlink" href="#match-columns" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="id1">
+<h2>3.7.1. 複数のカラムを対象とした全文検索<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
+<p>groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。</p>
+<p>この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。</p>
+<div class="section" id="id2">
+<h3>3.7.1.1. カラムごとにインデックスを付与する場合<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
+<p>Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のmessageカラムを追加しています。
+インデックス用のIndexBlog1テーブルも作り、titleカラムのインデックス用にindex_titleカラム、messageカラムのインデック用にindex_messageカラムと、それぞれ1カラムごとに1つずつ追加しています。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create --name Blog1 --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378807.97095,0.074659],true]
+&gt; column_create --table Blog1 --name title --flags COLUMN_SCALAR --type ShortText
+[[0,1280378808.24637,0.058739],true]
+&gt; column_create --table Blog1 --name message --flags COLUMN_SCALAR --type ShortText
+[[0,1280378808.50589,0.074658],true]
+&gt; table_create --name IndexBlog1 --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+[[0,1280378808.78136,0.065557],true]
+&gt; column_create --table IndexBlog1 --name index_title --flags COLUMN_INDEX|WITH_POSITION --type Blog1 --source title
+[[0,1280378809.04764,0.147413],true]
+&gt; column_create --table IndexBlog1 --name index_message --flags COLUMN_INDEX|WITH_POSITION --type Blog1 --source message
+[[0,1280378809.39584,0.124963],true]
+&gt; load --table Blog1
+&gt; [
+&gt; {&quot;_key&quot;:&quot;grn1&quot;,&quot;title&quot;:&quot;groonga test&quot;,&quot;message&quot;:&quot;groonga message&quot;},
+&gt; {&quot;_key&quot;:&quot;grn2&quot;,&quot;title&quot;:&quot;baseball result&quot;,&quot;message&quot;:&quot;rakutan eggs 4 - 4 groonga moritars&quot;},
+&gt; {&quot;_key&quot;:&quot;grn3&quot;,&quot;title&quot;:&quot;groonga message&quot;,&quot;message&quot;:&quot;none&quot;}
+&gt; ]
+[[0,1280378809.72157,1.001442],3]
+</pre></div>
+</div>
+<p>match_columnsオプションで、検索対象のカラムを複数指定することが出来ます。検索する文字列はqueryオプションで指定します。これを使うことで、タイトルと本文を全文検索することができます。</p>
+<p>実際に検索してみましょう。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Blog1 --match_columns title||message --query groonga
+[[0,1280378810.92387,0.0008],[[[3],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;message&quot;,&quot;ShortText&quot;]],[1,&quot;grn1&quot;,&quot;groonga test&quot;,&quot;groonga message&quot;],[3,&quot;grn3&quot;,&quot;groonga message&quot;,&quot;none&quot;],[2,&quot;grn2&quot;,&quot;baseball result&quot;,&quot;rakutan eggs 4 - 4 groonga moritars&quot;]]]]
+&gt; select --table Blog1 --match_columns title||message --query message
+[[0,1280378811.12754,0.000547],[[[2],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;message&quot;,&quot;ShortText&quot;]],[3,&quot;grn3&quot;,&quot;groonga message&quot;,&quot;none&quot;],[1,&quot;grn1&quot;,&quot;groonga test&quot;,&quot;groonga message&quot;]]]]
+&gt; select --table Blog1 --match_columns title --query message
+[[0,1280378811.33043,0.000482],[[[1],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;message&quot;,&quot;ShortText&quot;]],[3,&quot;grn3&quot;,&quot;groonga message&quot;,&quot;none&quot;]]]]
+</pre></div>
+</div>
+</div>
+<div class="section" id="id3">
+<h3>3.7.1.2. 複数のカラムにまたがったインデックスを付与する場合<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
+<p>内容は上の例とほぼ同じですが、titleとmessageの2つのカラムに対するインデックスが共通になっており、インデックスカラムが1つしかありません。</p>
+<p>共通のインデックスを用いても、titleカラムのみでの検索、messageカラムのみでの検索、titleもしくはmessageカラムでの検索、全ての検索を行うことができます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create --name Blog2 --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378811.53299,0.099804],true]
+&gt; column_create --table Blog2 --name title --flags COLUMN_SCALAR --type ShortText
+[[0,1280378811.83359,0.058761],true]
+&gt; column_create --table Blog2 --name message --flags COLUMN_SCALAR --type ShortText
+[[0,1280378812.09316,0.05801],true]
+&gt; table_create --name IndexBlog2 --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+[[0,1280378812.35194,0.057196],true]
+&gt; column_create --table IndexBlog2 --name index_blog --flags COLUMN_INDEX|WITH_POSITION|WITH_SECTION --type Blog2 --source title,message
+[[0,1280378812.60988,0.113983],true]
+&gt; load --table Blog2
+&gt; [
+&gt; {&quot;_key&quot;:&quot;grn1&quot;,&quot;title&quot;:&quot;groonga test&quot;,&quot;message&quot;:&quot;groonga message&quot;},
+&gt; {&quot;_key&quot;:&quot;grn2&quot;,&quot;title&quot;:&quot;baseball result&quot;,&quot;message&quot;:&quot;rakutan eggs 4 - 4 groonga moritars&quot;},
+&gt; {&quot;_key&quot;:&quot;grn3&quot;,&quot;title&quot;:&quot;groonga message&quot;,&quot;message&quot;:&quot;none&quot;}
+&gt; ]
+[[0,1280378812.92463,1.001314],3]
+</pre></div>
+</div>
+<p>実際に検索してみましょう。結果は上の例と同じになります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Blog2 --match_columns title||message --query groonga
+[[0,1280378814.12681,0.000585],[[[3],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;message&quot;,&quot;ShortText&quot;]],[1,&quot;grn1&quot;,&quot;groonga test&quot;,&quot;groonga message&quot;],[2,&quot;grn2&quot;,&quot;baseball result&quot;,&quot;rakutan eggs 4 - 4 groonga moritars&quot;],[3,&quot;grn3&quot;,&quot;groonga message&quot;,&quot;none&quot;]]]]
+&gt; select --table Blog2 --match_columns title||message --query message
+[[0,1280378814.33044,0.000508],[[[2],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;message&quot;,&quot;ShortText&quot;]],[1,&quot;grn1&quot;,&quot;groonga test&quot;,&quot;groonga message&quot;],[3,&quot;grn3&quot;,&quot;groonga message&quot;,&quot;none&quot;]]]]
+&gt; select --table Blog2 --match_columns title --query message
+[[0,1280378814.53323,0.000486],[[[1],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;message&quot;,&quot;ShortText&quot;]],[3,&quot;grn3&quot;,&quot;groonga message&quot;,&quot;none&quot;]]]]
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="id4">
+<h2>3.7.2. インデックス名を指定した全文検索<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
+<p>執筆中です。</p>
+</div>
+<div class="section" id="id5">
+<h2>3.7.3. インデックスの重み<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2>
+<p>執筆中です。</p>
+</div>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h3><a href="../index.html">Table Of Contents</a></h3>
+  <ul>
+<li><a class="reference internal" href="#">3.7. match_columnsパラメータ</a><ul>
+<li><a class="reference internal" href="#id1">3.7.1. 複数のカラムを対象とした全文検索</a><ul>
+<li><a class="reference internal" href="#id2">3.7.1.1. カラムごとにインデックスを付与する場合</a></li>
+<li><a class="reference internal" href="#id3">3.7.1.2. 複数のカラムにまたがったインデックスを付与する場合</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#id4">3.7.2. インデックス名を指定した全文検索</a></li>
+<li><a class="reference internal" href="#id5">3.7.3. インデックスの重み</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial06.html"
+                        title="previous chapter">3.6. タグ検索・参照関係の逆引き</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="tutorial08.html"
+                        title="next chapter">3.8. 主キーによる前方一致検索</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/tutorial/tutorial07.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="../search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="tutorial08.html" title="3.8. 主キーによる前方一致検索"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial06.html" title="3.6. タグ検索・参照関係の逆引き"
+             >previous</a> |</li>
+        <li><a href="../index.html">groonga v1.0.2 documentation</a> &raquo;</li>
+          <li><a href="../tutorial.html" >3. チュートリアル</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2009-2010, Brazil, Inc.
+      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.1.
+    </div>
+  </body>
+</html>