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/tutorial02.html ADDED Viewed

@@ -0,0 +1,214 @@
+<!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.2. ネットワークを通じた利用 &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.3. さまざまな種類をもったデータの保存" href="tutorial03.html" />
+    <link rel="prev" title="3.1. 基本的な操作" href="tutorial01.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="tutorial03.html" title="3.3. さまざまな種類をもったデータの保存"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial01.html" title="3.1. 基本的な操作"
+             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.2. ネットワークを通じた利用<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<p>groongaはネットワークを通じて利用することができます。groonga独自プロトコルもしくはHTTPのどちらかを選択してgroongaを起動することにより、groongaはネットワーク接続を待ち受けます。</p>
+<div class="section" id="groonga">
+<h2>3.2.1. groonga専用プロトコルによる通信<a class="headerlink" href="#groonga" title="Permalink to this headline">¶</a></h2>
+<div class="section" id="id2">
+<h3>3.2.1.1. groongaデーモンの起動<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
+<p>書式</p>
+<div class="highlight-none"><div class="highlight"><pre>groonga [-p ポート番号] -d DBパス名
+</pre></div>
+</div>
+<p>既存のデータベースのフルパス名をDBパス名に指定します。
+groongaがデーモンモードで起動し、指定したポート番号でgroongaの専用プロトコルを用いた通信をすることができます。
+(ポート番号を省略した場合は10041が使用されます)</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>% groonga -d /var/tmp/hoge.db
+12345
+%
+</pre></div>
+</div>
+<p>デーモンモードで起動後、プロセス番号が表示されます。</p>
+</div>
+<div class="section" id="id3">
+<h3>3.2.1.2. groongaサーバへの接続<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
+<p>書式</p>
+<div class="highlight-none"><div class="highlight"><pre>groonga [-p ポート番号] -c [対象ホスト名またはIPアドレス]
+</pre></div>
+</div>
+<p>対象ホストで動作しているgroongaサーバに接続します。</p>
+<p>対象ホスト名を省略した場合はlocalhostに対して接続し、対象ポート番号を省略した場合は10041ポートに対して接続します。</p>
+<p>接続に成功すると対話モードに入り、標準入力からコマンドを読み込んで順次実行します。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>% groonga -c
+&gt; status
+[[0,1280378896.10941,1.8e-05],{&quot;alloc_count&quot;:463,&quot;starttime&quot;:1280378807,&quot;uptime&quot;:89,&quot;version&quot;:&quot;0.7.2-5-g2a77275&quot;}]
+&gt; ctrl-d
+%
+</pre></div>
+</div>
+</div>
+<div class="section" id="id4">
+<h3>3.2.1.3. groongaデーモンの終了<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
+<p>groongaデーモンにshutdownコマンドを発行することにより、終了させることができます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>% groonga -c
+&gt; shutdown
+%
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="http">
+<h2>3.2.2. HTTPによる通信<a class="headerlink" href="#http" title="Permalink to this headline">¶</a></h2>
+<p>groongaをHTTP経由で利用したい場合には、HTTPプロトコルモードで起動します。</p>
+<p>書式</p>
+<div class="highlight-none"><div class="highlight"><pre>groonga [-p ポート番号] -d --protocol http DBパス名
+</pre></div>
+</div>
+<p>protocolオプションで、groongaが受け付けるプロトコルを指定できます。httpを指定すると、groongaはHTTPプロトコルでの通信を受け付けます。</p>
+<div class="section" id="html">
+<h3>3.2.2.1. HTML管理ツール<a class="headerlink" href="#html" title="Permalink to this headline">¶</a></h3>
+<p>コマンド実行後、http://[IPアドレスまたはホスト名]:[ポート番号]/ というURLにブラウザからアクセスすると、HTML管理ツールが表示されます。ブラウザは、JavaScriptの実行が有効になっている必要があります。</p>
+</div>
+<div class="section" id="id5">
+<h3>3.2.2.2. HTTPでのコマンド実行<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
+<p>groongaがHTTPプロトコルモードで起動されているとき、「/d/コマンド名」というURLにアクセスすると、コマンドを実行することが出来ます。</p>
+<p>コマンドのオプションは、HTTPのGETパラメータで渡します。つまり、「?オプション=値&amp;オプション=値 …」という書式になります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>http://[IPまたはホスト名]:[ポート番号]/d/status
+実行される処理：
+&gt; status
+[[0,1280378896.31131,1.4e-05],{&quot;alloc_count&quot;:463,&quot;starttime&quot;:1280378807,&quot;uptime&quot;:89,&quot;version&quot;:&quot;0.7.2-5-g2a77275&quot;}]
+http://[IPまたはホスト名]:[ポート番号]/d/select?table=Site&amp;query=title:@this
+実行される処理：
+&gt; select --table Site --query title:@this
+[[0,1280378896.51281,6.0e-05],[[[1],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;]],[1,&quot;http://example.org/&quot;,&quot;This is test record 1!&quot;]]]]
+</pre></div>
+</div>
+</div>
+</div>
+<div class="section" id="id6">
+<h2>3.2.3. セキュリティ<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
+<p>groongaのネットワークサービスにはは認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いて、アクセス元IPアドレスを制限することを薦めます。</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.2. ネットワークを通じた利用</a><ul>
+<li><a class="reference internal" href="#groonga">3.2.1. groonga専用プロトコルによる通信</a><ul>
+<li><a class="reference internal" href="#id2">3.2.1.1. groongaデーモンの起動</a></li>
+<li><a class="reference internal" href="#id3">3.2.1.2. groongaサーバへの接続</a></li>
+<li><a class="reference internal" href="#id4">3.2.1.3. groongaデーモンの終了</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#http">3.2.2. HTTPによる通信</a><ul>
+<li><a class="reference internal" href="#html">3.2.2.1. HTML管理ツール</a></li>
+<li><a class="reference internal" href="#id5">3.2.2.2. HTTPでのコマンド実行</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#id6">3.2.3. セキュリティ</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial01.html"
+                        title="previous chapter">3.1. 基本的な操作</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="tutorial03.html"
+                        title="next chapter">3.3. さまざまな種類をもったデータの保存</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/tutorial/tutorial02.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="tutorial03.html" title="3.3. さまざまな種類をもったデータの保存"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial01.html" title="3.1. 基本的な操作"
+             >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/tutorial03.html ADDED Viewed

@@ -0,0 +1,183 @@
+<!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.3. さまざまな種類をもったデータの保存 &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.4. さまざまな検索条件の指定" href="tutorial04.html" />
+    <link rel="prev" title="3.2. ネットワークを通じた利用" href="tutorial02.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="tutorial04.html" title="3.4. さまざまな検索条件の指定"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial02.html" title="3.2. ネットワークを通じた利用"
+             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.3. さまざまな種類をもったデータの保存<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<p>groongaでは、さまざまなデータを格納させることが出来ます。</p>
+<div class="section" id="id2">
+<h2>3.3.1. データ型<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
+<p>groongaでは、数値（整数・小数）や文字列や時刻や経緯度などの情報を格納することができます。</p>
+<p>ここでは、Int32型のカラムに整数を格納、Float型のカラムに浮動小数点の小数を、ShortText型のカラムに文字列を、Time型のカラムに時間を格納する例を示します。経緯度の格納については、のちのチュートリアルで触れます。</p>
+<p>その他のデータ型の一覧は、 <a class="reference internal" href="../type.html"><em>データ型</em></a> を参照してください。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; table_create --name Type --flags TABLE_HASH_KEY --key_type ShortText
+[[0,1280378823.87922,0.063618],true]
+&gt; column_create --table Type --name number --type Int32
+[[0,1280378824.14361,0.066276],true]
+&gt; column_create --table Type --name float --type Float
+[[0,1280378824.41063,0.0673],true]
+&gt; column_create --table Type --name string --type ShortText
+[[0,1280378824.67863,0.067213],true]
+&gt; column_create --table Type --name time --type Time
+[[0,1280378824.94662,0.05711],true]
+&gt; load --table Type
+&gt; [{&quot;_key&quot;:&quot;sample&quot;,&quot;number&quot;:12345,&quot;float&quot;:42.195,&quot;string&quot;:&quot;GROONGA&quot;,&quot;time&quot;:1234567890.12}]
+[[0,1280378825.20443,0.201835],1]
+&gt; select --table Type
+[[0,1280378825.60691,0.000155],[[[1],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;time&quot;,&quot;Time&quot;],[&quot;string&quot;,&quot;ShortText&quot;],[&quot;number&quot;,&quot;Int32&quot;],[&quot;float&quot;,&quot;Float&quot;]],[1,&quot;sample&quot;,1234567890.0,&quot;GROONGA&quot;,12345,42.195]]]]
+</pre></div>
+</div>
+</div>
+<div class="section" id="id3">
+<h2>3.3.2. テーブル型<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
+<p>table_createで作成したテーブルを、カラムの型として使うことが出来ます。</p>
+<p>また、output_columnsにおいて「.」を区切りとして、参照先のテーブルに存在するカラムを指定すると、指定したカラムの値を表示することができます。</p>
+<p>ここでは、先のチュートリアルで作成したSiteテーブルに手を加え、どのサイトをリンクしているのかを保存してみましょう。</p>
+<p>他のテーブルを参照するカラムにデータを入力する場合には、参照先のテーブルの_keyカラムの値を代入する必要があります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; column_create --table Site --name link --type Site
+[[0,1280378825.80958,0.094424],true]
+&gt; load --table Site
+&gt; [{&quot;_key&quot;:&quot;http://example.org/&quot;,&quot;link&quot;:&quot;http://example.net/&quot;}]
+[[0,1280378826.10477,0.200507],1]
+&gt; select --table Site --output_columns _key,title,link._key,link.title --query title:@this
+[[0,1280378826.50595,0.000522],[[[1],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;link._key&quot;,&quot;ShortText&quot;],[&quot;link.title&quot;,&quot;ShortText&quot;]],[&quot;http://example.org/&quot;,&quot;This is test record 1!&quot;,&quot;http://example.net/&quot;,&quot;test record 2.&quot;]]]]
+</pre></div>
+</div>
+<p>このように、linkカラムに他のサイトへの参照を保存することができました。また、参照先の_keyとtitleカラムの内容を表示することができました。</p>
+</div>
+<div class="section" id="id4">
+<h2>3.3.3. ベクターカラム<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
+<p>column_createコマンドでカラムを作成するとき、&#8211;flagsオプションでCOLUMN_VECTORフラグを指定すると、複数の値を配列で格納できるカラムが作成されます。</p>
+<p>テーブル型で配列を格納するカラムは、1対多の参照関係を表すのに有効です。</p>
+<p>テーブル型のチュートリアルでは、Siteテーブルに手を加え、どのサイトをリンクしているのかを保存しました。しかし、通常は1つのサイトから多くのサイトにリンクが張られています。複数のリンク情報を格納するために、複数の参照関係を保存するカラムを作成してみましょう。</p>
+<p>他のテーブルを参照するベクターカラムにデータを入力する場合には、参照先のテーブルの_keyカラムの値の「配列」を代入する必要があります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; column_create --table Site --name links --flags COLUMN_VECTOR --type Site
+[[0,1280378826.70921,0.087662],true]
+&gt; load --table Site
+&gt; [{&quot;_key&quot;:&quot;http://example.org/&quot;,&quot;links&quot;:[&quot;http://example.net/&quot;,&quot;http://example.org/&quot;,&quot;http://example.com/&quot;]}]
+[[0,1280378826.99769,0.200643],1]
+&gt; select --table Site --output_columns _key,title,links._key,links.title --query title:@this
+[[0,1280378827.39899,0.000499],[[[1],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;title&quot;,&quot;ShortText&quot;],[&quot;links._key&quot;,&quot;ShortText&quot;],[&quot;links.title&quot;,&quot;ShortText&quot;]],[&quot;http://example.org/&quot;,&quot;This is test record 1!&quot;,[&quot;http://example.net/&quot;,&quot;http://example.org/&quot;,&quot;http://example.com/&quot;],[&quot;test record 2.&quot;,&quot;This is test record 1!&quot;,&quot;test test record three.&quot;]]]]]
+</pre></div>
+</div>
+<p>このように、複数の参照関係が保存できました。また、output_columnsによって、複数の参照先のカラム値も表示させることができました。</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.3. さまざまな種類をもったデータの保存</a><ul>
+<li><a class="reference internal" href="#id2">3.3.1. データ型</a></li>
+<li><a class="reference internal" href="#id3">3.3.2. テーブル型</a></li>
+<li><a class="reference internal" href="#id4">3.3.3. ベクターカラム</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial02.html"
+                        title="previous chapter">3.2. ネットワークを通じた利用</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="tutorial04.html"
+                        title="next chapter">3.4. さまざまな検索条件の指定</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/tutorial/tutorial03.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="tutorial04.html" title="3.4. さまざまな検索条件の指定"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial02.html" title="3.2. ネットワークを通じた利用"
+             >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/tutorial04.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.4. さまざまな検索条件の指定 &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.5. ドリルダウン" href="tutorial05.html" />
+    <link rel="prev" title="3.3. さまざまな種類をもったデータの保存" href="tutorial03.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="tutorial05.html" title="3.5. ドリルダウン"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial03.html" title="3.3. さまざまな種類をもったデータの保存"
+             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.4. さまざまな検索条件の指定<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<p>groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。</p>
+<div class="section" id="javascript">
+<h2>3.4.1. JavaScriptに似た文法での絞込・全文検索<a class="headerlink" href="#javascript" title="Permalink to this headline">¶</a></h2>
+<p>selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --filter &quot;_id &lt;= 1&quot; --output_columns _id,_key
+[[0,1280378885.95759,0.000306],[[[1],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;]],[1,&quot;http://example.org/&quot;]]]]
+</pre></div>
+</div>
+<p>ここで、filterパラメータには</p>
+<blockquote>
+_id &lt;= 1</blockquote>
+<p>という条件を指定しています。この場合は_idの値が1以下のレコードが検索結果として得られます。</p>
+<p>また、&amp;&amp; や || を使って、条件のAND・OR指定をすることもできます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --filter &quot;_id &gt;= 4 &amp;&amp; _id &lt;= 6&quot; --output_columns _id,_key
+[[0,1280378886.15944,0.000311],[[[3],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;]],[4,&quot;http://example.net/afr&quot;],[5,&quot;http://example.org/aba&quot;],[6,&quot;http://example.com/rab&quot;]]]]
+&gt; select --table Site --filter &quot;_id &lt;= 2 || _id &gt;= 7&quot; --output_columns _id,_key
+[[0,1280378886.36174,0.000321],[[[5],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;]],[1,&quot;http://example.org/&quot;],[2,&quot;http://example.net/&quot;],[7,&quot;http://example.net/atv&quot;],[8,&quot;http://example.org/gat&quot;],[9,&quot;http://example.com/vdw&quot;]]]]
+</pre></div>
+</div>
+<p>queryパラメータとfilterパラメータを同時に指定すると、両者の条件をともに満たすレコードが結果として返ります。</p>
+</div>
+<div class="section" id="scorer">
+<h2>3.4.2. scorerを利用したソート<a class="headerlink" href="#scorer" title="Permalink to this headline">¶</a></h2>
+<p>selectコマンドのscorerパラメータは、
+全文検索を行った結果の各レコードに対して処理を行うためのパラメータです。</p>
+<p>filterパラメータと同様に、
+JavaScriptの式に似たな文法で様々な条件を指定することができます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --filter &quot;1&quot; --scorer &quot;_score = rand()&quot; --output_columns _id,_key,_score --sortby _score
+[[0,1280378886.56471,0.000504],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[3,&quot;http://example.com/&quot;,35005211],[9,&quot;http://example.com/vdw&quot;,278722862],[5,&quot;http://example.org/aba&quot;,294702567],[1,&quot;http://example.org/&quot;,304089172],[7,&quot;http://example.net/atv&quot;,336465782],[4,&quot;http://example.net/afr&quot;,521595368],[8,&quot;http://example.org/gat&quot;,861021530],[2,&quot;http://example.net/&quot;,1303455736],[6,&quot;http://example.com/rab&quot;,1726956429]]]]
+&gt; select --table Site --filter &quot;1&quot; --scorer &quot;_score = rand()&quot; --output_columns _id,_key,_score --sortby _score
+[[0,1280378886.76988,0.00049],[[[9],[[&quot;_id&quot;,&quot;UInt32&quot;],[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[1,&quot;http://example.org/&quot;,233665123],[3,&quot;http://example.com/&quot;,468703135],[7,&quot;http://example.net/atv&quot;,635723058],[4,&quot;http://example.net/afr&quot;,1101513929],[9,&quot;http://example.com/vdw&quot;,1125898167],[6,&quot;http://example.com/rab&quot;,1315634022],[8,&quot;http://example.org/gat&quot;,1369133069],[5,&quot;http://example.org/aba&quot;,1801979802],[2,&quot;http://example.net/&quot;,2145174067]]]]
+</pre></div>
+</div>
+<p>検索結果には、&#8217;_score&#8217;という名前の、全文検索のスコアが代入されている仮想的なカラムが付与されることをチュートリアル中ソートの項目で説明しました。</p>
+<p>上記の実行例では、scorerパラメータに</p>
+<blockquote>
+_score = rand()</blockquote>
+<p>という条件を指定しています。ここでは、rand()という乱数を返す関数を用いて、全文検索のスコアを乱数で上書きしています。</p>
+<p>sortbyパラメータには、</p>
+<blockquote>
+_score</blockquote>
+<p>を指定しています。これは、スコア順に昇順にソートすることを意味しています。</p>
+<p>よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。</p>
+</div>
+<div class="section" id="id2">
+<h2>3.4.3. 位置情報を用いた絞込・ソート<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
+<p>groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。</p>
+<p>位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。</p>
+<p>経緯度をデータを入力するためには、&#8221;緯度のミリ秒x経度のミリ秒&#8221;という形式の文字列を代入する必要があります。</p>
+<p>ここでは、ためしに東京駅と新宿駅とついて、世界測地系での位置情報を保存してみましょう。東京駅は緯度が35度40分52.975秒、経度が139度45分57.902秒です。新宿駅は緯度が35度41分27.316秒、経度が139度42分0.929秒です。よって、代入する文字列はそれぞれ&#8221;128452975x503157902&#8221;/&#8221;128487316x502920929&#8221;となります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; column_create --table Site --name location --type WGS84GeoPoint
+[[0,1280378886.97522,0.109348],true]
+&gt; load --table Site
+&gt; [
+&gt;  {&quot;_key&quot;:&quot;http://example.org/&quot;,&quot;location&quot;:&quot;128452975x503157902&quot;}
+&gt;  {&quot;_key&quot;:&quot;http://example.net/&quot;,&quot;location&quot;:&quot;128487316x502920929&quot;},
+&gt; ]
+[[0,1280378887.28534,0.801067],2]
+&gt; select --table Site --query &quot;_id:1 OR _id:2&quot; --output_columns _key,location
+[[0,1280378888.28703,0.000371],[[[2],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;]],[&quot;http://example.org/&quot;,&quot;128452975x503157902&quot;],[&quot;http://example.net/&quot;,&quot;128487316x502920929&quot;]]]]
+</pre></div>
+</div>
+<p>scorerパラメータにおいて、 <a class="reference internal" href="../functions/geo_distance.html"><em>geo_distance</em></a> 関数を用いることにより、２点間の距離を計算することができます。</p>
+<p>ここでは、秋葉原駅からの距離を表示させてみましょう。世界測地系では、秋葉原駅の位置は緯度が35度41分55.259秒、経度が139度46分27.188秒です。よって、geo_distance関数に与える文字列は&#8221;128515259x503187188&#8221;となります。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --query &quot;_id:1 OR _id:2&quot; --output_columns _key,location,_score --scorer &#39;_score = geo_distance(location, &quot;128515259x503187188&quot;)&#39;
+[[0,1280378888.48983,0.000429],[[[2],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[&quot;http://example.org/&quot;,&quot;128452975x503157902&quot;,2054],[&quot;http://example.net/&quot;,&quot;128487316x502920929&quot;,6720]]]]
+</pre></div>
+</div>
+<p>この結果を見ると、東京駅と秋葉原駅は2054m、秋葉原駅と新宿駅は6720m離れているようです。</p>
+<p>geo_distance関数は、_scoreを通じてソートでも用いることができます。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --query &quot;_id:1 OR _id:2&quot; --output_columns _key,location,_score --scorer &#39;_score = geo_distance(location, &quot;128515259x503187188&quot;)&#39; --sortby -_score
+[[0,1280378888.69281,0.000524],[[[2],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[&quot;http://example.net/&quot;,&quot;128487316x502920929&quot;,6720],[&quot;http://example.org/&quot;,&quot;128452975x503157902&quot;,2054]]]]
+</pre></div>
+</div>
+<p>「ある地点から何m以内に存在する」といった絞込も可能です。</p>
+<p>filterパラメータにおいて、 <a class="reference internal" href="../functions/geo_in_circle.html"><em>geo_in_circle</em></a> 関数を用いることにより、２点間の距離が指定のm以下におさまるかどうかを判定することができます。</p>
+<p>たとえば、秋葉原駅から5000m以内にあるレコードを検索してみましょう。</p>
+<p>実行例</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; select --table Site --output_columns _key,location --filter &#39;geo_in_circle(location, &quot;128515259x503187188&quot;, 5000)&#39;
+[[0,1280378888.89597,0.000335],[[[1],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;location&quot;,&quot;WGS84GeoPoint&quot;]],[&quot;http://example.org/&quot;,&quot;128452975x503157902&quot;]]]]
+</pre></div>
+</div>
+<p>また、経緯度が指定の矩形領域内であるかどうかを判定する <a class="reference internal" href="../functions/geo_in_rectangle.html"><em>geo_in_rectangle</em></a> 関数も存在します。</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.4. さまざまな検索条件の指定</a><ul>
+<li><a class="reference internal" href="#javascript">3.4.1. JavaScriptに似た文法での絞込・全文検索</a></li>
+<li><a class="reference internal" href="#scorer">3.4.2. scorerを利用したソート</a></li>
+<li><a class="reference internal" href="#id2">3.4.3. 位置情報を用いた絞込・ソート</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial03.html"
+                        title="previous chapter">3.3. さまざまな種類をもったデータの保存</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="tutorial05.html"
+                        title="next chapter">3.5. ドリルダウン</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/tutorial/tutorial04.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="tutorial05.html" title="3.5. ドリルダウン"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial03.html" title="3.3. さまざまな種類をもったデータの保存"
+             >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>