<!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>set — groonga v3.0.5 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: '3.0.5', 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 v3.0.5 documentation" href="../../index.html" /> </head> <body> <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/commands_not_implemented/set.html"><img src="../../_static/jp.png" alt="日本語">日本語版はこちら</a></li> </ul> </div> </div> <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><a href="../../index.html">groonga v3.0.5 documentation</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <div class="section" id="set"> <h1>set<a class="headerlink" href="#set" title="Permalink to this headline">¶</a></h1> <div class="section" id="id1"> <h2>名前<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2> <p>set - 一件のレコードの値の更新</p> </div> <div class="section" id="id2"> <h2>書式<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2> <div class="highlight-none"><div class="highlight"><pre>set table [key [columns [values [output_columns [id]]]]] </pre></div> </div> </div> <div class="section" id="id3"> <h2>説明<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2> <p>groonga組込コマンドの一つであるsetについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。</p> <p>setは、使用しているデータベースのテーブルの中の1件のレコードについて、カラムの値を更新し、更新したカラムの値を返却します。</p> </div> <div class="section" id="id4"> <h2>引数<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2> <p><tt class="docutils literal"><span class="pre">table</span></tt></p> <blockquote> <div>値を更新しようとするレコードを含むテーブルの名前を指定します。</div></blockquote> <p><tt class="docutils literal"><span class="pre">key</span></tt></p> <blockquote> <div>値を変更するレコードの主キー値を指定します。主キーなしのテーブルの場合はこのパラメータを指定しても無視されます(idパラメータを代わりに指定します)。</div></blockquote> <p><tt class="docutils literal"><span class="pre">columns</span></tt></p> <blockquote> <div>テーブルに登録するレコードに値を設定するカラム名のリストを指定します。</div></blockquote> <p><tt class="docutils literal"><span class="pre">values</span></tt></p> <blockquote> <div><p>登録するレコードの値を表現した文字列を渡します。</p> <p>以下のいずれかの形式が使用できます。</p> <dl class="docutils"> <dt><tt class="docutils literal"><span class="pre">形式1</span></tt></dt> <dd>[カラム値1, カラム値2,..]</dd> <dt><tt class="docutils literal"><span class="pre">形式2</span></tt></dt> <dd>{カラム名1: カラム値1, カラム名2: カラム値2}</dd> </dl> <p>形式1の[カラム名1, カラム名2,..]の要素はcolumns引数が省略された場合のみ有効です。</p> </div></blockquote> <p><tt class="docutils literal"><span class="pre">output_columns</span></tt></p> <blockquote> <div>出力するカラム名のリストをカンマ(',')区切りで指定します。</div></blockquote> <p><tt class="docutils literal"><span class="pre">id</span></tt></p> <blockquote> <div>レコードIDによってレコードを指定します。idパラメータを指定する場合は、keyパラメータを指定してはいけません。</div></blockquote> <p>返値 ---</p> <p>以下のようなjson形式で値が返却されます。</p> <div class="highlight-none"><div class="highlight"><pre>[[リターンコード, 処理開始時間, 処理時間], [新規追加, [カラム値1, ...]]] </pre></div> </div> <p><tt class="docutils literal"><span class="pre">リターンコード</span></tt></p> <blockquote> <div>grn_rcに対応する数値が返されます。0(GRN_SUCCESS)以外の場合は、続いてエラー内容を示す 文字列が返されます。</div></blockquote> <p><tt class="docutils literal"><span class="pre">処理開始時間</span></tt></p> <blockquote> <div>処理を開始した時間について、1970年1月1日0時0分0秒を起点とした秒数を小数で返します。</div></blockquote> <p><tt class="docutils literal"><span class="pre">処理時間</span></tt></p> <blockquote> <div>処理にかかった秒数を返します。</div></blockquote> <p><tt class="docutils literal"><span class="pre">新規追加</span></tt></p> <blockquote> <div>レコードが追加されたかどうかを判定する。</div></blockquote> <p><tt class="docutils literal"><span class="pre">カラム値n</span></tt></p> <blockquote> <div>output_columnsで指定されたカラムの値。</div></blockquote> </div> <div class="section" id="id5"> <h2>例<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2> <p>テーブルEntryにレコードを登録します。:</p> <div class="highlight-none"><div class="highlight"><pre>set Entry abandon body 放棄する [[0,1268208665.67547,0.045],[]] </pre></div> </div> </div> <div class="section" id="id6"> <h2>関連項目<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2> <p><tt class="xref doc docutils literal"><span class="pre">load</span></tt></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="#">set</a><ul> <li><a class="reference internal" href="#id1">名前</a></li> <li><a class="reference internal" href="#id2">書式</a></li> <li><a class="reference internal" href="#id3">説明</a></li> <li><a class="reference internal" href="#id4">引数</a></li> <li><a class="reference internal" href="#id5">例</a></li> <li><a class="reference internal" href="#id6">関連項目</a></li> </ul> </li> </ul> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../../_sources/reference/commands_not_implemented/set.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" /> <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><a href="../../index.html">groonga v3.0.5 documentation</a> »</li> </ul> </div> <div class="footer"> © Copyright 2009-2013, Brazil, Inc. </div> </body> </html>