RubyGems - rroonga - Versions diffs - 5.0.5-x86-mingw32 → 5.0.8-x86-mingw32 - Mend

rroonga 5.0.5-x86-mingw32 → 5.0.8-x86-mingw32

Files changed (594) hide show

data/vendor/local/share/doc/groonga/ja/html/reference/output.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.2. 出力 &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.2. 出力 &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,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 v5.0.6-226-gd7da7e7ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../index.html" />
     <link rel="up" title="7. リファレンスマニュアル" href="../reference.html" />
     <link rel="next" title="7.3. コマンド" href="command.html" />
     <link rel="prev" title="7.1.9. groonga-suggest-learner" href="executables/groonga-suggest-learner.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="executables/groonga-suggest-learner.html" title="7.1.9. groonga-suggest-learner"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" accesskey="U">7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>
@@ -279,7 +279,7 @@ END
         <li class="right" >
           <a href="executables/groonga-suggest-learner.html" title="7.1.9. groonga-suggest-learner"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.10. クエリー展開オブジェクト一覧 &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.10. クエリー展開オブジェクト一覧 &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,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 v5.0.6-226-gd7da7e7ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../index.html" />
     <link rel="up" title="7. リファレンスマニュアル" href="../reference.html" />
     <link rel="next" title="7.10.1. QueryExpanderTSV" href="query_expanders/tsv.html" />
     <link rel="prev" title="7.9. トークンフィルター" href="token_filters.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="token_filters.html" title="7.9. トークンフィルター"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" accesskey="U">7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>
@@ -128,7 +128,7 @@
         <li class="right" >
           <a href="token_filters.html" title="7.9. トークンフィルター"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.10.1. QueryExpanderTSV &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.10.1. QueryExpanderTSV &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,9 +26,9 @@
     <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 v5.0.6-226-gd7da7e7ドキュメント" href="../../index.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../../index.html" />
     <link rel="up" title="7.10. クエリー展開オブジェクト一覧" href="../query_expanders.html" />
-    <link rel="next" title="7.11. Scorer" href="../scorer.html" />
+    <link rel="next" title="7.11. スコアラー" href="../scorer.html" />
     <link rel="prev" title="7.10. クエリー展開オブジェクト一覧" href="../query_expanders.html" />
   </head>
   <body role="document">
@@ -56,12 +56,12 @@
           <a href="../../genindex.html" title="総合索引"
              accesskey="I">索引</a></li>
         <li class="right" >
-          <a href="../scorer.html" title="7.11. Scorer"
+          <a href="../scorer.html" title="7.11. スコアラー"
              accesskey="N">次へ</a> |</li>
         <li class="right" >
           <a href="../query_expanders.html" title="7.10. クエリー展開オブジェクト一覧"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
           <li class="nav-item nav-item-2"><a href="../query_expanders.html" accesskey="U">7.10. クエリー展開オブジェクト一覧</a> &raquo;</li>
       </ul>
@@ -235,7 +235,7 @@ mroonga(TAB)mroonga(TAB)groonga MySQL
                         title="前の章へ">7.10. クエリー展開オブジェクト一覧</a></p>
   <h4>次のトピックへ</h4>
   <p class="topless"><a href="../scorer.html"
-                        title="次の章へ">7.11. Scorer</a></p>
+                        title="次の章へ">7.11. スコアラー</a></p>
   <div role="note" aria-label="source link">
     <h3>このページ</h3>
     <ul class="this-page-menu">
@@ -267,12 +267,12 @@ mroonga(TAB)mroonga(TAB)groonga MySQL
           <a href="../../genindex.html" title="総合索引"
              >索引</a></li>
         <li class="right" >
-          <a href="../scorer.html" title="7.11. Scorer"
+          <a href="../scorer.html" title="7.11. スコアラー"
              >次へ</a> |</li>
         <li class="right" >
           <a href="../query_expanders.html" title="7.10. クエリー展開オブジェクト一覧"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
           <li class="nav-item nav-item-2"><a href="../query_expanders.html" >7.10. クエリー展開オブジェクト一覧</a> &raquo;</li>
       </ul>

data/vendor/local/share/doc/groonga/ja/html/reference/regular_expression.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.13. 正規表現 &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.13. 正規表現 &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,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 v5.0.6-226-gd7da7e7ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../index.html" />
     <link rel="up" title="7. リファレンスマニュアル" href="../reference.html" />
     <link rel="next" title="7.14. 関数" href="function.html" />
     <link rel="prev" title="7.12.2. スクリプト構文" href="grn_expr/script_syntax.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="grn_expr/script_syntax.html" title="7.12.2. スクリプト構文"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" accesskey="U">7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>
@@ -85,8 +85,17 @@
 <p>Groongaは正規表現を用いたパターンマッチをサポートしています。正規表現はパターンを表現するために広く使われています。正規表現は複雑なパターンを表現するときに便利です。</p>
 <p>多くの場合は、正規表現検索は逐次検索で実行します。これはたくさんのレコードがあったり、たくさんのテキストがある場合は遅くなります。</p>
 <p>いくつかの場合では、正規表現を使ったパターンマッチをインデックスを使って実現します。これは逐次検索よりも非常に高速です。インデックスを使って評価できるパターンについては後述します。</p>
+<div class="versionadded">
+<p><span class="versionmodified">バージョン 5.0.7 で追加: </span>Groongaは正規表現検索にインデックスを使わないときは、 <a class="reference internal" href="normalizers.html#normalizer-auto"><span>NormalizerAuto</span></a> ノーマライザーでマッチ対象のテキストを正規化します。これは、 <code class="docutils literal"><span class="pre">Groonga</span></code> というような大文字を使った正規表現は必ずマッチに失敗するということです。なぜなら、 <a class="reference internal" href="normalizers.html#normalizer-auto"><span>NormalizerAuto</span></a> ノーマライザーはすべてのアルファベットを小文字に正規化するからです。 <code class="docutils literal"><span class="pre">groonga</span></code> は <code class="docutils literal"><span class="pre">Groonga</span></code> にも <code class="docutils literal"><span class="pre">groonga</span></code> にも両方にマッチします。</p>
+<p>なぜマッチ対象のテキストを正規化するのでしょうか？それは、インデックスを使って検索できるパターンを増やすためです。もし、Groongaがマッチ対象のテキストを正規化しなかった場合、大文字小文字を区別しないマッチをするために、 <code class="docutils literal"><span class="pre">[Dd][Ii][Ss][Kk]</span></code> や <code class="docutils literal"><span class="pre">(?i)disk</span></code> のような複雑な正規表現を書く必要があります。Groongaは複雑な正規表現に対してインデックスを使うことができません。</p>
+<p>もし、大文字小文字を区別しないマッチに <code class="docutils literal"><span class="pre">disk</span></code> という正規表現を使うなら、Groongaはインデックスを使ってこのパターンを検索できます。これは高速です。</p>
+<p>この挙動を奇妙に思うかもしれません。しかし、この挙動のおかげで高速に検索できることはきっとあなたの役に立つはずです。</p>
+</div>
 <p>正規表現の構文はたくさんあります。GroongaはRubyと同じ構文を使います。なぜなら、Groongaが使っている正規表現エンジンはRubyが使っている正規表現エンジンと同じだからです。この正規表現エンジンは <a class="reference external" href="https://github.com/k-takata/Onigmo/">Onigmo</a> といいます。他の正規表現の構文との特徴的な違いは <code class="docutils literal"><span class="pre">^</span></code> と <code class="docutils literal"><span class="pre">$</span></code> です。Rubyの正規表現の構文では <code class="docutils literal"><span class="pre">^</span></code> は行頭を表し、 <code class="docutils literal"><span class="pre">$</span></code> は行末を表します。他の多くの正規表現の構文では、 <code class="docutils literal"><span class="pre">^</span></code> はテキストの先頭を表し、 <code class="docutils literal"><span class="pre">$</span></code> はテキストの最後を表します。Rubyの正規表現の構文ではテキストの先頭を表す場合は <code class="docutils literal"><span class="pre">\A</span></code> を使い、テキストの最後を表す場合は <code class="docutils literal"><span class="pre">\z</span></code> を使います。</p>
-<p>Groongaは5.0.6からマルチラインモードを有効にしています。これは、 <code class="docutils literal"><span class="pre">.</span></code> が <code class="docutils literal"><span class="pre">\n</span></code> にマッチするということです。</p>
+<div class="versionadded">
+<p><span class="versionmodified">バージョン 5.0.6 で追加: </span>Groongaは5.0.6からマルチラインモードを有効にしています。これは、 <code class="docutils literal"><span class="pre">.</span></code> が <code class="docutils literal"><span class="pre">\n</span></code> にマッチするということです。</p>
+<p>しかし、この挙動は意味がありません。なぜなら、 <code class="docutils literal"><span class="pre">\n</span></code> は <a class="reference internal" href="normalizers.html#normalizer-auto"><span>NormalizerAuto</span></a> ノーマライザーが削除するからです。</p>
+</div>
 <p><a class="reference internal" href="commands/select.html"><em>select</em></a> コマンドの <a class="reference internal" href="commands/select.html#select-query"><span>query</span></a> オプションと <a class="reference internal" href="commands/select.html#select-filter"><span>filter</span></a> オプションで正規表現を使えます。</p>
 </div>
 <div class="section" id="usage">
@@ -110,7 +119,7 @@ load --table Logs
 </div>
 <p><a class="reference internal" href="commands/select.html#select-query"><span>query</span></a> で正規表現を使う例です。 <code class="docutils literal"><span class="pre">${COLUMN}:~${REGULAR_EXPRESSION}</span></code> という構文を使います。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre>select Logs --query &#39;message:~&quot;[Dd]isk&quot;&#39;
+<div class="highlight-none"><div class="highlight"><pre>select Logs --query &#39;message:~&quot;disk (space|full)&quot;&#39;
 # [
 #   [
 #     0,
@@ -147,7 +156,7 @@ load --table Logs
 </div>
 <p><a class="reference internal" href="commands/select.html#select-filter"><span>filter</span></a> で正規表現を使う例です。 <code class="docutils literal"><span class="pre">${COLUMN}</span> <span class="pre">&#64;~</span> <span class="pre">${REGULAR_EXPRESSION}</span></code> という構文を使います。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre>select Logs --filter &#39;message @~ &quot;[Dd]isk&quot;&#39;
+<div class="highlight-none"><div class="highlight"><pre>select Logs --filter &#39;message @~ &quot;disk (space|full)&quot;&#39;
 # [
 #   [
 #     0,
@@ -562,9 +571,9 @@ column_create RegexpLexicon logs_message_index \
 <div class="section" id="character-class">
 <span id="regular-expression-character-class"></span><h3>7.13.4.4. 文字クラス<a class="headerlink" href="#character-class" title="このヘッドラインへのパーマリンク">¶</a></h3>
 <p>文字クラスの構文は <code class="docutils literal"><span class="pre">[...]</span></code> です。文字クラスはマッチする文字を複数指定するときに便利です。</p>
-<p>たとえば、 <code class="docutils literal"><span class="pre">[Dd]</span></code> は <code class="docutils literal"><span class="pre">D</span></code> または <code class="docutils literal"><span class="pre">d</span></code> にマッチします。</p>
+<p>たとえば、 <code class="docutils literal"><span class="pre">[12]</span></code> は <code class="docutils literal"><span class="pre">1</span></code> または <code class="docutils literal"><span class="pre">2</span></code> にマッチします。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre>select Logs --filter &#39;message @~ &quot;[Dd]isk&quot;&#39;
+<div class="highlight-none"><div class="highlight"><pre>select Logs --filter &#39;message @~ &quot;host[12]&quot;&#39;
 # [
 #   [
 #     0,
@@ -574,7 +583,7 @@ column_create RegexpLexicon logs_message_index \
 #   [
 #     [
 #       [
-#         2
+#         5
 #       ],
 #       [
 #         [
@@ -587,12 +596,24 @@ column_create RegexpLexicon logs_message_index \
 #         ]
 #       ],
 #       [
+#         1,
+#         &quot;host1:[error]: No memory&quot;
+#       ],
+#       [
 #         2,
 #         &quot;host1:[warning]: Remained disk space is less than 30%&quot;
 #       ],
 #       [
 #         3,
 #         &quot;host1:[error]: Disk full&quot;
+#       ],
+#       [
+#         4,
+#         &quot;host2:[error]: No memory&quot;
+#       ],
+#       [
+#         5,
+#         &quot;host2:[info]: Shutdown&quot;
 #       ]
 #     ]
 #   ]
@@ -870,7 +891,7 @@ column_create RegexpLexicon logs_message_index \
         <li class="right" >
           <a href="grn_expr/script_syntax.html" title="7.12.2. スクリプト構文"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/reference/scorer.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.11. Scorer &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.11. スコアラー &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,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 v5.0.6-226-gd7da7e7ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../index.html" />
     <link rel="up" title="7. リファレンスマニュアル" href="../reference.html" />
     <link rel="next" title="7.11.3.1. scorer_tf_at_most" href="scorers/scorer_tf_at_most.html" />
     <link rel="prev" title="7.10.1. QueryExpanderTSV" href="query_expanders/tsv.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="query_expanders/tsv.html" title="7.10.1. QueryExpanderTSV"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" accesskey="U">7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>
@@ -72,52 +72,30 @@
           <div class="body" role="main">
   <div class="section" id="scorer">
-<h1>7.11. Scorer<a class="headerlink" href="#scorer" title="このヘッドラインへのパーマリンク">¶</a></h1>
+<h1>7.11. スコアラー<a class="headerlink" href="#scorer" title="このヘッドラインへのパーマリンク">¶</a></h1>
 <div class="section" id="summary">
 <h2>7.11.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>Groonga has scorer module that customizes score function. Score
-function computes score of matched record. The default scorer function
-uses the number of appeared terms. It is also known as TF (term
-frequency).</p>
-<p>TF is a fast score function but it's not suitable for the following
-cases:</p>
+<p>Groongaにはスコアー関数をカスタマイズするスコアーモジュールがあります。スコアー関数はマッチしたレコードのスコアーを計算します。デフォルトのスコアー関数は出現単語数をスコアーにします。これはTF（term frequency。単語の出現数）と呼ばれている計算方法です。</p>
+<p>TFは高速なスコアー関数ですが、次のケースには適していません。</p>
 <blockquote>
 <div><ul class="simple">
-<li>Search query contains one or more frequently-appearing words such
-as &quot;the&quot; and &quot;a&quot;.</li>
-<li>Document contains many same keywords such as &quot;They are keyword,
-keyword, keyword ... and keyword&quot;. Search engine spammer may use
-the technique.</li>
+<li><p class="first">検索クエリーが「the」や「a」のように非常によく出現する単語を含んでいる。</p>
+</li>
+<li><p class="first">文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれている。検索エンジンのスパマーはこのテクニックを使うかもしれません。</p>
+</li>
 </ul>
 </div></blockquote>
-<p>Score function can solve these cases. For example, <a class="reference external" href="http://en.wikipedia.org/wiki/Tf%E2%80%93idf">TF-IDF</a> (term
-frequency-inverse document frequency) can solve the first case.
-<a class="reference external" href="http://en.wikipedia.org/wiki/Okapi_BM25">Okapi BM25</a> can solve the
-second case. But their are slower than TF.</p>
-<p>Groonga provides TF-IDF based scorer as
-<a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a> but doesn't provide Okapi BM25
-based scorer yet.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">orphan:</th><td class="field-body"></td>
-</tr>
-</tbody>
-</table>
+<p>スコアー関数でこれらのケースを解決できます。例えば、 <a class="reference external" href="https://ja.wikipedia.org/wiki/Tf-idf">TF-IDF</a> （term frequency-inverse document frequency。その文書中での単語の出現数を、文書全体での単語の出現数で割ったもの）は最初のケースを解決できます。 <a class="reference external" href="https://en.wikipedia.org/wiki/Okapi_BM25">Okapi BM25</a> は2番目のケースを解決できます。しかし、これらはTFより遅いです。</p>
+<p>Groongaは <a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a> としてTF-IDFベースのスコアラーを提供しています。しかし、Okapi BM25ベースのスコアラーはまだ提供していません。</p>
 <blockquote id="note">
-<div><p>You don't need to resolve scoring only by score function. Score
-function is highly depends on search query. You may be able to use
-metadata of matched record.</p>
-<p>For example, Google uses <a class="reference external" href="http://en.wikipedia.org/wiki/PageRank">PageRank</a> for scoring. You may be
-able to use data type (&quot;title&quot; data are important rather than
-&quot;memo&quot; data), tag, geolocation and so on.</p>
-<p>Please stop to think about only score function for scoring.</p>
+<div><p>スコアー関数だけでスコアの計算をする必要はありません。スコアー関数は検索クエリーに非常に依存しています。検索クエリーだけでなく、マッチしたレコードのメタデータも使えないか検討しましょう。</p>
+<p>たとえば、Googleはスコアーの計算に <a class="reference external" href="https://ja.wikipedia.org/wiki/%E3%83%9A%E3%83%BC%E3%82%B8%E3%83%A9%E3%83%B3%E3%82%AF">ページランク</a> を使っています。あなたも、データの種類（たとえば、「メモ」データよりも「タイトル」データの方が重要など）、タグ、位置情報などを使えないか検討してみましょう。</p>
+<p>スコアーの計算をスコアー関数だけで考えることはやめましょう。</p>
 </div></blockquote>
 </div>
 <div class="section" id="usage">
 <h2>7.11.2. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>このセクションではscorerの使い方について説明します。</p>
+<p>このセクションではスコアラーの使い方について説明します。</p>
 <p>使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。</p>
 <p>サンプルスキーマ:</p>
 <p>実行例:</p>
@@ -181,21 +159,19 @@ column_create Terms content_index COLUMN_INDEX|WITH_POSITION Memos content
 </pre></div>
 </div>
 <p><a class="reference internal" href="commands/select.html#select-match-columns"><span>match_columns</span></a> の中でscore関数を使うことができます。次に構文を示します。</p>
-<p>For score function that doesn't require any parameter such as
-<a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a>:</p>
+<p><a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a> のように、いくつかのスコアー関数には引数はありません。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN)
 </pre></div>
 </div>
-<p>You can specify weight:</p>
+<p>重みを指定することができます。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN) * WEIGHT
 </pre></div>
 </div>
-<p>For score function that requires one or more parameters such as
-<a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a>:</p>
+<p><a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> のように引数が必要なスコアー関数もあります。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN, ARGUMENT1, ARGUMENT2, ...)
 </pre></div>
 </div>
-<p>You can specify weight:</p>
+<p>重みを指定することができます。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN, ARGUMENT1, ARGUMENT2, ...) * WEIGHT
 </pre></div>
 </div>
@@ -247,10 +223,7 @@ column_create Terms content_index COLUMN_INDEX|WITH_POSITION Memos content
 # ]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> contains 4
-<code class="docutils literal"><span class="pre">Groonga</span></code>. If you use TF based scorer that is the default scorer,
-<code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">4</span></code>. But the actual <code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">2</span></code>. Because the
-<code class="docutils literal"><span class="pre">select</span></code> command uses TF-IDF based scorer <code class="docutils literal"><span class="pre">scorer_tf_idf()</span></code>.</p>
+<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> には <code class="docutils literal"><span class="pre">Groonga</span></code> が4つ含まれています。デフォルトのTFベースのスコアラーを使うと、 <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">4</span></code> です。しかし、実際は <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">2</span></code> になります。なぜなら、この <code class="docutils literal"><span class="pre">select</span></code> コマンドはTF-IDFベースの  <code class="docutils literal"><span class="pre">scorer_tf_idf()</span></code> スコアラーを使っているからです。</p>
 <p>以下は重みを使った例です。</p>
 <p>実行例:</p>
 <div class="highlight-none"><div class="highlight"><pre>select Memos \
@@ -292,12 +265,8 @@ column_create Terms content_index COLUMN_INDEX|WITH_POSITION Memos content
 # ]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> has <code class="docutils literal"><span class="pre">22</span></code> as
-<code class="docutils literal"><span class="pre">_score</span></code>. It had <code class="docutils literal"><span class="pre">2</span></code> as <code class="docutils literal"><span class="pre">_score</span></code> in the previous example that
-doesn't specify weight.</p>
-<p>Here is an example that uses scorer that requires one
-argument. <a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> scorer requires
-one argument. You can limit TF score by the scorer.</p>
+<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> の <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">22</span></code> です。重みを指定していない前の例では <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">2</span></code> でした。</p>
+<p>以下は必ず引数を1つ指定しなければいけないスコアラーを使う例です。 <a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> スコアラーには引数を1つ指定しなければいけません。このスコアラーを使うと、TFのスコアーの最大値を制限することができます。</p>
 <p>実行例:</p>
 <div class="highlight-none"><div class="highlight"><pre>select Memos \
   --match_columns &quot;scorer_tf_at_most(content, 2.0)&quot; \
@@ -338,38 +307,103 @@ one argument. You can limit TF score by the scorer.</p>
 # ]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> contains 4
-<code class="docutils literal"><span class="pre">Groonga</span></code>. If you use normal TF based scorer that is the default
-scorer, <code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">4</span></code>. But the actual <code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">2</span></code>.
-Because the scorer used in the <code class="docutils literal"><span class="pre">select</span></code> command limits the maximum
-score value to <code class="docutils literal"><span class="pre">2</span></code>.</p>
+<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> は <code class="docutils literal"><span class="pre">Groonga</span></code> を4つ含んでいます。もし、デフォルトのスコアラーである標準のTFベースのスコアラーを使っていた場合、 <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">4</span></code> になります。しかし、実際の <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">2</span></code> です。なぜなら、この <code class="docutils literal"><span class="pre">select</span></code> コマンドが使っているスコアラーは最大スコアーを <code class="docutils literal"><span class="pre">2</span></code> に制限しているからです。</p>
 <p>以下は複数のスコアラーを使う例です。</p>
-<div class="highlight-none"><div class="highlight"><pre>.. groonga-command
-.. include:: ../example/reference/scorer/usage_multiple_scorers.log
-.. select Memos \
-..   --match_columns &quot;scorer_tf_idf(title) || scorer_tf_at_most(content, 2.0)&quot; \
-..   --query &quot;Groonga&quot; \
-..   --output_columns &quot;title, content, _score&quot; \
-..   --sortby &quot;-_score&quot;
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Memos \
+  --match_columns &quot;scorer_tf_idf(title) || scorer_tf_at_most(content, 2.0)&quot; \
+  --query &quot;Groonga&quot; \
+  --output_columns &quot;title, content, _score&quot; \
+  --sortby &quot;-_score&quot;
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         2
+#       ],
+#       [
+#         [
+#           &quot;title&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;content&quot;,
+#           &quot;Text&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;Groonga is fast&quot;,
+#         &quot;Groonga! Groonga! Groonga! Groonga is very fast!&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Groonga is easy&quot;,
+#         &quot;Groonga is very easy full text search engine!&quot;,
+#         2
+#       ]
+#     ]
+#   ]
+# ]
 </pre></div>
 </div>
-<p>The <code class="docutils literal"><span class="pre">--match_columns</span></code> uses <code class="docutils literal"><span class="pre">scorer_tf_idf(title)</span></code> and
-<code class="docutils literal"><span class="pre">scorer_tf_at_most(content,</span> <span class="pre">2.0)</span></code>. <code class="docutils literal"><span class="pre">_score</span></code> value is sum of them.</p>
-<p>You can use the default scorer and custom scorer in the same
-<code class="docutils literal"><span class="pre">--match_columns</span></code>. You can use the default scorer by just specifying
-a match column:</p>
-<div class="highlight-none"><div class="highlight"><pre>.. groonga-command
-.. include:: ../example/reference/scorer/usage_default_and_custom_scorers.log
-.. select Memos \
-..   --match_columns &quot;title || scorer_tf_at_most(content, 2.0)&quot; \
-..   --query &quot;Groonga&quot; \
-..   --output_columns &quot;title, content, _score&quot; \
-..   --sortby &quot;-_score&quot;
+<p>この <code class="docutils literal"><span class="pre">--match_columns</span></code> は <code class="docutils literal"><span class="pre">scorer_tf_idf(title)</span></code> と <code class="docutils literal"><span class="pre">scorer_tf_at_most(content,</span> <span class="pre">2.0)</span></code> を使っています。 <code class="docutils literal"><span class="pre">_score</span></code> の値はこれら2つの値の合計になります。</p>
+<p>同じ <code class="docutils literal"><span class="pre">--match_columns</span></code> の中でデフォルトのスコアラーとカスタムスコアラーを使うことができます。単にマッチ対象のカラムを指定するとデフォルトのスコアラーを使います。</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Memos \
+  --match_columns &quot;title || scorer_tf_at_most(content, 2.0)&quot; \
+  --query &quot;Groonga&quot; \
+  --output_columns &quot;title, content, _score&quot; \
+  --sortby &quot;-_score&quot;
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         2
+#       ],
+#       [
+#         [
+#           &quot;title&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;content&quot;,
+#           &quot;Text&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;Groonga is fast&quot;,
+#         &quot;Groonga! Groonga! Groonga! Groonga is very fast!&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Groonga is easy&quot;,
+#         &quot;Groonga is very easy full text search engine!&quot;,
+#         2
+#       ]
+#     ]
+#   ]
+# ]
 </pre></div>
 </div>
-<p>The <code class="docutils literal"><span class="pre">--match_columns</span></code> uses the default scorer (TF) for <code class="docutils literal"><span class="pre">title</span></code> and
-<a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> for
-<code class="docutils literal"><span class="pre">content</span></code>. <code class="docutils literal"><span class="pre">_score</span></code> value is sum of them.</p>
+<p>この <code class="docutils literal"><span class="pre">--match_columns</span></code> は <code class="docutils literal"><span class="pre">title</span></code> にはデフォルトのスコアラー（TF）を使い、 <code class="docutils literal"><span class="pre">content</span></code> には <a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> を使います。 <code class="docutils literal"><span class="pre">_score</span></code> の値はこれらのスコアラーの結果の合計になります。</p>
 </div>
 <div class="section" id="built-in-scorers">
 <h2>7.11.3. 組み込みスコアラー<a class="headerlink" href="#built-in-scorers" title="このヘッドラインへのパーマリンク">¶</a></h2>
@@ -391,7 +425,7 @@ a match column:</p>
         <div class="sphinxsidebarwrapper">
   <h3><a href="../index.html">目次</a></h3>
   <ul>
-<li><a class="reference internal" href="#">7.11. Scorer</a><ul>
+<li><a class="reference internal" href="#">7.11. スコアラー</a><ul>
 <li><a class="reference internal" href="#summary">7.11.1. 概要</a></li>
 <li><a class="reference internal" href="#usage">7.11.2. 使い方</a></li>
 <li><a class="reference internal" href="#built-in-scorers">7.11.3. 組み込みスコアラー</a></li>
@@ -441,7 +475,7 @@ a match column:</p>
         <li class="right" >
           <a href="query_expanders/tsv.html" title="7.10.1. QueryExpanderTSV"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>