RubyGems - rroonga - Versions diffs - 6.0.0-x86-mingw32 → 6.0.2-x86-mingw32 - Mend

rroonga 6.0.0-x86-mingw32 → 6.0.2-x86-mingw32

Files changed (710) hide show

data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_table_remove.html CHANGED Viewed

@@ -3,11 +3,11 @@
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.3.35. logical_table_remove &mdash; Groonga v5.1.2-250-gb1f40be documentation</title>
+    <title>7.3.36. logical_table_remove &mdash; Groonga v6.0.2 documentation</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.1.2-250-gb1f40be',
+        VERSION:     '6.0.2',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -25,10 +25,10 @@
     <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 v5.1.2-250-gb1f40be documentation" href="../../index.html" />
+    <link rel="top" title="Groonga v6.0.2 documentation" href="../../index.html" />
     <link rel="up" title="7.3. Command" href="../command.html" />
-    <link rel="next" title="7.3.36. normalize" href="normalize.html" />
-    <link rel="prev" title="7.3.34. logical_shard_list" href="logical_shard_list.html" />
+    <link rel="next" title="7.3.37. normalize" href="normalize.html" />
+    <link rel="prev" title="7.3.35. logical_shard_list" href="logical_shard_list.html" />
   </head>
   <body role="document">
 <div class="header">
@@ -55,12 +55,12 @@
           <a href="../../genindex.html" title="General Index"
              accesskey="I">index</a></li>
         <li class="right" >
-          <a href="normalize.html" title="7.3.36. normalize"
+          <a href="normalize.html" title="7.3.37. normalize"
              accesskey="N">next</a> |</li>
         <li class="right" >
-          <a href="logical_shard_list.html" title="7.3.34. logical_shard_list"
+          <a href="logical_shard_list.html" title="7.3.35. logical_shard_list"
              accesskey="P">previous</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.1.2-250-gb1f40be documentation</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v6.0.2 documentation</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
           <li class="nav-item nav-item-2"><a href="../command.html" accesskey="U">7.3. Command</a> &raquo;</li>
       </ul>
@@ -72,80 +72,473 @@
           <div class="body" role="main">
   <div class="section" id="logical-table-remove">
-<h1>7.3.35. <code class="docutils literal"><span class="pre">logical_table_remove</span></code><a class="headerlink" href="#logical-table-remove" title="Permalink to this headline">¶</a></h1>
+<h1>7.3.36. <code class="docutils literal"><span class="pre">logical_table_remove</span></code><a class="headerlink" href="#logical-table-remove" title="Permalink to this headline">¶</a></h1>
 <div class="section" id="summary">
-<h2>7.3.35.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<p class="last">This command is an experimental feature.</p>
-</div>
+<h2>7.3.36.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
 <div class="versionadded">
 <p><span class="versionmodified">New in version 5.0.5.</span></p>
 </div>
-<p>TODO</p>
+<p><code class="docutils literal"><span class="pre">logical_table_remove</span></code> removes tables and their columns for the
+specified logical table. If there are one or more indexes against key
+of the tables and their columns, they are also removed.</p>
+<p>If you specify the part of a shard, table of the shard isn't
+removed. <code class="docutils literal"><span class="pre">logical_table_remove</span></code> just deletes records in the table.</p>
+<p>For example, there are the following records in a table:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Record1: <code class="docutils literal"><span class="pre">2016-03-18</span> <span class="pre">00:30:00</span></code></li>
+<li>Record2: <code class="docutils literal"><span class="pre">2016-03-18</span> <span class="pre">01:00:00</span></code></li>
+<li>Record3: <code class="docutils literal"><span class="pre">2016-03-18</span> <span class="pre">02:00:00</span></code></li>
+</ul>
+</div></blockquote>
+<p><code class="docutils literal"><span class="pre">logical_table_remove</span></code> deletes &quot;Record1&quot; and &quot;Record2&quot; when you
+specify range as between <code class="docutils literal"><span class="pre">2016-03-18</span> <span class="pre">00:00:00</span></code> and <code class="docutils literal"><span class="pre">2016-03-18</span>
+<span class="pre">01:30:00</span></code>. <code class="docutils literal"><span class="pre">logical_table_remove</span></code> doesn't delete
+&quot;Record3&quot;. <code class="docutils literal"><span class="pre">logical_table_remove</span></code> doesn't remove the table.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 6.0.1: </span>You can also remove tables and columns that reference the target
+table and tables related with the target shard by using
+<code class="docutils literal"><span class="pre">dependent</span></code> parameter.</p>
+</div>
 </div>
 <div class="section" id="syntax">
-<h2>7.3.35.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
+<h2>7.3.36.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
 <p>This command takes many parameters.</p>
 <p>The required parameters are <code class="docutils literal"><span class="pre">logical_table</span></code> and <code class="docutils literal"><span class="pre">shard_key</span></code>:</p>
 <div class="highlight-none"><div class="highlight"><pre><span></span>logical_table_remove logical_table
                      shard_key
-                     [min]
-                     [min_border]
-                     [max]
-                     [max_border]
+                     [min=null]
+                     [min_border=&quot;include&quot;]
+                     [max=null]
+                     [max_border=&quot;include&quot;]
+                     [dependent=no]
 </pre></div>
 </div>
 </div>
 <div class="section" id="usage">
-<h2>7.3.35.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
-<p>TODO</p>
+<span id="logical-table-remove-usage"></span><h2>7.3.36.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
+<p>You specify logical table name and shard key what you want to remove.</p>
+<p>This section describes about the followings:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Basic usage</li>
+<li>Removes parts of a logical table</li>
+<li>Unremovable cases</li>
+<li>Removes with related tables</li>
+<li>Decreases used resources</li>
+</ul>
+</div></blockquote>
+<div class="section" id="basic-usage">
+<span id="logical-table-remove-basic-usage"></span><h3>7.3.36.3.1. Basic usage<a class="headerlink" href="#basic-usage" title="Permalink to this headline">¶</a></h3>
+<p>Register <code class="docutils literal"><span class="pre">sharding</span></code> plugin to use this command in advance.</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>register sharding
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>You can remove all tables for the logical table by specifying only
+<code class="docutils literal"><span class="pre">logical_table</span></code> and <code class="docutils literal"><span class="pre">shard_key</span></code>.</p>
+<p>Here are commands to create 2 shards:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>table_create  Logs_20160318 TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160318 timestamp COLUMN_SCALAR Time
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create  Logs_20160319 TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160319 timestamp COLUMN_SCALAR Time
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>You can confirm existing shards by <a class="reference internal" href="logical_shard_list.html"><span class="doc">logical_shard_list</span></a>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_shard_list --logical_table Logs
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     {
+#       &quot;name&quot;: &quot;Logs_20160318&quot;
+#     },
+#     {
+#       &quot;name&quot;: &quot;Logs_20160319&quot;
+#     }
+#   ]
+# ]
+</pre></div>
+</div>
+<p>You can remove all shards:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_table_remove \
+  --logical_table Logs \
+  --shard_key timestamp
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>There are no shards after you remove all shards:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_shard_list --logical_table Logs
+# [[0, 1337566253.89858, 0.000355720520019531], []]
+</pre></div>
+</div>
+</div>
+<div class="section" id="removes-parts-of-a-logical-table">
+<span id="logical-table-remove-removes-parts"></span><h3>7.3.36.3.2. Removes parts of a logical table<a class="headerlink" href="#removes-parts-of-a-logical-table" title="Permalink to this headline">¶</a></h3>
+<p>You can specify range of shards by the following parameters:</p>
+<blockquote>
+<div><ul class="simple">
+<li><code class="docutils literal"><span class="pre">min</span></code></li>
+<li><code class="docutils literal"><span class="pre">min_border</span></code></li>
+<li><code class="docutils literal"><span class="pre">max</span></code></li>
+<li><code class="docutils literal"><span class="pre">max_border</span></code></li>
+</ul>
+</div></blockquote>
+<p>See the following documents of <a class="reference internal" href="logical_select.html"><span class="doc">logical_select</span></a> for each
+parameter:</p>
+<blockquote>
+<div><ul class="simple">
+<li><a class="reference internal" href="logical_select.html#logical-select-min"><span class="std std-ref">min</span></a></li>
+<li><a class="reference internal" href="logical_select.html#logical-select-min-border"><span class="std std-ref">min_border</span></a></li>
+<li><a class="reference internal" href="logical_select.html#logical-select-max"><span class="std std-ref">max</span></a></li>
+<li><a class="reference internal" href="logical_select.html#logical-select-max-border"><span class="std std-ref">max_border</span></a></li>
+</ul>
+</div></blockquote>
+<p>If the specified range doesn't cover all records in a shard, table for
+the shard isn't removed. Target records in the table are only deleted.</p>
+<p>If the specified range covers all records in a shard, table for the
+shard is removed.</p>
+<p>Here is a logical table to show the behavior. The logical table has two
+shards:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>table_create  Logs_20160318 TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160318 timestamp COLUMN_SCALAR Time
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+load --table Logs_20160318
+[
+{&quot;timestamp&quot;: &quot;2016-03-18 00:30:00&quot;},
+{&quot;timestamp&quot;: &quot;2016-03-18 01:00:00&quot;},
+{&quot;timestamp&quot;: &quot;2016-03-18 02:00:00&quot;}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
+table_create  Logs_20160319 TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160319 timestamp COLUMN_SCALAR Time
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+load --table Logs_20160319
+[
+{&quot;timestamp&quot;: &quot;2016-03-19 00:30:00&quot;},
+{&quot;timestamp&quot;: &quot;2016-03-19 01:00:00&quot;}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 2]
+</pre></div>
+</div>
+<p>There are the following records in <code class="docutils literal"><span class="pre">Logs_20160318</span></code> table:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Record1: <code class="docutils literal"><span class="pre">&quot;2016-03-18</span> <span class="pre">00:30:00&quot;</span></code></li>
+<li>Record2: <code class="docutils literal"><span class="pre">&quot;2016-03-18</span> <span class="pre">01:00:00&quot;</span></code></li>
+<li>Record3: <code class="docutils literal"><span class="pre">&quot;2016-03-18</span> <span class="pre">02:00:00&quot;</span></code></li>
+</ul>
+</div></blockquote>
+<p>There are the following records in <code class="docutils literal"><span class="pre">Logs_20160319</span></code> table:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Record1: <code class="docutils literal"><span class="pre">&quot;2016-03-19</span> <span class="pre">00:30:00&quot;</span></code></li>
+<li>Record2: <code class="docutils literal"><span class="pre">&quot;2016-03-19</span> <span class="pre">01:00:00&quot;</span></code></li>
+</ul>
+</div></blockquote>
+<p>The following range doesn't cover &quot;Record1&quot; in <code class="docutils literal"><span class="pre">Logs_20160318</span></code> table
+but covers all records in <code class="docutils literal"><span class="pre">Logs_20160319</span></code> table:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="50%" />
+<col width="50%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">Parameter</th>
+<th class="head">Value</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">min</span></code></td>
+<td><code class="docutils literal"><span class="pre">&quot;2016-03-18</span> <span class="pre">01:00:00&quot;</span></code></td>
+</tr>
+<tr class="row-odd"><td><code class="docutils literal"><span class="pre">min_border</span></code></td>
+<td><code class="docutils literal"><span class="pre">&quot;include&quot;</span></code></td>
+</tr>
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">max</span></code></td>
+<td><code class="docutils literal"><span class="pre">&quot;2016-03-19</span> <span class="pre">01:30:00&quot;</span></code></td>
+</tr>
+<tr class="row-odd"><td><code class="docutils literal"><span class="pre">max_border</span></code></td>
+<td><code class="docutils literal"><span class="pre">&quot;include&quot;</span></code></td>
+</tr>
+</tbody>
+</table>
+<p><code class="docutils literal"><span class="pre">logical_table_remove</span></code> with the range deletes &quot;Record2&quot; and
+&quot;Record3&quot; in <code class="docutils literal"><span class="pre">Logs_20160318</span></code> table but doesn't remove
+<code class="docutils literal"><span class="pre">Logs_20160318</span></code> table. Because there is &quot;Record1&quot; in
+<code class="docutils literal"><span class="pre">Logs_20160318</span></code> table.</p>
+<p><code class="docutils literal"><span class="pre">logical_table_remove</span></code> with the range removes <code class="docutils literal"><span class="pre">Logs_20160319</span></code>
+table because the range covers all records in <code class="docutils literal"><span class="pre">Logs_20160319</span></code> table.</p>
+<p>Here is an example to use <code class="docutils literal"><span class="pre">logical_table_remove</span></code> with the range:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_table_remove \
+  --logical_table Logs \
+  --shard_key timestamp \
+  --min &quot;2016-03-18 01:00:00&quot; \
+  --min_border &quot;include&quot; \
+  --max &quot;2016-03-19 01:30:00&quot; \
+  --max_border &quot;include&quot;
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p><a class="reference internal" href="dump.html"><span class="doc">dump</span></a> shows that there is &quot;Record1&quot; in <code class="docutils literal"><span class="pre">Logs_20160318</span></code> table:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>dump
+# plugin_register sharding
+#
+# table_create Logs_20160318 TABLE_NO_KEY
+# column_create Logs_20160318 timestamp COLUMN_SCALAR Time
+#
+# load --table Logs_20160318
+# [
+# [&quot;_id&quot;,&quot;timestamp&quot;],
+# [1,1458228600.0]
+# ]
+</pre></div>
+</div>
+</div>
+<div class="section" id="unremovable-cases">
+<span id="logical-table-remove-unremovable-cases"></span><h3>7.3.36.3.3. Unremovable cases<a class="headerlink" href="#unremovable-cases" title="Permalink to this headline">¶</a></h3>
+<p>There are some unremovable cases. See
+<a class="reference internal" href="table_remove.html#table-remove-unremovable-cases"><span class="std std-ref">Unremovable cases</span></a> for details. Because
+<code class="docutils literal"><span class="pre">logical_table_remove</span></code> uses the same checks.</p>
+</div>
+<div class="section" id="removes-with-related-tables">
+<span id="logical-table-remove-removes-with-related-tables"></span><h3>7.3.36.3.4. Removes with related tables<a class="headerlink" href="#removes-with-related-tables" title="Permalink to this headline">¶</a></h3>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 6.0.1.</span></p>
+</div>
+<p>If you understand what you'll do, you can also remove tables and
+columns that depend on the target shard with one
+<code class="docutils literal"><span class="pre">logical_table_remove</span></code> command by using <code class="docutils literal"><span class="pre">--dependent</span> <span class="pre">yes</span></code>
+parameter.</p>
+<p>Here are conditions for dependent. If table or column satisfies one of
+the conditions, the table or column depends on the target shard:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Tables and columns that reference the target shard</li>
+<li>Tables for the shard (= The table has the same <code class="docutils literal"><span class="pre">_YYYYMMDD</span></code>
+postfix as the target shard and is referenced from the target
+shard)</li>
+</ul>
+</div></blockquote>
+<p>If there are one or more tables and columns that reference the target
+shard, <code class="docutils literal"><span class="pre">logical_table_remove</span></code> is failed. It's for avoiding dangling
+references.</p>
+<p><code class="docutils literal"><span class="pre">Bookmarks.log_20160320</span></code> column in the following is the column that
+references the target shard:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>table_create  Logs_20160320 TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160320 timestamp COLUMN_SCALAR Time
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Bookmarks TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Bookmarks log_20160320 COLUMN_SCALAR Logs_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>You can't remove <code class="docutils literal"><span class="pre">Logs_20160320</span></code> by <code class="docutils literal"><span class="pre">logical_table_remove</span></code> by
+default:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_table_remove \
+  --logical_table Logs \
+  --shard_key timestamp
+# [
+#   [
+#     -2,
+#     1337566253.89858,
+#     0.000355720520019531,
+#     &quot;operation not permitted: &lt;[table][remove] a column that references the table exists: &lt;Bookmarks.log_20160320&gt; -&gt; &lt;Logs_20160320&quot;,
+#     [
+#       [
+#         &quot;Groonga::Sharding::LogicalTableRemoveCommand.remove_table&quot;,
+#         &quot;/home/kou/work/c/groonga.clean/plugins/sharding/logical_table_remove.rb&quot;,
+#         80
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>You can remove <code class="docutils literal"><span class="pre">Logs_20160320</span></code> by <code class="docutils literal"><span class="pre">logical_table_remove</span></code> with
+<code class="docutils literal"><span class="pre">--dependent</span> <span class="pre">yes</span></code> parameter. <code class="docutils literal"><span class="pre">Bookmarks.log_20160320</span></code> is also
+removed:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_table_remove \
+  --logical_table Logs \
+  --shard_key timestamp \
+  --dependent yes
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p><a class="reference internal" href="object_exist.html"><span class="doc">object_exist</span></a> shows that <code class="docutils literal"><span class="pre">Logs_20160320</span></code> table and
+<code class="docutils literal"><span class="pre">Bookmarks.log_20160320</span></code> column are removed:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>object_exist Logs_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], false]
+object_exist Bookmarks.log_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], false]
+</pre></div>
+</div>
+<p>If there is one or more tables for the target shard,
+<code class="docutils literal"><span class="pre">logical_table_remove</span></code> with <code class="docutils literal"><span class="pre">--dependent</span> <span class="pre">yes</span></code> also removes
+them. Tables that have the same <code class="docutils literal"><span class="pre">_YYYYMMDD</span></code> postfix as the target
+shard are treated as tables for the target shard.</p>
+<p>Here are two tables that have <code class="docutils literal"><span class="pre">_20160320</span></code>
+postfix. <code class="docutils literal"><span class="pre">NotRelated_20160320</span></code> table isn't used by <code class="docutils literal"><span class="pre">Logs_20160320</span></code>
+table. <code class="docutils literal"><span class="pre">Users_20160320</span></code> table is used by <code class="docutils literal"><span class="pre">Logs_20160320</span></code>
+table. <code class="docutils literal"><span class="pre">Servers</span></code> table exists and used by <code class="docutils literal"><span class="pre">Logs_20160320</span></code> table:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>table_create  NotRelated_20160320 TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create  Users_20160320 TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create  Servers TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create  Logs_20160320 TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160320 timestamp COLUMN_SCALAR Time
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160320 user COLUMN_SCALAR Users_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs_20160320 server COLUMN_SCALAR Servers
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p><code class="docutils literal"><span class="pre">logical_table_remove</span></code> with <code class="docutils literal"><span class="pre">--dependent</span> <span class="pre">yes</span></code> parameter removes
+only <code class="docutils literal"><span class="pre">Logs_20160320</span></code> table and <code class="docutils literal"><span class="pre">Users_20160320</span></code> table. Because
+<code class="docutils literal"><span class="pre">Users_20160320</span></code> table has <code class="docutils literal"><span class="pre">_20160320</span></code> postfix and used by
+<code class="docutils literal"><span class="pre">Logs_20160320</span></code>. <code class="docutils literal"><span class="pre">NotRelated_20160320</span></code> table and <code class="docutils literal"><span class="pre">Servers</span></code> table
+aren't removed. Because <code class="docutils literal"><span class="pre">NotRelated_20160320</span></code> table has
+<code class="docutils literal"><span class="pre">_20160320</span></code> postfix but isn't used by <code class="docutils literal"><span class="pre">Logs_20160320</span></code>. <code class="docutils literal"><span class="pre">Servers</span></code>
+table is used by <code class="docutils literal"><span class="pre">Logs_20160320</span></code> but doesn't have <code class="docutils literal"><span class="pre">_20160320</span></code>
+postfix:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>logical_table_remove \
+  --logical_table Logs \
+  --shard_key timestamp \
+  --dependent yes
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>You can confirm that <code class="docutils literal"><span class="pre">Logs_20160320</span></code> table and <code class="docutils literal"><span class="pre">Users_20160320</span></code>
+table are removed but <code class="docutils literal"><span class="pre">NotRelated_20160320</span></code> table and <code class="docutils literal"><span class="pre">Servers</span></code>
+table aren't removed:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>object_exist Logs_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], false]
+object_exist Users_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], false]
+object_exist NotRelated_20160320
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+object_exist Servers
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+</div>
+<div class="section" id="decreases-used-resources">
+<span id="logical-table-remove-decreases-used-resources"></span><h3>7.3.36.3.5. Decreases used resources<a class="headerlink" href="#decreases-used-resources" title="Permalink to this headline">¶</a></h3>
+<p>You can decrease resources for this command. See
+<a class="reference internal" href="table_remove.html#table-remove-decreases-used-resources"><span class="std std-ref">Decreases used resources</span></a> for details. Because
+<code class="docutils literal"><span class="pre">logical_table_remove</span></code> uses the same logic as <a class="reference internal" href="table_remove.html"><span class="doc">table_remove</span></a>.</p>
+</div>
 </div>
 <div class="section" id="parameters">
-<h2>7.3.35.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
+<h2>7.3.36.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
 <p>This section describes parameters of <code class="docutils literal"><span class="pre">logical_table_remove</span></code>.</p>
-<div class="section" id="required-parameter">
-<h3>7.3.35.4.1. Required parameter<a class="headerlink" href="#required-parameter" title="Permalink to this headline">¶</a></h3>
-<p>There are required parameters, <code class="docutils literal"><span class="pre">logical_table</span></code> and <code class="docutils literal"><span class="pre">shard_key</span></code>.</p>
+<div class="section" id="required-parameters">
+<h3>7.3.36.4.1. Required parameters<a class="headerlink" href="#required-parameters" title="Permalink to this headline">¶</a></h3>
+<p>There are required parameters.</p>
 <div class="section" id="logical-table">
-<h4>7.3.35.4.1.1. <code class="docutils literal"><span class="pre">logical_table</span></code><a class="headerlink" href="#logical-table" title="Permalink to this headline">¶</a></h4>
-<p>Specifies logical table name. It means table name without &quot;_YYYYMMDD&quot; postfix.
-If you use actual table such as &quot;Logs_20150203&quot;, &quot;Logs_20150203&quot; and so on, logical table name is &quot;Logs&quot;.</p>
+<span id="logical-table-remove-logical-table"></span><h4>7.3.36.4.1.1. <code class="docutils literal"><span class="pre">logical_table</span></code><a class="headerlink" href="#logical-table" title="Permalink to this headline">¶</a></h4>
+<p>Specifies logical table name. It means table name without
+<code class="docutils literal"><span class="pre">_YYYYMMDD</span></code> postfix.  If you use actual table such as
+<code class="docutils literal"><span class="pre">Logs_20150203</span></code>, <code class="docutils literal"><span class="pre">Logs_20150203</span></code> and so on, logical table name is
+<code class="docutils literal"><span class="pre">Logs</span></code>.</p>
+<p>See also <a class="reference internal" href="logical_select.html#logical-select-logical-table"><span class="std std-ref">logical_table</span></a>.</p>
 </div>
 <div class="section" id="shard-key">
-<h4>7.3.35.4.1.2. <code class="docutils literal"><span class="pre">shard_key</span></code><a class="headerlink" href="#shard-key" title="Permalink to this headline">¶</a></h4>
-<p>Specifies column name which is treated as shared key in each parted table.</p>
+<span id="logical-table-remove-shard-key"></span><h4>7.3.36.4.1.2. <code class="docutils literal"><span class="pre">shard_key</span></code><a class="headerlink" href="#shard-key" title="Permalink to this headline">¶</a></h4>
+<p>Specifies column name which is treated as shared key.</p>
+<p>See also <a class="reference internal" href="logical_select.html#logical-select-shard-key"><span class="std std-ref">shard_key</span></a>.</p>
 </div>
 </div>
 <div class="section" id="optional-parameters">
-<h3>7.3.35.4.2. Optional parameters<a class="headerlink" href="#optional-parameters" title="Permalink to this headline">¶</a></h3>
+<h3>7.3.36.4.2. Optional parameters<a class="headerlink" href="#optional-parameters" title="Permalink to this headline">¶</a></h3>
 <p>There are optional parameters.</p>
 <div class="section" id="min">
-<h4>7.3.35.4.2.1. <code class="docutils literal"><span class="pre">min</span></code><a class="headerlink" href="#min" title="Permalink to this headline">¶</a></h4>
-<p>Specifies the min value of <code class="docutils literal"><span class="pre">shard_key</span></code></p>
+<span id="logical-table-remove-min"></span><h4>7.3.36.4.2.1. <code class="docutils literal"><span class="pre">min</span></code><a class="headerlink" href="#min" title="Permalink to this headline">¶</a></h4>
+<p>Specifies the minimum value of <code class="docutils literal"><span class="pre">shard_key</span></code> column.</p>
+<p>See also <a class="reference internal" href="logical_select.html#logical-select-min"><span class="std std-ref">min</span></a>.</p>
 </div>
 <div class="section" id="min-border">
-<h4>7.3.35.4.2.2. <code class="docutils literal"><span class="pre">min_border</span></code><a class="headerlink" href="#min-border" title="Permalink to this headline">¶</a></h4>
-<p>Specifies whether the min value of borderline must be include or not.
-Specify <code class="docutils literal"><span class="pre">include</span></code> or <code class="docutils literal"><span class="pre">exclude</span></code> as the value of this parameter.</p>
+<span id="logical-table-remove-min-border"></span><h4>7.3.36.4.2.2. <code class="docutils literal"><span class="pre">min_border</span></code><a class="headerlink" href="#min-border" title="Permalink to this headline">¶</a></h4>
+<p>Specifies whether the minimum value is included or not. <code class="docutils literal"><span class="pre">include</span></code>
+and <code class="docutils literal"><span class="pre">exclude</span></code> are available. The default is <code class="docutils literal"><span class="pre">include</span></code>.</p>
+<p>See also <a class="reference internal" href="logical_select.html#logical-select-min-border"><span class="std std-ref">min_border</span></a>.</p>
 </div>
 <div class="section" id="max">
-<h4>7.3.35.4.2.3. <code class="docutils literal"><span class="pre">max</span></code><a class="headerlink" href="#max" title="Permalink to this headline">¶</a></h4>
-<p>Specifies the max value of <code class="docutils literal"><span class="pre">shard_key</span></code>.</p>
+<span id="logical-table-remove-max"></span><h4>7.3.36.4.2.3. <code class="docutils literal"><span class="pre">max</span></code><a class="headerlink" href="#max" title="Permalink to this headline">¶</a></h4>
+<p>Specifies the maximum value of <code class="docutils literal"><span class="pre">shard_key</span></code> column.</p>
+<p>See also <a class="reference internal" href="logical_select.html#logical-select-max"><span class="std std-ref">max</span></a>.</p>
 </div>
 <div class="section" id="max-border">
-<h4>7.3.35.4.2.4. <code class="docutils literal"><span class="pre">max_border</span></code><a class="headerlink" href="#max-border" title="Permalink to this headline">¶</a></h4>
-<p>Specifies whether the max value of borderline must be include or not.
-Specify <code class="docutils literal"><span class="pre">include</span></code> or <code class="docutils literal"><span class="pre">exclude</span></code> as the value of this parameter.</p>
+<span id="logical-table-remove-max-border"></span><h4>7.3.36.4.2.4. <code class="docutils literal"><span class="pre">max_border</span></code><a class="headerlink" href="#max-border" title="Permalink to this headline">¶</a></h4>
+<p>Specifies whether the maximum value is included or not. <code class="docutils literal"><span class="pre">include</span></code>
+and <code class="docutils literal"><span class="pre">exclude</span></code> are available. The default is <code class="docutils literal"><span class="pre">include</span></code>.</p>
+<p>See also <a class="reference internal" href="logical_select.html#logical-select-max-border"><span class="std std-ref">max_border</span></a>.</p>
+</div>
+<div class="section" id="dependent">
+<span id="logical-table-remove-dependent"></span><h4>7.3.36.4.2.5. <code class="docutils literal"><span class="pre">dependent</span></code><a class="headerlink" href="#dependent" title="Permalink to this headline">¶</a></h4>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 6.0.1.</span></p>
+</div>
+<p>Specifies whether tables and columns that depend on the target shard
+are also removed or not.</p>
+<p>Here are conditions for dependent. If table or column satisfies one of
+the conditions, the table or column depends on the target shard:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Tables and columns that reference the target shard</li>
+<li>Tables for the shard (= The table has the same <code class="docutils literal"><span class="pre">_YYYYMMDD</span></code>
+postfix as the target shard and is referenced from the target
+shard)</li>
+</ul>
+</div></blockquote>
+<p>If this value is <code class="docutils literal"><span class="pre">yes</span></code>, tables and columns that depend on the target
+shard are also removed. Otherwise, they aren't removed. If there are
+one or more tables that reference the target shard, an error is
+returned. If there are tables for the shared, they are not touched.</p>
+<p>You should use this parameter carefully. This is a danger parameter.</p>
+<p>See <a class="reference internal" href="#logical-table-remove-removes-with-related-tables"><span class="std std-ref">Removes with related tables</span></a> how to use
+this parameter.</p>
 </div>
 </div>
 </div>
 <div class="section" id="return-value">
-<h2>7.3.35.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
-<p>TODO</p>
+<h2>7.3.36.5. Return value<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
+<p>The command returns <code class="docutils literal"><span class="pre">true</span></code> as body on success such as:</p>
 <div class="highlight-none"><div class="highlight"><pre><span></span>[HEADER, true]
 </pre></div>
 </div>
+<p>If the command fails, error details are in <code class="docutils literal"><span class="pre">HEADER</span></code>.</p>
+<p>See <a class="reference internal" href="../command/output_format.html"><span class="doc">Output format</span></a> for <code class="docutils literal"><span class="pre">HEADER</span></code>.</p>
 </div>
 </div>
@@ -157,36 +550,44 @@ Specify <code class="docutils literal"><span class="pre">include</span></code> o
         <div class="sphinxsidebarwrapper">
   <h3><a href="../../index.html">Table Of Contents</a></h3>
   <ul>
-<li><a class="reference internal" href="#">7.3.35. <code class="docutils literal"><span class="pre">logical_table_remove</span></code></a><ul>
-<li><a class="reference internal" href="#summary">7.3.35.1. Summary</a></li>
-<li><a class="reference internal" href="#syntax">7.3.35.2. Syntax</a></li>
-<li><a class="reference internal" href="#usage">7.3.35.3. Usage</a></li>
-<li><a class="reference internal" href="#parameters">7.3.35.4. Parameters</a><ul>
-<li><a class="reference internal" href="#required-parameter">7.3.35.4.1. Required parameter</a><ul>
-<li><a class="reference internal" href="#logical-table">7.3.35.4.1.1. <code class="docutils literal"><span class="pre">logical_table</span></code></a></li>
-<li><a class="reference internal" href="#shard-key">7.3.35.4.1.2. <code class="docutils literal"><span class="pre">shard_key</span></code></a></li>
+<li><a class="reference internal" href="#">7.3.36. <code class="docutils literal"><span class="pre">logical_table_remove</span></code></a><ul>
+<li><a class="reference internal" href="#summary">7.3.36.1. Summary</a></li>
+<li><a class="reference internal" href="#syntax">7.3.36.2. Syntax</a></li>
+<li><a class="reference internal" href="#usage">7.3.36.3. Usage</a><ul>
+<li><a class="reference internal" href="#basic-usage">7.3.36.3.1. Basic usage</a></li>
+<li><a class="reference internal" href="#removes-parts-of-a-logical-table">7.3.36.3.2. Removes parts of a logical table</a></li>
+<li><a class="reference internal" href="#unremovable-cases">7.3.36.3.3. Unremovable cases</a></li>
+<li><a class="reference internal" href="#removes-with-related-tables">7.3.36.3.4. Removes with related tables</a></li>
+<li><a class="reference internal" href="#decreases-used-resources">7.3.36.3.5. Decreases used resources</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#parameters">7.3.36.4. Parameters</a><ul>
+<li><a class="reference internal" href="#required-parameters">7.3.36.4.1. Required parameters</a><ul>
+<li><a class="reference internal" href="#logical-table">7.3.36.4.1.1. <code class="docutils literal"><span class="pre">logical_table</span></code></a></li>
+<li><a class="reference internal" href="#shard-key">7.3.36.4.1.2. <code class="docutils literal"><span class="pre">shard_key</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#optional-parameters">7.3.35.4.2. Optional parameters</a><ul>
-<li><a class="reference internal" href="#min">7.3.35.4.2.1. <code class="docutils literal"><span class="pre">min</span></code></a></li>
-<li><a class="reference internal" href="#min-border">7.3.35.4.2.2. <code class="docutils literal"><span class="pre">min_border</span></code></a></li>
-<li><a class="reference internal" href="#max">7.3.35.4.2.3. <code class="docutils literal"><span class="pre">max</span></code></a></li>
-<li><a class="reference internal" href="#max-border">7.3.35.4.2.4. <code class="docutils literal"><span class="pre">max_border</span></code></a></li>
+<li><a class="reference internal" href="#optional-parameters">7.3.36.4.2. Optional parameters</a><ul>
+<li><a class="reference internal" href="#min">7.3.36.4.2.1. <code class="docutils literal"><span class="pre">min</span></code></a></li>
+<li><a class="reference internal" href="#min-border">7.3.36.4.2.2. <code class="docutils literal"><span class="pre">min_border</span></code></a></li>
+<li><a class="reference internal" href="#max">7.3.36.4.2.3. <code class="docutils literal"><span class="pre">max</span></code></a></li>
+<li><a class="reference internal" href="#max-border">7.3.36.4.2.4. <code class="docutils literal"><span class="pre">max_border</span></code></a></li>
+<li><a class="reference internal" href="#dependent">7.3.36.4.2.5. <code class="docutils literal"><span class="pre">dependent</span></code></a></li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a class="reference internal" href="#return-value">7.3.35.5. Return value</a></li>
+<li><a class="reference internal" href="#return-value">7.3.36.5. Return value</a></li>
 </ul>
 </li>
 </ul>
   <h4>Previous topic</h4>
   <p class="topless"><a href="logical_shard_list.html"
-                        title="previous chapter">7.3.34. <code class="docutils literal"><span class="pre">logical_shard_list</span></code></a></p>
+                        title="previous chapter">7.3.35. <code class="docutils literal"><span class="pre">logical_shard_list</span></code></a></p>
   <h4>Next topic</h4>
   <p class="topless"><a href="normalize.html"
-                        title="next chapter">7.3.36. <code class="docutils literal"><span class="pre">normalize</span></code></a></p>
+                        title="next chapter">7.3.37. <code class="docutils literal"><span class="pre">normalize</span></code></a></p>
   <div role="note" aria-label="source link">
     <h3>This Page</h3>
     <ul class="this-page-menu">
@@ -202,9 +603,6 @@ Specify <code class="docutils literal"><span class="pre">include</span></code> o
       <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>
@@ -218,12 +616,12 @@ Specify <code class="docutils literal"><span class="pre">include</span></code> o
           <a href="../../genindex.html" title="General Index"
              >index</a></li>
         <li class="right" >
-          <a href="normalize.html" title="7.3.36. normalize"
+          <a href="normalize.html" title="7.3.37. normalize"
              >next</a> |</li>
         <li class="right" >
-          <a href="logical_shard_list.html" title="7.3.34. logical_shard_list"
+          <a href="logical_shard_list.html" title="7.3.35. logical_shard_list"
              >previous</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.1.2-250-gb1f40be documentation</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v6.0.2 documentation</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. Reference manual</a> &raquo;</li>
           <li class="nav-item nav-item-2"><a href="../command.html" >7.3. Command</a> &raquo;</li>
       </ul>