RubyGems - rroonga - Versions diffs - 4.0.0-x86-mingw32 → 4.0.1-x86-mingw32 - Mend

rroonga 4.0.0-x86-mingw32 → 4.0.1-x86-mingw32

Files changed (449) hide show

data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html ADDED Viewed

@@ -0,0 +1,857 @@
+<!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>Vector column &mdash; Groonga v4.0.1 documentation</title>
+    <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
+    <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../../',
+        VERSION:     '4.0.1',
+        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="shortcut icon" href="../../_static/favicon.ico"/>
+    <link rel="top" title="Groonga v4.0.1 documentation" href="../../index.html" />
+  </head>
+  <body role="document">
+<div class="header">
+  <h1 class="title">
+    <a id="top-link" href="../../index.html">
+      <span class="project">groonga</span>
+      <span class="separator">-</span>
+      <span class="description">An open-source fulltext search engine and column store.</span>
+    </a>
+  </h1>
+  <div class="other-language-links">
+    <ul>
+      <li><a href="../../../../ja/html/reference/columns/vector.html"><img src="../../_static/jp.png" alt="日本語">日本語版はこちら</a></li>
+    </ul>
+  </div>
+</div>
+    <div class="related" role="navigation" aria-label="related navigation">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li><a href="../../index.html">Groonga v4.0.1 documentation</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body" role="main">
+  <div class="section" id="vector-column">
+<h1>Vector column<a class="headerlink" href="#vector-column" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="summary">
+<h2>Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
+<p>Vector column is a data store object. It can stores zero or more
+scalar values. In short, scalar value is a single value such as number
+and string. See <tt class="xref doc docutils literal"><span class="pre">scalar</span></tt> about scalar value details.</p>
+<p>One of vector column use cases is tags store. You can use a vector
+column to store tag values.</p>
+<p>You can use vector column as index search target in the same way as
+scalar column. You can set weight for each element. The element that
+has one or more weight is matched, the record has more score rather
+than no weight case. It is a vector column specific feature. Vector
+column that can store weight is called weight vector column.</p>
+<p>You can also do full text search against each text element. But search
+score is too high when weight is used. You should use full text search
+with weight carefully.</p>
+</div>
+<div class="section" id="usage">
+<h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
+<p>There are three vector column types:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Normal vector column</li>
+<li>Reference vector column</li>
+<li>Weight vector column</li>
+</ul>
+</div></blockquote>
+<p>This section describes how to use these types.</p>
+<div class="section" id="normal-vector-column">
+<span id="id1"></span><h3>Normal vector column<a class="headerlink" href="#normal-vector-column" title="Permalink to this headline">¶</a></h3>
+<p>Normal vector column stores zero or more scalar data. For example,
+scalar data are number, string and so on.</p>
+<p>A normal vector column can store the same type elements. You can't mix
+types. For example, you can't store a number and a string in the same
+normal vector column.</p>
+<p>Normal vector column is useful when a record has multiple values with
+a key. Tags are the most popular use case.</p>
+<div class="section" id="how-to-create">
+<h4>How to create<a class="headerlink" href="#how-to-create" title="Permalink to this headline">¶</a></h4>
+<p>Use <a class="reference internal" href="../commands/column_create.html"><em>column_create</em></a> command to create a
+normal vector column. The point is <tt class="docutils literal"><span class="pre">COLUMN_VECTOR</span></tt> flag:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>table_create Bookmarks TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Bookmarks tags COLUMN_VECTOR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>You can set zero or more tags to a bookmark.</p>
+</div>
+<div class="section" id="how-to-load">
+<h4>How to load<a class="headerlink" href="#how-to-load" title="Permalink to this headline">¶</a></h4>
+<p>You can load vector data by JSON array syntax:</p>
+<div class="highlight-none"><div class="highlight"><pre>[ELEMENT1, ELEMENT2, ELEMENT3, ...]
+</pre></div>
+</div>
+<p>Let's load the following data:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="50%" />
+<col width="50%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head"><tt class="docutils literal"><span class="pre">_key</span></tt></th>
+<th class="head"><tt class="docutils literal"><span class="pre">tags</span></tt></th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">http://groonga.org/</span></tt></td>
+<td><tt class="docutils literal"><span class="pre">[&quot;groonga&quot;]</span></tt></td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">http://mroonga.org/</span></tt></td>
+<td><tt class="docutils literal"><span class="pre">[&quot;mroonga&quot;,</span> <span class="pre">&quot;mysql&quot;,</span> <span class="pre">&quot;groonga&quot;]</span></tt></td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">http://ranguba.org/</span></tt></td>
+<td><tt class="docutils literal"><span class="pre">[&quot;ruby&quot;,</span> <span class="pre">&quot;groonga&quot;]</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Here is a command that loads the data:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>load --table Bookmarks
+[
+{&quot;_key&quot;: &quot;http://groonga.org/&quot;, &quot;tags&quot;: [&quot;groonga&quot;]},
+{&quot;_key&quot;: &quot;http://mroonga.org/&quot;, &quot;tags&quot;: [&quot;mroonga&quot;, &quot;mysql&quot;, &quot;groonga&quot;]},
+{&quot;_key&quot;: &quot;http://ranguba.org/&quot;, &quot;tags&quot;: [&quot;ruby&quot;, &quot;groonga&quot;]}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
+</pre></div>
+</div>
+<p>The loaded data can be outputted as JSON array syntax:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           &quot;_id&quot;,
+#           &quot;UInt32&quot;
+#         ],
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ]
+#       ],
+#       [
+#         1,
+#         &quot;http://groonga.org/&quot;,
+#         [
+#           &quot;groonga&quot;
+#         ]
+#       ],
+#       [
+#         2,
+#         &quot;http://mroonga.org/&quot;,
+#         [
+#           &quot;mroonga&quot;,
+#           &quot;mysql&quot;,
+#           &quot;groonga&quot;
+#         ]
+#       ],
+#       [
+#         3,
+#         &quot;http://ranguba.org/&quot;,
+#         [
+#           &quot;ruby&quot;,
+#           &quot;groonga&quot;
+#         ]
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+</div>
+<div class="section" id="how-to-search">
+<h4>How to search<a class="headerlink" href="#how-to-search" title="Permalink to this headline">¶</a></h4>
+<p>You need to create an index to search normal vector column:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>table_create Tags TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Tags bookmark_index COLUMN_INDEX Bookmarks tags
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>There are no vector column specific way. You can create an index like
+a scalar column.</p>
+<p>You can search an element in <tt class="docutils literal"><span class="pre">tags</span></tt> like full text search syntax.</p>
+<p>With <a class="reference internal" href="../commands/select.html#select-match-columns"><em>match_columns</em></a> and <a class="reference internal" href="../commands/select.html#select-query"><em>query</em></a>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks --match_columns tags --query mysql --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;http://mroonga.org/&quot;,
+#         [
+#           &quot;mroonga&quot;,
+#           &quot;mysql&quot;,
+#           &quot;groonga&quot;
+#         ],
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>You can also use weight in <a class="reference internal" href="../commands/select.html#select-match-columns"><em>match_columns</em></a>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks --match_columns &#39;tags * 3&#39; --query mysql --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;http://mroonga.org/&quot;,
+#         [
+#           &quot;mroonga&quot;,
+#           &quot;mysql&quot;,
+#           &quot;groonga&quot;
+#         ],
+#         3
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>With <a class="reference internal" href="../commands/select.html#select-filter"><em>filter</em></a>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks --filter &#39;tags @ &quot;msyql&quot;&#39; --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         0
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="reference-vector-column">
+<span id="id2"></span><h3>Reference vector column<a class="headerlink" href="#reference-vector-column" title="Permalink to this headline">¶</a></h3>
+<p>TODO</p>
+<p>Reference vector column is space-efficient if there are many same
+value elements. Reference vector column keeps reference record IDs not
+value itself. Record ID is smaller than value itself.</p>
+<div class="section" id="id3">
+<h4>How to create<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h4>
+<p>TODO</p>
+</div>
+<div class="section" id="id4">
+<h4>How to load<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h4>
+<p>TODO</p>
+</div>
+<div class="section" id="id5">
+<h4>How to search<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h4>
+<p>TODO</p>
+</div>
+</div>
+<div class="section" id="weight-vector-column">
+<span id="id6"></span><h3>Weight vector column<a class="headerlink" href="#weight-vector-column" title="Permalink to this headline">¶</a></h3>
+<p>Weight vector column is similar to normal vector column. It can store
+elements. It can also stores weights for them. Weight is degree of
+importance of the element.</p>
+<p>Weight is positive integer. <tt class="docutils literal"><span class="pre">0</span></tt> is the default weight. It means that
+no weight.</p>
+<p>If weight is one or larger, search score is increased by the
+weight. If the weight is <tt class="docutils literal"><span class="pre">0</span></tt>, score is <tt class="docutils literal"><span class="pre">1</span></tt>. If the weight is
+<tt class="docutils literal"><span class="pre">10</span></tt>, score is <tt class="docutils literal"><span class="pre">11</span></tt> (<tt class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">10</span></tt>).</p>
+<p>Weight vector column is useful for tuning search score. See also
+<a class="reference internal" href="../commands/select.html#select-adjuster"><em>adjuster</em></a>. You can increase search score of specific
+records.</p>
+<div class="section" id="limitations">
+<h4>Limitations<a class="headerlink" href="#limitations" title="Permalink to this headline">¶</a></h4>
+<p>There are some limitations for now. They will be resolved in the
+future.</p>
+<p>Here are limitations:</p>
+<blockquote>
+<div><ul class="simple">
+<li>You need to use string representation for element value on load.
+For example, you can't use <tt class="docutils literal"><span class="pre">29</span></tt> for number 29. You need to use
+<tt class="docutils literal"><span class="pre">&quot;29&quot;</span></tt> for number 29.</li>
+<li>You can't use reference type.</li>
+</ul>
+</div></blockquote>
+</div>
+<div class="section" id="id7">
+<h4>How to create<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h4>
+<p>Use <a class="reference internal" href="../commands/column_create.html"><em>column_create</em></a> command to create a
+weight vector column. The point is <tt class="docutils literal"><span class="pre">COLUMN_VECTOR|WITH_WEIGHT</span></tt>
+flags:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>table_create Bookmarks TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Bookmarks tags COLUMN_VECTOR|WITH_WEIGHT ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>If you don't specify <tt class="docutils literal"><span class="pre">WITH_WEIGHT</span></tt> flag, it is just a normal vector
+column.</p>
+<p>You can set zero or more tags with weight to a bookmark.</p>
+</div>
+<div class="section" id="id8">
+<h4>How to load<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h4>
+<p>You can load vector data by JSON object syntax:</p>
+<div class="highlight-none"><div class="highlight"><pre>{&quot;ELEMENT1&quot;: WEIGHT1, &quot;ELEMENT2&quot;: WEIGHT2, &quot;ELEMENT3&quot;: WEIGHT3, ...}
+</pre></div>
+</div>
+<p>Let's load the following data:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="50%" />
+<col width="50%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head"><tt class="docutils literal"><span class="pre">_key</span></tt></th>
+<th class="head"><tt class="docutils literal"><span class="pre">tags</span></tt></th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">http://groonga.org/</span></tt></td>
+<td><tt class="docutils literal"><span class="pre">{&quot;groonga&quot;:</span> <span class="pre">100}</span></tt></td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">http://mroonga.org/</span></tt></td>
+<td><tt class="docutils literal"><span class="pre">{&quot;mroonga&quot;:</span> <span class="pre">100,</span> <span class="pre">&quot;mysql&quot;:</span> <span class="pre">50,</span> <span class="pre">&quot;groonga&quot;:</span> <span class="pre">10}</span></tt></td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">http://ranguba.org/</span></tt></td>
+<td><tt class="docutils literal"><span class="pre">{&quot;ruby&quot;:</span> <span class="pre">100,</span> <span class="pre">&quot;groonga&quot;:</span> <span class="pre">50}</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>Here is a command that loads the data:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>load --table Bookmarks
+[
+{&quot;_key&quot;: &quot;http://groonga.org/&quot;,
+ &quot;tags&quot;: {&quot;groonga&quot;: 100}},
+{&quot;_key&quot;: &quot;http://mroonga.org/&quot;,
+ &quot;tags&quot;: {&quot;mroonga&quot;: 100,
+          &quot;mysql&quot;:   50,
+          &quot;groonga&quot;: 10}},
+{&quot;_key&quot;: &quot;http://ranguba.org/&quot;,
+ &quot;tags&quot;: {&quot;ruby&quot;: 100,
+          &quot;groonga&quot;: 50}}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
+</pre></div>
+</div>
+<p>The loaded data can be outputted as JSON object syntax:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           &quot;_id&quot;,
+#           &quot;UInt32&quot;
+#         ],
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ]
+#       ],
+#       [
+#         1,
+#         &quot;http://groonga.org/&quot;,
+#         {
+#           &quot;groonga&quot;: 100
+#         }
+#       ],
+#       [
+#         2,
+#         &quot;http://mroonga.org/&quot;,
+#         {
+#           &quot;mroonga&quot;: 100,
+#           &quot;groonga&quot;: 10,
+#           &quot;mysql&quot;: 50
+#         }
+#       ],
+#       [
+#         3,
+#         &quot;http://ranguba.org/&quot;,
+#         {
+#           &quot;ruby&quot;: 100,
+#           &quot;groonga&quot;: 50
+#         }
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+</div>
+<div class="section" id="id9">
+<h4>How to search<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h4>
+<p>You need to create an index to search weight vector column. You don't
+forget to specify <tt class="docutils literal"><span class="pre">WITH_WEIGHT</span></tt> flag to <tt class="docutils literal"><span class="pre">column_create</span></tt>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>table_create Tags TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Tags bookmark_index COLUMN_INDEX|WITH_WEIGHT Bookmarks tags
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>There are no weight vector column specific way except <tt class="docutils literal"><span class="pre">WITH_WEIGHT</span></tt>
+flag. You can create an index like a scalar column.</p>
+<p>You can search an element in <tt class="docutils literal"><span class="pre">tags</span></tt> like full text search syntax.</p>
+<p>With <a class="reference internal" href="../commands/select.html#select-match-columns"><em>match_columns</em></a> and <a class="reference internal" href="../commands/select.html#select-query"><em>query</em></a>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks --match_columns tags --query groonga --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;http://groonga.org/&quot;,
+#         {
+#           &quot;groonga&quot;: 100
+#         },
+#         101
+#       ],
+#       [
+#         &quot;http://mroonga.org/&quot;,
+#         {
+#           &quot;mroonga&quot;: 100,
+#           &quot;groonga&quot;: 10,
+#           &quot;mysql&quot;: 50
+#         },
+#         11
+#       ],
+#       [
+#         &quot;http://ranguba.org/&quot;,
+#         {
+#           &quot;ruby&quot;: 100,
+#           &quot;groonga&quot;: 50
+#         },
+#         51
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>You can also use weight in <a class="reference internal" href="../commands/select.html#select-match-columns"><em>match_columns</em></a>. The score is
+<tt class="docutils literal"><span class="pre">(1</span> <span class="pre">+</span> <span class="pre">weight_in_weight_vector)</span> <span class="pre">*</span> <span class="pre">weight_in_match_columns</span></tt>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks --match_columns &#39;tags * 3&#39; --query groonga --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;http://groonga.org/&quot;,
+#         {
+#           &quot;groonga&quot;: 100
+#         },
+#         303
+#       ],
+#       [
+#         &quot;http://mroonga.org/&quot;,
+#         {
+#           &quot;mroonga&quot;: 100,
+#           &quot;groonga&quot;: 10,
+#           &quot;mysql&quot;: 50
+#         },
+#         33
+#       ],
+#       [
+#         &quot;http://ranguba.org/&quot;,
+#         {
+#           &quot;ruby&quot;: 100,
+#           &quot;groonga&quot;: 50
+#         },
+#         153
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>With <a class="reference internal" href="../commands/select.html#select-filter"><em>filter</em></a>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks --filter &#39;tags @ &quot;groonga&quot;&#39; --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;http://groonga.org/&quot;,
+#         {
+#           &quot;groonga&quot;: 100
+#         },
+#         101
+#       ],
+#       [
+#         &quot;http://mroonga.org/&quot;,
+#         {
+#           &quot;mroonga&quot;: 100,
+#           &quot;groonga&quot;: 10,
+#           &quot;mysql&quot;: 50
+#         },
+#         11
+#       ],
+#       [
+#         &quot;http://ranguba.org/&quot;,
+#         {
+#           &quot;ruby&quot;: 100,
+#           &quot;groonga&quot;: 50
+#         },
+#         51
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+</div>
+<div class="section" id="how-to-apply-just-weight">
+<h4>How to apply just weight<a class="headerlink" href="#how-to-apply-just-weight" title="Permalink to this headline">¶</a></h4>
+<p>You can use weight in weight vector column to just increase search
+score without changing a set of matched records.</p>
+<p>Use <a class="reference internal" href="../commands/select.html#select-adjuster"><em>adjuster</em></a> for the purpose:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Bookmarks \
+  --filter true \
+  --adjuster &#39;tags @ &quot;mysql&quot; * 10 + tags @ &quot;groonga&quot; * 5&#39; \
+  --output_columns _key,tags,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;tags&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;http://groonga.org/&quot;,
+#         {
+#           &quot;groonga&quot;: 100
+#         },
+#         506
+#       ],
+#       [
+#         &quot;http://mroonga.org/&quot;,
+#         {
+#           &quot;mroonga&quot;: 100,
+#           &quot;groonga&quot;: 10,
+#           &quot;mysql&quot;: 50
+#         },
+#         566
+#       ],
+#       [
+#         &quot;http://ranguba.org/&quot;,
+#         {
+#           &quot;ruby&quot;: 100,
+#           &quot;groonga&quot;: 50
+#         },
+#         256
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>The <tt class="docutils literal"><span class="pre">select</span></tt> command uses <tt class="docutils literal"><span class="pre">--filter</span> <span class="pre">true</span></tt>. So all records are
+matched with score 1. Then it applies <tt class="docutils literal"><span class="pre">--adjuster</span></tt>. The adjuster
+does the following:</p>
+<blockquote>
+<div><ul class="simple">
+<li><tt class="docutils literal"><span class="pre">tags</span> <span class="pre">&#64;</span> <span class="pre">&quot;mysql&quot;</span> <span class="pre">*</span> <span class="pre">10</span></tt> increases score by <tt class="docutils literal"><span class="pre">(1</span> <span class="pre">+</span> <span class="pre">weight)</span> <span class="pre">*</span> <span class="pre">10</span></tt>
+of records that has <tt class="docutils literal"><span class="pre">&quot;mysql&quot;</span></tt> tag.</li>
+<li><tt class="docutils literal"><span class="pre">tags</span> <span class="pre">&#64;</span> <span class="pre">&quot;groonga&quot;</span> <span class="pre">*</span> <span class="pre">5</span></tt> increases score by <tt class="docutils literal"><span class="pre">(1</span> <span class="pre">+</span> <span class="pre">weight)</span> <span class="pre">*</span> <span class="pre">5</span></tt>
+of records that has <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt> tag.</li>
+</ul>
+</div></blockquote>
+<p>For example, record <tt class="docutils literal"><span class="pre">&quot;http://mroonga.org/&quot;</span></tt> has both <tt class="docutils literal"><span class="pre">&quot;mysql&quot;</span></tt> tag
+and <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt> tag. So its score is increased by <tt class="docutils literal"><span class="pre">565</span></tt> (<tt class="docutils literal"><span class="pre">=</span>
+<span class="pre">((1</span> <span class="pre">+</span> <span class="pre">50)</span> <span class="pre">*</span> <span class="pre">10)</span> <span class="pre">+</span> <span class="pre">((1</span> <span class="pre">+</span> <span class="pre">10)</span> <span class="pre">*</span> <span class="pre">5)</span> <span class="pre">=</span> <span class="pre">(51</span> <span class="pre">*</span> <span class="pre">10)</span> <span class="pre">+</span> <span class="pre">(11</span> <span class="pre">*</span> <span class="pre">5)</span> <span class="pre">=</span> <span class="pre">510</span> <span class="pre">+</span> <span class="pre">55</span></tt>).
+The search score is 1 by <tt class="docutils literal"><span class="pre">--filter</span> <span class="pre">true</span></tt> before applying
+<tt class="docutils literal"><span class="pre">--adjuster</span></tt>. So the final search score is <tt class="docutils literal"><span class="pre">566</span></tt> (<tt class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">565</span></tt>)
+of record <tt class="docutils literal"><span class="pre">&quot;http://mroonga.org/&quot;</span></tt>.</p>
+</div>
+</div>
+</div>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
+        <div class="sphinxsidebarwrapper">
+  <h3><a href="../../index.html">Table Of Contents</a></h3>
+  <ul>
+<li><a class="reference internal" href="#">Vector column</a><ul>
+<li><a class="reference internal" href="#summary">Summary</a></li>
+<li><a class="reference internal" href="#usage">Usage</a><ul>
+<li><a class="reference internal" href="#normal-vector-column">Normal vector column</a><ul>
+<li><a class="reference internal" href="#how-to-create">How to create</a></li>
+<li><a class="reference internal" href="#how-to-load">How to load</a></li>
+<li><a class="reference internal" href="#how-to-search">How to search</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#reference-vector-column">Reference vector column</a><ul>
+<li><a class="reference internal" href="#id3">How to create</a></li>
+<li><a class="reference internal" href="#id4">How to load</a></li>
+<li><a class="reference internal" href="#id5">How to search</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#weight-vector-column">Weight vector column</a><ul>
+<li><a class="reference internal" href="#limitations">Limitations</a></li>
+<li><a class="reference internal" href="#id7">How to create</a></li>
+<li><a class="reference internal" href="#id8">How to load</a></li>
+<li><a class="reference internal" href="#id9">How to search</a></li>
+<li><a class="reference internal" href="#how-to-apply-just-weight">How to apply just weight</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+  <div role="note" aria-label="source link">
+    <h3>This Page</h3>
+    <ul class="this-page-menu">
+      <li><a href="../../_sources/reference/columns/vector.txt"
+            rel="nofollow">Show Source</a></li>
+    </ul>
+   </div>
+<div id="searchbox" style="display: none" role="search">
+  <h3>Quick search</h3>
+    <form class="search" action="../../search.html" method="get">
+      <input type="text" name="q" />
+      <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" role="navigation" aria-label="related navigation">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../../genindex.html" title="General Index"
+             >index</a></li>
+        <li><a href="../../index.html">Groonga v4.0.1 documentation</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer" role="contentinfo">
+        &copy; Copyright 2009-2014, Brazil, Inc.
+    </div>
+  </body>
+</html>