<!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ドキュメント</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>
<script type="text/javascript" src="../../_static/translations.js"></script>
<link rel="shortcut icon" href="../../_static/favicon.ico"/>
<link rel="top" title="groonga v3.0.5ドキュメント" 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">オープンソースのカラムストア機能付き全文検索エンジン</span>
</a>
</h1>
<div class="other-language-links">
<ul>
<li><a href="../../../../en/html/reference/commands_not_implemented/set.html"><img src="../../_static/us.png" alt="English">English page</a></li>
</ul>
</div>
</div>
<div class="related">
<h3>ナビゲーション</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="総合索引"
accesskey="I">索引</a></li>
<li><a href="../../index.html">groonga v3.0.5ドキュメント</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="このヘッドラインへのパーマリンク">¶</a></h1>
<div class="section" id="id1">
<h2>名前<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h2>
<p>set - 一件のレコードの値の更新</p>
</div>
<div class="section" id="id2">
<h2>書式<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</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="このヘッドラインへのパーマリンク">¶</a></h2>
<p>groonga組込コマンドの一つであるsetについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。</p>
<p>setは、使用しているデータベースのテーブルの中の１件のレコードについて、カラムの値を更新し、更新したカラムの値を返却します。</p>
</div>
<div class="section" id="id4">
<h2>引数<a class="headerlink" href="#id4" title="このヘッドラインへのパーマリンク">¶</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="このヘッドラインへのパーマリンク">¶</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="このヘッドラインへのパーマリンク">¶</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">目次</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>このページ</h3>
<ul class="this-page-menu">
<li><a href="../../_sources/reference/commands_not_implemented/set.txt"
rel="nofollow">ソースコードを表示</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>クイック検索</h3>
<form class="search" action="../../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="検索" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
モジュール、クラス、または関数名を入力してください
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>ナビゲーション</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="総合索引"
>索引</a></li>
<li><a href="../../index.html">groonga v3.0.5ドキュメント</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2013, Brazil, Inc.
</div>
</body>
</html>
distrib
>
Fedora
>
18
>
x86_64
>
media
>
updates
>
by-pkgid
>
e450e7f3d6075c4a54de19e68d38177f
>
files
>
623
