RubyGems - rroonga - Versions diffs - 7.1.1-x86-mingw32 → 9.0.2-x86-mingw32 - Mend

rroonga 7.1.1-x86-mingw32 → 9.0.2-x86-mingw32

Files changed (980) hide show

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

@@ -1,35 +1,27 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html>
 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja">
   <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.3.24. load &#8212; Groonga v7.1.0-73-g6d02cfaドキュメント</title>
+    <meta charset="utf-8" />
+    <title>7.3.24. load &#8212; Groonga v9.0.2ドキュメント</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:     '7.1.0-73-g6d02cfa',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  false,
-        SOURCELINK_SUFFIX: '.txt'
-      };
-    </script>
+    <script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></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/language_data.js"></script>
     <script type="text/javascript" src="../../_static/translations.js"></script>
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
     <link rel="index" title="索引" href="../../genindex.html" />
     <link rel="search" title="検索" href="../../search.html" />
     <link rel="next" title="7.3.25. lock_acquire" href="lock_acquire.html" />
     <link rel="prev" title="7.3.23. io_flush" href="io_flush.html" />
-  </head>
-  <body>
+  </head><body>
 <div class="header">
   <h1 class="title">
     <a id="top-link" href="../../index.html">
@@ -59,7 +51,7 @@
         <li class="right" >
           <a href="io_flush.html" title="7.3.23. io_flush"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v7.1.0-73-g6d02cfaドキュメント</a> &#187;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v9.0.2ドキュメント</a> &#187;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. コマンド</a> &#187;</li>
       </ul>
@@ -71,81 +63,207 @@
           <div class="body" role="main">
   <div class="section" id="load">
-<h1>7.3.24. <code class="docutils literal"><span class="pre">load</span></code><a class="headerlink" href="#load" title="このヘッドラインへのパーマリンク">¶</a></h1>
+<h1>7.3.24. <code class="docutils literal notranslate"><span class="pre">load</span></code><a class="headerlink" href="#load" title="このヘッドラインへのパーマリンク">¶</a></h1>
 <div class="section" id="summary">
 <h2>7.3.24.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><code class="docutils literal"><span class="pre">load</span></code> は、使用しているデータベースのテーブルにレコードを登録し、カラムの値を更新します。</p>
+<p><code class="docutils literal notranslate"><span class="pre">load</span></code> は、使用しているデータベースのテーブルにレコードを登録し、カラムの値を更新します。</p>
 </div>
 <div class="section" id="syntax">
 <h2>7.3.24.2. 構文<a class="headerlink" href="#syntax" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<div class="highlight-none"><div class="highlight"><pre><span></span>load values table [columns [ifexists [input_type]]]
+<p>必須の引数は <code class="docutils literal notranslate"><span class="pre">values</span></code> と <code class="docutils literal notranslate"><span class="pre">table</span></code> だけです。残りは省略できます。:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>load values
+     table
+     [columns=null]
+     [ifexists=null]
+     [input_type=json]
+     [each=null]
+     [output_ids=no]
+     [output_errors=no]
+     [lock_table=no]
 </pre></div>
 </div>
+<p>このコマンドは特別なコマンドです。他のコマンドはすべてのパラメーターを1行で指定する必要がありますが、このコマンドは <code class="docutils literal notranslate"><span class="pre">values</span></code> の値を別途指定することもできます。</p>
+<p>コマンドラインスタイルを使っている場合は次のように <code class="docutils literal notranslate"><span class="pre">values</span></code> の値を指定できます。:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>load --table Bookmarks
+[
+{&quot;_key&quot;: &quot;http://groonga.org/&quot;, &quot;title&quot;: &quot;Groonga&quot;},
+{&quot;_key&quot;: &quot;http://mroonga.org/&quot;, &quot;title&quot;: &quot;Mroonga&quot;}
+]
+</pre></div>
+</div>
+<p><code class="docutils literal notranslate"><span class="pre">[...]</span></code> は <code class="docutils literal notranslate"><span class="pre">values</span></code> の値です。</p>
+<p>HTTPスタイルを使っている場合はボディに <code class="docutils literal notranslate"><span class="pre">values</span></code> を指定できます。</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>% curl \
+    --request POST \
+    --header &quot;Content-Type: application/json&quot; \
+    --data-raw &#39;[{&quot;_key&quot;: &quot;http://groonga.org/&quot;}]&#39; \
+    http://localhost:10041/d/load?table=Bookmarks&quot;
+</pre></div>
 </div>
-<div class="section" id="parameters">
-<h2>7.3.24.3. 引数<a class="headerlink" href="#parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>このセクションではすべての引数について説明します。</p>
-<p><code class="docutils literal"><span class="pre">values</span></code></p>
-<blockquote>
-<div><p>input_typeに指定する形式で登録するレコードの値を表現した文字列を渡します。
-input_typeがjsonである場合には、以下のいずれかの形式が使用できます。</p>
-<dl class="docutils">
-<dt><code class="docutils literal"><span class="pre">Format</span> <span class="pre">1:</span></code></dt>
-<dd>[[カラム名1, カラム名2,..], [カラム値1, カラム値2,..], [カラム値1, カラム値2,..],..]</dd>
-<dt><code class="docutils literal"><span class="pre">Format</span> <span class="pre">2:</span></code></dt>
-<dd>[{カラム名1: カラム値1, カラム名2: カラム値2}, {カラム名1: カラム値1, カラム名2: カラム値2},..]</dd>
-</dl>
-<p>形式1の[カラム名1, カラム名2,..]の要素は <code class="docutils literal"><span class="pre">columns</span></code> 引数が省略された場合のみ有効です。</p>
-<p>対象のテーブルが主キーを持つテーブルであった場合は、カラム名の中に <code class="docutils literal"><span class="pre">_key</span></code> (主キーを示す疑似カラム名)が含まれていなければなりません。</p>
-<p><code class="docutils literal"><span class="pre">values</span></code> 引数が省略された場合には、括弧の対応が取れるまで標準入力から <code class="docutils literal"><span class="pre">values</span></code> の値を読み取ります。引数として値を指定する場合は、文字列のエスケープが必要ですが、標準入力から与える文字列はエスケープする必要がありません。</p>
-<p>続きの文字列については、空白文字(' ')をエスケープする必要はありません。</p>
-</div></blockquote>
-<p><code class="docutils literal"><span class="pre">table</span></code></p>
-<blockquote>
-<div>レコードを追加しようとするテーブルの名前を指定します。</div></blockquote>
-<p><code class="docutils literal"><span class="pre">columns</span></code></p>
-<blockquote>
-<div>テーブルに登録するレコードに値を設定するカラム名のリストを、カンマ区切りで指定します。</div></blockquote>
-<p><code class="docutils literal"><span class="pre">ifexists</span></code></p>
-<blockquote>
-<div>指定した主キーに対応するレコードが既にテーブルに登録済みであった場合に実行するscript形式の <code class="docutils literal"><span class="pre">grn_expr</span></code> 文字列を指定します。 <code class="docutils literal"><span class="pre">ifexists</span></code> に <code class="docutils literal"><span class="pre">grn_expr</span></code> が指定された場合は、式の値が真である場合に限り、その他のカラムの値が更新されます。(デフォルトはtrue)</div></blockquote>
-<p><code class="docutils literal"><span class="pre">input_type</span></code></p>
-<blockquote>
-<div>入力形式を指定します。JSONのみに対応しています。</div></blockquote>
 </div>
 <div class="section" id="usage">
-<h2>7.3.24.4. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>テーブルEntryにレコードを登録します。:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>load --table Entry --input_type json --values [{\&quot;_key\&quot;:\&quot;Groonga\&quot;,\&quot;body\&quot;:\&quot;It&#39;s very fast!!\&quot;}]
-[1]
+<h2>7.3.24.3. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>使い方を示すために使うスキーマ定義は以下の通りです。</p>
+<p>実行例:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>table_create Entries TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Entries content COLUMN_SCALAR Text
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 </pre></div>
 </div>
-<p>標準入力からvaluesの値を与えます。:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>load --table Entry --input_type json
+<p>パラメーター指定で <code class="docutils literal notranslate"><span class="pre">Entries</span></code> テーブルにレコードを追加する例です。</p>
+<p>実行例:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>load \
+  --table Entries \
+  --values &quot;[{\&quot;_key\&quot;:\&quot;Groonga\&quot;,\&quot;content\&quot;:\&quot;It&#39;s very fast!!\&quot;}]&quot;
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+</pre></div>
+</div>
+<p>標準入力のデータを使って <code class="docutils literal notranslate"><span class="pre">Entries</span></code> テーブルにレコードを追加する例です。</p>
+<p>実行例:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>load --table Entries
 [
-{&quot;_key&quot;: &quot;Groonga&quot;, &quot;body&quot;: &quot;It&#39;s very fast!!&quot;}
+{&quot;_key&quot;: &quot;Groonga&quot;, &quot;content&quot;: &quot;It&#39;s very fast!!&quot;}
 ]
-[1]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
 </pre></div>
 </div>
+<p>カラム更新中にテーブルをロックする例です。</p>
+<p>実行例:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>load --table Entries --lock_table yes
+[
+{&quot;_key&quot;: &quot;Groonga&quot;, &quot;content&quot;: &quot;It&#39;s very fast!!&quot;}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+</pre></div>
+</div>
+</div>
+<div class="section" id="parameters">
+<h2>7.3.24.4. 引数<a class="headerlink" href="#parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このセクションではすべての引数について説明します。引数はカテゴリわけしています。</p>
+<div class="section" id="required-parameters">
+<h3>7.3.24.4.1. 必須引数<a class="headerlink" href="#required-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>いくつか必須の引数があります。</p>
+<div class="section" id="values">
+<span id="load-values"></span><h4>7.3.24.4.1.1. <code class="docutils literal notranslate"><span class="pre">values</span></code><a class="headerlink" href="#values" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>ロードする値を指定します。</p>
+<p>ロードする値は <code class="docutils literal notranslate"><span class="pre">input_type</span></code> フォーマットになっていないといけません。 <code class="docutils literal notranslate"><span class="pre">input_type</span></code> に <code class="docutils literal notranslate"><span class="pre">json</span></code> を指定した場合は次のいずれかのフォーマットにします。</p>
+<p>角括弧スタイル:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>[
+[COLUMN_NAME1, COLUMN_NAME2, ...],
+[VALUE1, VALUE2, ...],
+[VALUE1, VALUE2, ...],
+...
+]
+</pre></div>
+</div>
+<p>波括弧スタイル:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>[
+{&quot;COLUMN_NAME1&quot;: VALUE1, &quot;COLUMN_NAME2&quot;: VALUE2, ...},
+{&quot;COLUMN_NAME1&quot;: VALUE1, &quot;COLUMN_NAME2&quot;: VALUE2, ...},
+...
+]
+</pre></div>
+</div>
+<p>角括弧スタイルの <code class="docutils literal notranslate"><span class="pre">[COLUMN_NAME1,</span> <span class="pre">COLUMN_NAME2,</span> <span class="pre">...]</span></code> は <a class="reference internal" href="#load-columns"><span class="std std-ref">columns</span></a> パラメーターを指定していないときだけ有効です。</p>
+<p>対象のテーブルが主キーを持つテーブルであった場合は、カラム名のどれかを <code class="docutils literal notranslate"><span class="pre">_key</span></code> （主キーを示す疑似カラム名）にしなければいけません。</p>
+<p><code class="docutils literal notranslate"><span class="pre">values</span></code> を指定していない場合、コマンドラインスタイルのときは標準入力から読み込んだ値を使い、HTTPスタイルのときはボディの値を使います。</p>
+</div>
+<div class="section" id="table">
+<span id="load-table"></span><h4>7.3.24.4.1.2. <code class="docutils literal notranslate"><span class="pre">table</span></code><a class="headerlink" href="#table" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>レコードを追加しようとするテーブルの名前を指定します。</p>
+</div>
+</div>
+<div class="section" id="optional-parameters">
+<h3>7.3.24.4.2. 省略可能引数<a class="headerlink" href="#optional-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>いくつか省略可能な引数があります。</p>
+<div class="section" id="columns">
+<span id="load-columns"></span><h4>7.3.24.4.2.1. <code class="docutils literal notranslate"><span class="pre">columns</span></code><a class="headerlink" href="#columns" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>テーブルに登録するレコードに値を設定するカラム名のリストを、カンマ区切りで指定します。</p>
+</div>
+<div class="section" id="ifexists">
+<span id="load-ifexists"></span><h4>7.3.24.4.2.2. <code class="docutils literal notranslate"><span class="pre">ifexists</span></code><a class="headerlink" href="#ifexists" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>追加する主キーのレコードがすでにテーブル中に存在するときに実行する式を <a class="reference internal" href="../grn_expr/script_syntax.html"><span class="doc">スクリプト構文</span></a> で指定します。</p>
+<p><code class="docutils literal notranslate"><span class="pre">ifexists</span></code> に式を指定し、その式の評価結果が <code class="docutils literal notranslate"><span class="pre">true</span></code> のときは、他のカラム（ <code class="docutils literal notranslate"><span class="pre">_key</span></code> カラム以外のすべてのカラム）の値をすべて更新します。</p>
+</div>
+<div class="section" id="input-type">
+<span id="load-input-type"></span><h4>7.3.24.4.2.3. <code class="docutils literal notranslate"><span class="pre">input_type</span></code><a class="headerlink" href="#input-type" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p><code class="docutils literal notranslate"><span class="pre">values</span></code> の入力フォーマットを指定します。現在のところ <code class="docutils literal notranslate"><span class="pre">json</span></code> のみサポートしています。つまり、 <code class="docutils literal notranslate"><span class="pre">values</span></code> のフォーマットはJSONでなければいけません。</p>
+<p>デフォルト値は <code class="docutils literal notranslate"><span class="pre">json</span></code> です。</p>
+</div>
+<div class="section" id="each">
+<span id="load-each"></span><h4>7.3.24.4.2.4. <code class="docutils literal notranslate"><span class="pre">each</span></code><a class="headerlink" href="#each" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO</p>
+</div>
+<div class="section" id="output-ids">
+<span id="load-output-ids"></span><h4>7.3.24.4.2.5. <code class="docutils literal notranslate"><span class="pre">output_ids</span></code><a class="headerlink" href="#output-ids" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO</p>
+</div>
+<div class="section" id="output-errors">
+<span id="load-output-errors"></span><h4>7.3.24.4.2.6. <code class="docutils literal notranslate"><span class="pre">output_errors</span></code><a class="headerlink" href="#output-errors" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>TODO</p>
+</div>
+<div class="section" id="lock-table">
+<span id="load-lock-table"></span><h4>7.3.24.4.2.7. <code class="docutils literal notranslate"><span class="pre">lock_table</span></code><a class="headerlink" href="#lock-table" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<div class="versionadded">
+<p><span class="versionmodified added">バージョン 8.0.6 で追加.</span></p>
+</div>
+<p>カラム更新中にテーブルをロックするかどうかを指定します。</p>
+<p>デフォルト値は <code class="docutils literal notranslate"><span class="pre">no</span></code> です。</p>
+<p>もし、 <code class="docutils literal notranslate"><span class="pre">load</span></code> や <code class="docutils literal notranslate"><span class="pre">delete</span></code> などといった破壊的な変更をするコマンドを同時に実行すると、データベースが壊れる可能性があります。たとえば、 <code class="docutils literal notranslate"><span class="pre">load</span></code> でレコードを更新中にそのレコードを <code class="docutils literal notranslate"><span class="pre">delete</span></code> で削除すると <code class="docutils literal notranslate"><span class="pre">load</span></code> は削除されたレコードを参照してしまうかもしれません。</p>
+<p>更新対象のテーブルをロックすることで更新の衝突を防ぐことができますが、書き込み性能は下がります。</p>
+<p>このパラメーターに <code class="docutils literal notranslate"><span class="pre">yes</span></code> を指定するとカラム更新中は更新対象のテーブルをロックします。それぞれのレコードの更新手順は次のようになります。</p>
+<blockquote>
+<div><ol class="arabic simple">
+<li><p>更新対象のテーブルをロックする</p></li>
+<li><p>更新対象のテーブルにレコードを追加する、あるいは、レコードを参照する</p></li>
+<li><p>更新対象のテーブルのロックを解除する</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">lock_table</span></code> が <code class="docutils literal notranslate"><span class="pre">yes</span></code> の場合は更新対象のテーブルをロックする</p></li>
+<li><p>対象レコードのカラムを更新する</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">lock_table</span></code> が <code class="docutils literal notranslate"><span class="pre">yes</span></code> の場合は更新対象のテーブルのロックを解除する</p></li>
+</ol>
+</div></blockquote>
+</div>
+</div>
 </div>
 <div class="section" id="return-value">
 <h2>7.3.24.5. 戻り値<a class="headerlink" href="#return-value" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<div class="section" id="json-format">
-<h3>7.3.24.5.1. JSON形式<a class="headerlink" href="#json-format" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<blockquote>
-<div><p>テーブルに登録されたレコードの件数が返されます。</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>[NUMBER]
+<p>このコマンドは以下のフォーマットのレスポンスを返します。:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>[THE_NUMBER_OF_LOADED_RECORDS]
 </pre></div>
 </div>
-</div></blockquote>
+<p>このコマンドは <a class="reference internal" href="../command/command_version.html"><span class="doc">コマンドバージョン</span></a> 3以降のときは以下のフォーマットのレスポンスを返します。:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>{
+  &quot;n_loaded_records&quot;: THE_NUMBER_OF_LOADED_RECORDS,
+  &quot;loaded_ids&quot;: [
+    LOADED_RECORD&#39;S_ID1,
+    LOADED_RECORD&#39;S_ID2,
+    ...
+  ],
+  &quot;errors&quot;: [
+    {
+      &quot;return_code&quot;: RETURN_CODE_FOR_1ST_RECORD,
+      &quot;message&quot;: MESSAGE_FOR_1ST_RECORD
+    },
+    {
+      &quot;return_code&quot;: RETURN_CODE_FOR_2ND_RECORD,
+      &quot;message&quot;: MESSAGE_FOR_2ND_RECORD
+    },
+    ...
+  ]
+}
+</pre></div>
 </div>
+<p><a class="reference internal" href="#load-output-ids"><span class="std std-ref">output_ids</span></a> が <code class="docutils literal notranslate"><span class="pre">yes</span></code> のときだけ <code class="docutils literal notranslate"><span class="pre">loaded_ids</span></code> を含みます。</p>
+<p><a class="reference internal" href="#load-output-errors"><span class="std std-ref">output_errors</span></a> が <code class="docutils literal notranslate"><span class="pre">yes</span></code> のときだけ <code class="docutils literal notranslate"><span class="pre">errors</span></code> を含みます。</p>
 </div>
 <div class="section" id="see-also">
 <h2>7.3.24.6. 参考<a class="headerlink" href="#see-also" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><a class="reference internal" href="../grn_expr.html"><span class="doc">grn_expr</span></a></p>
+<blockquote>
+<div><ul class="simple">
+<li><p><a class="reference internal" href="../grn_expr/script_syntax.html"><span class="doc">スクリプト構文</span></a></p></li>
+</ul>
+</div></blockquote>
 </div>
 </div>
@@ -157,15 +275,29 @@ input_typeがjsonである場合には、以下のいずれかの形式が使用
         <div class="sphinxsidebarwrapper">
   <h3><a href="../../index.html">目次</a></h3>
   <ul>
-<li><a class="reference internal" href="#">7.3.24. <code class="docutils literal"><span class="pre">load</span></code></a><ul>
+<li><a class="reference internal" href="#">7.3.24. <code class="docutils literal notranslate"><span class="pre">load</span></code></a><ul>
 <li><a class="reference internal" href="#summary">7.3.24.1. 概要</a></li>
 <li><a class="reference internal" href="#syntax">7.3.24.2. 構文</a></li>
-<li><a class="reference internal" href="#parameters">7.3.24.3. 引数</a></li>
-<li><a class="reference internal" href="#usage">7.3.24.4. 使い方</a></li>
-<li><a class="reference internal" href="#return-value">7.3.24.5. 戻り値</a><ul>
-<li><a class="reference internal" href="#json-format">7.3.24.5.1. JSON形式</a></li>
+<li><a class="reference internal" href="#usage">7.3.24.3. 使い方</a></li>
+<li><a class="reference internal" href="#parameters">7.3.24.4. 引数</a><ul>
+<li><a class="reference internal" href="#required-parameters">7.3.24.4.1. 必須引数</a><ul>
+<li><a class="reference internal" href="#values">7.3.24.4.1.1. <code class="docutils literal notranslate"><span class="pre">values</span></code></a></li>
+<li><a class="reference internal" href="#table">7.3.24.4.1.2. <code class="docutils literal notranslate"><span class="pre">table</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#optional-parameters">7.3.24.4.2. 省略可能引数</a><ul>
+<li><a class="reference internal" href="#columns">7.3.24.4.2.1. <code class="docutils literal notranslate"><span class="pre">columns</span></code></a></li>
+<li><a class="reference internal" href="#ifexists">7.3.24.4.2.2. <code class="docutils literal notranslate"><span class="pre">ifexists</span></code></a></li>
+<li><a class="reference internal" href="#input-type">7.3.24.4.2.3. <code class="docutils literal notranslate"><span class="pre">input_type</span></code></a></li>
+<li><a class="reference internal" href="#each">7.3.24.4.2.4. <code class="docutils literal notranslate"><span class="pre">each</span></code></a></li>
+<li><a class="reference internal" href="#output-ids">7.3.24.4.2.5. <code class="docutils literal notranslate"><span class="pre">output_ids</span></code></a></li>
+<li><a class="reference internal" href="#output-errors">7.3.24.4.2.6. <code class="docutils literal notranslate"><span class="pre">output_errors</span></code></a></li>
+<li><a class="reference internal" href="#lock-table">7.3.24.4.2.7. <code class="docutils literal notranslate"><span class="pre">lock_table</span></code></a></li>
 </ul>
 </li>
+</ul>
+</li>
+<li><a class="reference internal" href="#return-value">7.3.24.5. 戻り値</a></li>
 <li><a class="reference internal" href="#see-also">7.3.24.6. 参考</a></li>
 </ul>
 </li>
@@ -173,18 +305,18 @@ input_typeがjsonである場合には、以下のいずれかの形式が使用
   <h4>前のトピックへ</h4>
   <p class="topless"><a href="io_flush.html"
-                        title="前の章へ">7.3.23. <code class="docutils literal"><span class="pre">io_flush</span></code></a></p>
+                        title="前の章へ">7.3.23. <code class="docutils literal notranslate"><span class="pre">io_flush</span></code></a></p>
   <h4>次のトピックへ</h4>
   <p class="topless"><a href="lock_acquire.html"
-                        title="次の章へ">7.3.25. <code class="docutils literal"><span class="pre">lock_acquire</span></code></a></p>
+                        title="次の章へ">7.3.25. <code class="docutils literal notranslate"><span class="pre">lock_acquire</span></code></a></p>
 <div id="searchbox" style="display: none" role="search">
   <h3>クイック検索</h3>
+    <div class="searchformwrapper">
     <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="検索" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
+      <input type="text" name="q" />
+      <input type="submit" value="検索" />
     </form>
+    </div>
 </div>
 <script type="text/javascript">$('#searchbox').show(0);</script>
         </div>
@@ -203,13 +335,13 @@ input_typeがjsonである場合には、以下のいずれかの形式が使用
         <li class="right" >
           <a href="io_flush.html" title="7.3.23. io_flush"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v7.1.0-73-g6d02cfaドキュメント</a> &#187;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v9.0.2ドキュメント</a> &#187;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="../command.html" >7.3. コマンド</a> &#187;</li>
       </ul>
     </div>
     <div class="footer" role="contentinfo">
-        &#169; Copyright 2009-2018, Brazil, Inc.
+        &#169; Copyright 2009-2019, Brazil, Inc.
     </div>
   </body>
 </html>

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

@@ -1,35 +1,27 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html>
 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja">
   <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.3.25. lock_acquire &#8212; Groonga v7.1.0-73-g6d02cfaドキュメント</title>
+    <meta charset="utf-8" />
+    <title>7.3.25. lock_acquire &#8212; Groonga v9.0.2ドキュメント</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:     '7.1.0-73-g6d02cfa',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  false,
-        SOURCELINK_SUFFIX: '.txt'
-      };
-    </script>
+    <script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></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/language_data.js"></script>
     <script type="text/javascript" src="../../_static/translations.js"></script>
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
     <link rel="index" title="索引" href="../../genindex.html" />
     <link rel="search" title="検索" href="../../search.html" />
     <link rel="next" title="7.3.26. lock_clear" href="lock_clear.html" />
     <link rel="prev" title="7.3.24. load" href="load.html" />
-  </head>
-  <body>
+  </head><body>
 <div class="header">
   <h1 class="title">
     <a id="top-link" href="../../index.html">
@@ -59,7 +51,7 @@
         <li class="right" >
           <a href="load.html" title="7.3.24. load"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v7.1.0-73-g6d02cfaドキュメント</a> &#187;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v9.0.2ドキュメント</a> &#187;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. コマンド</a> &#187;</li>
       </ul>
@@ -71,51 +63,51 @@
           <div class="body" role="main">
   <div class="section" id="lock-acquire">
-<h1>7.3.25. <code class="docutils literal"><span class="pre">lock_acquire</span></code><a class="headerlink" href="#lock-acquire" title="このヘッドラインへのパーマリンク">¶</a></h1>
+<h1>7.3.25. <code class="docutils literal notranslate"><span class="pre">lock_acquire</span></code><a class="headerlink" href="#lock-acquire" title="このヘッドラインへのパーマリンク">¶</a></h1>
 <div class="section" id="summary">
 <h2>7.3.25.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <div class="versionadded">
-<p><span class="versionmodified">バージョン 5.1.2 で追加.</span></p>
+<p><span class="versionmodified added">バージョン 5.1.2 で追加.</span></p>
 </div>
-<p><code class="docutils literal"><span class="pre">lock_acquire</span></code> コマンドは対象オブジェクトのロックを獲得します。対象オブジェクトはデータベース、テーブル、カラムのどれかです。</p>
+<p><code class="docutils literal notranslate"><span class="pre">lock_acquire</span></code> コマンドは対象オブジェクトのロックを獲得します。対象オブジェクトはデータベース、テーブル、カラムのどれかです。</p>
 <div class="admonition note">
-<p class="first admonition-title">注釈</p>
-<p class="last">これは危険なコマンドです。獲得したロックはロックが必要なくなったときに <a class="reference internal" href="lock_release.html"><span class="doc">lock_release</span></a> で解放してください。もし、解放し忘れるとデータベースが壊れるかもしれません。</p>
+<p class="admonition-title">注釈</p>
+<p>これは危険なコマンドです。獲得したロックはロックが必要なくなったときに <a class="reference internal" href="lock_release.html"><span class="doc">lock_release</span></a> で解放してください。もし、解放し忘れるとデータベースが壊れるかもしれません。</p>
 </div>
 </div>
 <div class="section" id="syntax">
 <h2>7.3.25.2. 構文<a class="headerlink" href="#syntax" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <p>このコマンドの引数は1つで省略できます:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>lock_acquire [target_name=null]
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lock_acquire [target_name=null]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">target_name</span></code> パラメーターを省略した場合は対象オブジェクトはデータベースになります。</p>
+<p><code class="docutils literal notranslate"><span class="pre">target_name</span></code> パラメーターを省略した場合は対象オブジェクトはデータベースになります。</p>
 </div>
 <div class="section" id="usage">
 <h2>7.3.25.3. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <p>以下はデータベースのロックを獲得する例です。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>lock_acquire
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lock_acquire
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 </pre></div>
 </div>
 <p>もし、データベースがロックされていると、新しいテーブル・カラムを作れなくなります。ここでは、他の例を示すためにデータベースのロックを解放します。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>lock_release
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>lock_release
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 </pre></div>
 </div>
-<p>以下は <code class="docutils literal"><span class="pre">Entries</span></code> テーブルのロックを獲得する例です。</p>
+<p>以下は <code class="docutils literal notranslate"><span class="pre">Entries</span></code> テーブルのロックを獲得する例です。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>table_create Entries TABLE_NO_KEY
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>table_create Entries TABLE_NO_KEY
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 lock_acquire Entries
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 </pre></div>
 </div>
-<p>以下は <code class="docutils literal"><span class="pre">Sites.title</span></code> カラムのロックを獲得する例です。</p>
+<p>以下は <code class="docutils literal notranslate"><span class="pre">Sites.title</span></code> カラムのロックを獲得する例です。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>table_create Sites TABLE_HASH_KEY ShortText
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>table_create Sites TABLE_HASH_KEY ShortText
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 column_create Sites title COLUMN_SCALAR ShortText
 # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -128,7 +120,7 @@ lock_acquire Sites.title
 <h2>7.3.25.4. 引数<a class="headerlink" href="#parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <p>このセクションではすべての引数について説明します。</p>
 <div class="section" id="target-name">
-<h3>7.3.25.4.1. <code class="docutils literal"><span class="pre">target_name</span></code><a class="headerlink" href="#target-name" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<h3>7.3.25.4.1. <code class="docutils literal notranslate"><span class="pre">target_name</span></code><a class="headerlink" href="#target-name" title="このヘッドラインへのパーマリンク">¶</a></h3>
 <p>テーブル名またはカラム名を指定します。</p>
 <p>指定しなかったら対象オブジェクトはデータベースになります。</p>
 <p>デフォルト値はありません。これは対象オブジェクトはデータベースになるということです。</p>
@@ -136,16 +128,16 @@ lock_acquire Sites.title
 </div>
 <div class="section" id="return-value">
 <h2>7.3.25.5. 戻り値<a class="headerlink" href="#return-value" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><code class="docutils literal"><span class="pre">lock_acquire</span></code> コマンドはロックを獲得できたかどうかを返します。:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>[HEADER, SUCCEEDED_OR_NOT]
+<p><code class="docutils literal notranslate"><span class="pre">lock_acquire</span></code> コマンドはロックを獲得できたかどうかを返します。:</p>
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>[HEADER, SUCCEEDED_OR_NOT]
 </pre></div>
 </div>
 <div class="section" id="header">
-<h3>7.3.25.5.1. <code class="docutils literal"><span class="pre">HEADER</span></code><a class="headerlink" href="#header" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p><code class="docutils literal"><span class="pre">HEADER</span></code> については <a class="reference internal" href="../command/output_format.html"><span class="doc">出力形式</span></a> を参照してください。</p>
+<h3>7.3.25.5.1. <code class="docutils literal notranslate"><span class="pre">HEADER</span></code><a class="headerlink" href="#header" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><code class="docutils literal notranslate"><span class="pre">HEADER</span></code> については <a class="reference internal" href="../command/output_format.html"><span class="doc">出力形式</span></a> を参照してください。</p>
 </div>
 <div class="section" id="succeeded-or-not">
-<h3>7.3.25.5.2. <code class="docutils literal"><span class="pre">SUCCEEDED_OR_NOT</span></code><a class="headerlink" href="#succeeded-or-not" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<h3>7.3.25.5.2. <code class="docutils literal notranslate"><span class="pre">SUCCEEDED_OR_NOT</span></code><a class="headerlink" href="#succeeded-or-not" title="このヘッドラインへのパーマリンク">¶</a></h3>
 <p>コマンドの実行が成功するとtrueを返します。失敗するとエラーとしてfalseを返します。</p>
 </div>
 </div>
@@ -153,8 +145,8 @@ lock_acquire Sites.title
 <h2>7.3.25.6. 参考<a class="headerlink" href="#see-also" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <blockquote>
 <div><ul class="simple">
-<li><a class="reference internal" href="lock_release.html"><span class="doc">lock_release</span></a></li>
-<li><a class="reference internal" href="lock_clear.html"><span class="doc">lock_clear</span></a></li>
+<li><p><a class="reference internal" href="lock_release.html"><span class="doc">lock_release</span></a></p></li>
+<li><p><a class="reference internal" href="lock_clear.html"><span class="doc">lock_clear</span></a></p></li>
 </ul>
 </div></blockquote>
 </div>
@@ -168,17 +160,17 @@ lock_acquire Sites.title
         <div class="sphinxsidebarwrapper">
   <h3><a href="../../index.html">目次</a></h3>
   <ul>
-<li><a class="reference internal" href="#">7.3.25. <code class="docutils literal"><span class="pre">lock_acquire</span></code></a><ul>
+<li><a class="reference internal" href="#">7.3.25. <code class="docutils literal notranslate"><span class="pre">lock_acquire</span></code></a><ul>
 <li><a class="reference internal" href="#summary">7.3.25.1. 概要</a></li>
 <li><a class="reference internal" href="#syntax">7.3.25.2. 構文</a></li>
 <li><a class="reference internal" href="#usage">7.3.25.3. 使い方</a></li>
 <li><a class="reference internal" href="#parameters">7.3.25.4. 引数</a><ul>
-<li><a class="reference internal" href="#target-name">7.3.25.4.1. <code class="docutils literal"><span class="pre">target_name</span></code></a></li>
+<li><a class="reference internal" href="#target-name">7.3.25.4.1. <code class="docutils literal notranslate"><span class="pre">target_name</span></code></a></li>
 </ul>
 </li>
 <li><a class="reference internal" href="#return-value">7.3.25.5. 戻り値</a><ul>
-<li><a class="reference internal" href="#header">7.3.25.5.1. <code class="docutils literal"><span class="pre">HEADER</span></code></a></li>
-<li><a class="reference internal" href="#succeeded-or-not">7.3.25.5.2. <code class="docutils literal"><span class="pre">SUCCEEDED_OR_NOT</span></code></a></li>
+<li><a class="reference internal" href="#header">7.3.25.5.1. <code class="docutils literal notranslate"><span class="pre">HEADER</span></code></a></li>
+<li><a class="reference internal" href="#succeeded-or-not">7.3.25.5.2. <code class="docutils literal notranslate"><span class="pre">SUCCEEDED_OR_NOT</span></code></a></li>
 </ul>
 </li>
 <li><a class="reference internal" href="#see-also">7.3.25.6. 参考</a></li>
@@ -188,18 +180,18 @@ lock_acquire Sites.title
   <h4>前のトピックへ</h4>
   <p class="topless"><a href="load.html"
-                        title="前の章へ">7.3.24. <code class="docutils literal"><span class="pre">load</span></code></a></p>
+                        title="前の章へ">7.3.24. <code class="docutils literal notranslate"><span class="pre">load</span></code></a></p>
   <h4>次のトピックへ</h4>
   <p class="topless"><a href="lock_clear.html"
-                        title="次の章へ">7.3.26. <code class="docutils literal"><span class="pre">lock_clear</span></code></a></p>
+                        title="次の章へ">7.3.26. <code class="docutils literal notranslate"><span class="pre">lock_clear</span></code></a></p>
 <div id="searchbox" style="display: none" role="search">
   <h3>クイック検索</h3>
+    <div class="searchformwrapper">
     <form class="search" action="../../search.html" method="get">
-      <div><input type="text" name="q" /></div>
-      <div><input type="submit" value="検索" /></div>
-      <input type="hidden" name="check_keywords" value="yes" />
-      <input type="hidden" name="area" value="default" />
+      <input type="text" name="q" />
+      <input type="submit" value="検索" />
     </form>
+    </div>
 </div>
 <script type="text/javascript">$('#searchbox').show(0);</script>
         </div>
@@ -218,13 +210,13 @@ lock_acquire Sites.title
         <li class="right" >
           <a href="load.html" title="7.3.24. load"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v7.1.0-73-g6d02cfaドキュメント</a> &#187;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v9.0.2ドキュメント</a> &#187;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="../command.html" >7.3. コマンド</a> &#187;</li>
       </ul>
     </div>
     <div class="footer" role="contentinfo">
-        &#169; Copyright 2009-2018, Brazil, Inc.
+        &#169; Copyright 2009-2019, Brazil, Inc.
     </div>
   </body>
 </html>