<!DOCTYPE html>
<html>
<head>
</head>
<body>
<dl style="line-height: 1.5; margin-left: 2em">
<dt style="clear: both; float: left; font-weight: bold; width: 8em">Author</dt>
<dd style="margin-left: 8.5em">Kentaro Hayashi <hayas****@clear*****></dd>
<dt style="clear: both; float: left; font-weight: bold; width: 8em">Date</dt>
<dd style="margin-left: 8.5em">2017-10-06 19:28:11 +0900 (Fri, 06 Oct 2017)</dd>
<dt style="clear: both; float: left; font-weight: bold; width: 8em">New Revision</dt>
<dd style="margin-left: 8.5em"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a">739f9b012d9caa7709666261c6fd57f59b9b7d1a</a></dd>
<dt style="clear: both; float: left; font-weight: bold; width: 8em">Message</dt>
<dd style="margin-left: 8.5em"><pre style="border: 1px solid #aaa; font-family: Consolas, Menlo, "Liberation Mono", Courier, monospace; line-height: 1.2; padding: 0.5em; width: auto">doc: add description about exception case for sort_keys</pre></dd>
<dt style="clear: both; float: left; font-weight: bold; width: 8em">Modified files</dt>
<dd style="margin-left: 8.5em">
<ul>
<li><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5a">doc/source/reference/commands/logical_select.rst</a></li>
</ul>
</dd>
</dl>
<div class="diff-section" style="clear: both">
<table style="border-collapse: collapse; border: 1px solid #aaa">
<thead>
<tr class="diff-header" style="border: 1px solid #aaa">
<td colspan="3">
<pre style="border: 0; font-family: Consolas, Menlo, "Liberation Mono", Courier, monospace; line-height: 1.2; margin: 0; padding: 0.5em; white-space: normal; width: auto"><span class="diff-header" style="background-color: #eaf2f5; color: #999999; display: block; white-space: pre"> Modified: doc/source/reference/commands/logical_select.rst (+13 -1)</span>
<span class="diff-header-mark" style="background-color: #eaf2f5; color: #999999; display: block; white-space: pre">===================================================================</span>
</pre>
</td>
</tr>
</thead>
<tbody>
<tr>
<th class="diff-line-number" style="border: 1px solid #aaa">
<pre style="border: 0; font-family: Consolas, Menlo, "Liberation Mono", Courier, monospace; line-height: 1.2; margin: 0; padding: 0.5em; white-space: normal; width: auto"><span class="diff-line-number-hunk-header" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL138">...</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL139">139</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL140">140</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL141">141</a></span>
<span class="diff-line-number-deleted" style="background-color: #ffecec; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL142">142</a></span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL143">143</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL144">144</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL145">145</a></span>
<span class="diff-line-number-hunk-header" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL544">...</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL545">545</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL546">546</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL547">547</a></span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL548">548</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL549">549</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aL550">550</a></span>
</pre>
</th>
<th class="diff-line-number" style="border: 1px solid #aaa">
<pre style="border: 0; font-family: Consolas, Menlo, "Liberation Mono", Courier, monospace; line-height: 1.2; margin: 0; padding: 0.5em; white-space: normal; width: auto"><span class="diff-line-number-hunk-header" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR138">...</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR139">139</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR140">140</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR141">141</a></span>
<span class="diff-line-number-nothing" style="display: block; white-space: pre"> </span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR142">142</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR143">143</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR144">144</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR145">145</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR146">146</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR147">147</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR148">148</a></span>
<span class="diff-line-number-hunk-header" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR547">...</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR548">548</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR549">549</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR550">550</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR551">551</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR552">552</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR553">553</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR554">554</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR555">555</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR556">556</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR557">557</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR558">558</a></span>
<span class="diff-line-number-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR559">559</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR560">560</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR561">561</a></span>
<span class="diff-line-number-not-changed" style="display: block; white-space: pre"><a href="https://github.com/groonga/groonga/commit/739f9b012d9caa7709666261c6fd57f59b9b7d1a#diff-e6e3af6716f7b1d2bca8ff6abcaa5d5aR562">562</a></span>
</pre>
</th>
<td class="diff-content" style="border: 1px solid #aaa">
<pre style="border: 0; font-family: Consolas, Menlo, "Liberation Mono", Courier, monospace; line-height: 1.2; margin: 0; padding: 0.5em; white-space: normal; width: auto"><span class="diff-hunk-header" style="background-color: #eaf2f5; color: #999999; display: block; white-space: pre">@@ -139,7 +139,10 @@ <span class="diff-context" style="background-color: #ffffaa; color: #000000">But there are some differences from :doc:`select`:</span></span>
<span class="diff-not-changed" style="display: block; white-space: pre"> * ``logical_table`` and ``shard_key`` parameters are required</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> instead of ``table`` parameter.</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> * ``sort_keys`` isn't supported when multiple shards are used. (Only</span>
<span class="diff-deleted" style="background-color: #ffecec; color: #000000; display: block; white-space: pre">- one shard is used, they are supported.)</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ one shard is used, they are supported. There is one exception</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ about ``sort_keys`` for multiple shards. When ``shard_keys`` and</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ ``sort_keys`` are same, they are supported. See</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ :ref:`logical-select-sort-keys` about details)</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> * ``_value.${KEY_NAME}`` in ``drilldowns[${LABEL}].sort_keys``</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> doesn't work with multiple shards. It works with one</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> shard. ``_key`` in ``drilldowns[${LABEL}].sort_keys`` work with</span>
<span class="diff-hunk-header" style="background-color: #eaf2f5; color: #999999; display: block; white-space: pre">@@ -545,6 +548,15 @@ <span class="diff-context" style="background-color: #ffffaa; color: #000000">Corresponds to :ref:`select-sort-keys` in :doc:`select`. See</span></span>
<span class="diff-not-changed" style="display: block; white-space: pre"> search target shards is one. If the number of search target shards is</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> larger than one, ``sort_keys`` doesn't work.</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> </span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+.. note::</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ There is one exception for multiple shards. When the same value is</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ specified for ``shard_key`` and ``sort_keys``, they are supported.</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ ``logical_select`` processes target shards one by one by ascending</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ order. Thus, in this process, magnitude correlation about the value</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ of ``shard_key`` is kept among them. This is because ``sort_keys``</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+ is supported when ``shard_key`` and ``sort_keys`` is same.</span>
<span class="diff-added" style="background-color: #eaffea; color: #000000; display: block; white-space: pre">+</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> Here is an example that uses only one shard:</span>
<span class="diff-not-changed" style="display: block; white-space: pre"> </span>
<span class="diff-not-changed" style="display: block; white-space: pre"> .. groonga-command</span>
</pre>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>