Merge pull request #5 from cockroachdb/master

Sync my repo

_config_base.yml

@@ -51,10 +51,10 @@ release_info:
     start_time: 2020-09-24 11:01:26.34274101 +0000 UTC
   v20.2:
     name: v20.2.0
-    version: v20.2.0-beta.3
+    version: v20.2.0-beta.4
     docker_image: cockroachdb/cockroach-unstable
-    build_time: 2020/09/30 11:00:26 (go1.13.4)
-    start_time: 2020-09-30 11:01:26.34274101 +0000 UTC
+    build_time: 2020/10/06 11:00:26 (go1.13.4)
+    start_time: 2020-10-06 11:01:26.34274101 +0000 UTC
 
 
 include: ["_redirects"]

_data/releases.yml

@@ -183,17 +183,19 @@
       no_windows: true
 - title: Testing releases
   releases:
-    - date: September 30, 2020
+    - date: Oct 6, 2020
+      version: v20.2.0-beta.4
+    - date: Sep 30, 2020
       version: v20.2.0-beta.3
-    - date: September 25, 2020
+    - date: Sep 25, 2020
       version: v20.2.0-beta.2
-    - date: September 14, 2020
+    - date: Sep 14, 2020
       version: v20.2.0-beta.1
-    - date: August 25, 2020
+    - date: Aug 25, 2020
       version: v20.2.0-alpha.3
-    - date: July 27, 2020
+    - date: Jul 27, 2020
       version: v20.2.0-alpha.2
-    - date: June 17, 2020
+    - date: Jun 17, 2020
       version: v20.2.0-alpha.1
     - date: Apr 21, 2020
       version: v20.1.0-rc.2

_includes/sidebar-data-v20.2.json

@@ -1482,6 +1482,12 @@
     		      "/${VERSION}/set-cluster-setting.html"
     		    ]
     		  },
+    		  {
+    		    "title": "<code>SET SCHEMA</code>",
+    		    "urls": [
+    		      "/${VERSION}/set-schema.html"
+    		    ]
+    		  },
     		  {
     		    "title": "<code>SET TRANSACTION</code>",
     		    "urls": [

_includes/sidebar-releases.json

@@ -36,7 +36,7 @@
         {
           "title": "Latest v20.2 Beta",
           "urls": [
-            "/releases/v20.2.0-beta.3.html"
+            "/releases/v20.2.0-beta.4.html"
           ]
         },
         {

_includes/v19.2/zone-configs/variables.md

@@ -4,7 +4,7 @@ Variable | Description
 `range_max_bytes` | The maximum size, in bytes, for a range of data in the zone. When a range reaches this size, CockroachDB will split it into two ranges.<br><br>**Default:** `67108864` (64MiB)
 `gc.ttlseconds` | <a name="gc-ttlseconds"></a> The number of seconds overwritten values will be retained before garbage collection. Smaller values can save disk space if values are frequently overwritten; larger values increase the range allowed for `AS OF SYSTEM TIME` queries, also know as [Time Travel Queries](select-clause.html#select-historical-data-time-travel).<br><br>It is not recommended to set this below `600` (10 minutes); doing so will cause problems for long-running queries. Also, since all versions of a row are stored in a single range that never splits, it is not recommended to set this so high that all the changes to a row in that time period could add up to more than 64MiB; such oversized ranges could contribute to the server running out of memory or other problems.<br><br>**Default:** `90000` (25 hours)
 `num_replicas` | <a name="num_replicas"></a> The number of replicas in the zone.<br><br>**Default:** `3`<br><br>For the `system` database and `.meta`, `.liveness`, and `.system` ranges, the default value is `5`.
-`constraints` | An array of required (`+`) and/or prohibited (`-`) constraints influencing the location of replicas. See [Types of Constraints](configure-replication-zones.html#types-of-constraints) and [Scope of Constraints](configure-replication-zones.html#scope-of-constraints) for more details.<br/><br/>To prevent hard-to-detect typos, constraints placed on [store attributes and node localities](configure-replication-zones.html#descriptive-attributes-assigned-to-nodes) must match the values passed to at least one node in the cluster. If not, an error is signalled.<br/><br/>**Default:** No constraints, with CockroachDB locating each replica on a unique node and attempting to spread replicas evenly across localities.
+`constraints` | An array of required (`+`) and/or prohibited (`-`) constraints influencing the location of replicas. See [Types of Constraints](configure-replication-zones.html#types-of-constraints) and [Scope of Constraints](configure-replication-zones.html#scope-of-constraints) for more details.<br/><br/>To prevent hard-to-detect typos, constraints placed on [store attributes and node localities](configure-replication-zones.html#descriptive-attributes-assigned-to-nodes) must match the values passed to at least one node in the cluster. If not, an error is signalled. To prevent this error, make sure at least one active node is configured to match the constraint. For example, apply `constraints = '[+region=west]'` only if you had set `--locality=region=west` for at least one node while starting the cluster.<br/><br/>**Default:** No constraints, with CockroachDB locating each replica on a unique node and attempting to spread replicas evenly across localities.
 `lease_preferences` <a name="lease_preferences"></a> | An ordered list of required and/or prohibited constraints influencing the location of [leaseholders](architecture/overview.html#glossary).  Whether each constraint is required or prohibited is expressed with a leading `+` or `-`, respectively.  Note that lease preference constraints do not have to be shared with the `constraints` field.  For example, it's valid for your configuration to define a `lease_preferences` field that does not reference any values from the `constraints` field.  It's also valid to define a `lease_preferences` field with no `constraints` field at all. <br /><br />  If the first preference cannot be satisfied, CockroachDB will attempt to satisfy the second preference, and so on.  If none of the preferences can be met, the lease will be placed using the default lease placement algorithm, which is to base lease placement decisions on how many leases each node already has, trying to make all the nodes have around the same amount.<br /><br />Each value in the list can include multiple constraints.  For example, the list `[[+zone=us-east-1b, +ssd], [+zone=us-east-1a], [+zone=us-east-1c, +ssd]]` means "prefer nodes with an SSD in `us-east-1b`, then any nodes in `us-east-1a`, then nodes in `us-east-1c` with an SSD."<br /><br /> For a usage example, see [Constrain leaseholders to specific datacenters](configure-replication-zones.html#constrain-leaseholders-to-specific-datacenters).<br /><br />**Default**: No lease location preferences are applied if this field is not specified.
 
 {{site.data.alerts.callout_info}}

_includes/v20.1/sql/settings/settings.md

@@ -69,6 +69,6 @@
 <tr><td><code>trace.debug.enable</code></td><td>boolean</td><td><code>false</code></td><td>if set, traces for recent requests can be seen in the /debug page</td></tr>
 <tr><td><code>trace.lightstep.token</code></td><td>string</td><td><code></code></td><td>if set, traces go to Lightstep using this token</td></tr>
 <tr><td><code>trace.zipkin.collector</code></td><td>string</td><td><code></code></td><td>if set, traces go to the given Zipkin instance (example: '127.0.0.1:9411'); ignored if trace.lightstep.token is set</td></tr>
-<tr><td><code>version</code></td><td>custom validation</td><td><code>19.2-14</code></td><td>set the active cluster version in the format '<major>.<minor>'</td></tr>
+<tr><td><code>version</code></td><td>custom validation</td><td><code>20.1</code></td><td>set the active cluster version in the format '<major>.<minor>'</td></tr>
 </tbody>
 </table>

_includes/v20.1/zone-configs/variables.md

@@ -4,7 +4,7 @@ Variable | Description
 `range_max_bytes` | The maximum size, in bytes, for a range of data in the zone. When a range reaches this size, CockroachDB will split it into two ranges.<br><br>**Default:** `536870912` (512 MiB)
 `gc.ttlseconds` | <a name="gc-ttlseconds"></a> The number of seconds overwritten values will be retained before garbage collection. Smaller values can save disk space if values are frequently overwritten; larger values increase the range allowed for `AS OF SYSTEM TIME` queries, also know as [Time Travel Queries](select-clause.html#select-historical-data-time-travel).<br><br>It is not recommended to set this below `600` (10 minutes); doing so will cause problems for long-running queries. Also, since all versions of a row are stored in a single range that never splits, it is not recommended to set this so high that all the changes to a row in that time period could add up to more than 512 MiB; such oversized ranges could contribute to the server running out of memory or other problems.<br><br>**Default:** `90000` (25 hours)
 `num_replicas` | <a name="num_replicas"></a> The number of replicas in the zone.<br><br>**Default:** `3`<br><br>For the `system` database and `.meta`, `.liveness`, and `.system` ranges, the default value is `5`.
-`constraints` | An array of required (`+`) and/or prohibited (`-`) constraints influencing the location of replicas. See [Types of Constraints](configure-replication-zones.html#types-of-constraints) and [Scope of Constraints](configure-replication-zones.html#scope-of-constraints) for more details.<br/><br/>To prevent hard-to-detect typos, constraints placed on [store attributes and node localities](configure-replication-zones.html#descriptive-attributes-assigned-to-nodes) must match the values passed to at least one node in the cluster. If not, an error is signalled.<br/><br/>**Default:** No constraints, with CockroachDB locating each replica on a unique node and attempting to spread replicas evenly across localities.
+`constraints` | An array of required (`+`) and/or prohibited (`-`) constraints influencing the location of replicas. See [Types of Constraints](configure-replication-zones.html#types-of-constraints) and [Scope of Constraints](configure-replication-zones.html#scope-of-constraints) for more details.<br/><br/>To prevent hard-to-detect typos, constraints placed on [store attributes and node localities](configure-replication-zones.html#descriptive-attributes-assigned-to-nodes) must match the values passed to at least one node in the cluster. If not, an error is signalled. To prevent this error, make sure at least one active node is configured to match the constraint. For example, apply `constraints = '[+region=west]'` only if you had set `--locality=region=west` for at least one node while starting the cluster.<br/><br/>**Default:** No constraints, with CockroachDB locating each replica on a unique node and attempting to spread replicas evenly across localities.
 `lease_preferences` <a name="lease_preferences"></a> | An ordered list of required and/or prohibited constraints influencing the location of [leaseholders](architecture/overview.html#glossary).  Whether each constraint is required or prohibited is expressed with a leading `+` or `-`, respectively.  Note that lease preference constraints do not have to be shared with the `constraints` field.  For example, it's valid for your configuration to define a `lease_preferences` field that does not reference any values from the `constraints` field.  It's also valid to define a `lease_preferences` field with no `constraints` field at all. <br /><br />  If the first preference cannot be satisfied, CockroachDB will attempt to satisfy the second preference, and so on.  If none of the preferences can be met, the lease will be placed using the default lease placement algorithm, which is to base lease placement decisions on how many leases each node already has, trying to make all the nodes have around the same amount.<br /><br />Each value in the list can include multiple constraints.  For example, the list `[[+zone=us-east-1b, +ssd], [+zone=us-east-1a], [+zone=us-east-1c, +ssd]]` means "prefer nodes with an SSD in `us-east-1b`, then any nodes in `us-east-1a`, then nodes in `us-east-1c` with an SSD."<br /><br /> For a usage example, see [Constrain leaseholders to specific datacenters](configure-replication-zones.html#constrain-leaseholders-to-specific-datacenters).<br /><br />**Default**: No lease location preferences are applied if this field is not specified.
 
 {{site.data.alerts.callout_info}}

_includes/v20.2/sql/diagrams/alter_sequence.html

@@ -0,0 +1,86 @@
+<div><svg width="1076" height="606">
+<polygon points="9 17 1 13 1 21"></polygon>
+<polygon points="17 17 9 13 9 21"></polygon>
+<a xlink:href="sql-grammar.html#alter_rename_sequence_stmt" xlink:title="alter_rename_sequence_stmt">
+<rect x="51" y="3" width="210" height="32"></rect>
+<rect x="49" y="1" width="210" height="32" class="nonterminal"></rect>
+<text class="nonterminal" x="59" y="21">alter_rename_sequence_stmt</text>
+</a>
+<rect x="51" y="69" width="62" height="32" rx="10"></rect>
+<rect x="49" y="67" width="62" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="59" y="87">ALTER</text>
+<rect x="133" y="69" width="92" height="32" rx="10"></rect>
+<rect x="131" y="67" width="92" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="141" y="87">SEQUENCE</text>
+<rect x="265" y="101" width="34" height="32" rx="10"></rect>
+<rect x="263" y="99" width="34" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="273" y="119">IF</text>
+<rect x="319" y="101" width="68" height="32" rx="10"></rect>
+<rect x="317" y="99" width="68" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="327" y="119">EXISTS</text>
+<a xlink:href="sql-grammar.html#sequence_name" xlink:title="sequence_name">
+<rect x="427" y="69" width="124" height="32"></rect>
+<rect x="425" y="67" width="124" height="32" class="nonterminal"></rect>
+<text class="nonterminal" x="435" y="87">sequence_name</text>
+</a>
+<rect x="611" y="69" width="40" height="32" rx="10"></rect>
+<rect x="609" y="67" width="40" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="619" y="87">NO</text>
+<rect x="691" y="69" width="64" height="32" rx="10"></rect>
+<rect x="689" y="67" width="64" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="699" y="87">CYCLE</text>
+<rect x="691" y="113" width="90" height="32" rx="10"></rect>
+<rect x="689" y="111" width="90" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="699" y="131">MINVALUE</text>
+<rect x="691" y="157" width="92" height="32" rx="10"></rect>
+<rect x="689" y="155" width="92" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="699" y="175">MAXVALUE</text>
+<rect x="611" y="201" width="72" height="32" rx="10"></rect>
+<rect x="609" y="199" width="72" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="619" y="219">OWNED</text>
+<rect x="703" y="201" width="38" height="32" rx="10"></rect>
+<rect x="701" y="199" width="38" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="711" y="219">BY</text>
+<rect x="781" y="201" width="58" height="32" rx="10"></rect>
+<rect x="779" y="199" width="58" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="789" y="219">NONE</text>
+<a xlink:href="sql-grammar.html#column_path" xlink:title="column_path">
+<rect x="781" y="245" width="100" height="32"></rect>
+<rect x="779" y="243" width="100" height="32" class="nonterminal"></rect>
+<text class="nonterminal" x="789" y="263">column_path</text>
+</a>
+<rect x="631" y="289" width="98" height="32" rx="10"></rect>
+<rect x="629" y="287" width="98" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="639" y="307">INCREMENT</text>
+<rect x="769" y="321" width="38" height="32" rx="10"></rect>
+<rect x="767" y="319" width="38" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="777" y="339">BY</text>
+<rect x="631" y="365" width="90" height="32" rx="10"></rect>
+<rect x="629" y="363" width="90" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="639" y="383">MINVALUE</text>
+<rect x="631" y="409" width="92" height="32" rx="10"></rect>
+<rect x="629" y="407" width="92" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="639" y="427">MAXVALUE</text>
+<rect x="631" y="453" width="62" height="32" rx="10"></rect>
+<rect x="629" y="451" width="62" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="639" y="471">START</text>
+<rect x="733" y="485" width="58" height="32" rx="10"></rect>
+<rect x="731" y="483" width="58" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="741" y="503">WITH</text>
+<a xlink:href="sql-grammar.html#signed_iconst64" xlink:title="signed_iconst64">
+<rect x="867" y="289" width="122" height="32"></rect>
+<rect x="865" y="287" width="122" height="32" class="nonterminal"></rect>
+<text class="nonterminal" x="875" y="307">signed_iconst64</text>
+</a>
+<rect x="611" y="529" width="78" height="32" rx="10"></rect>
+<rect x="609" y="527" width="78" height="32" class="terminal" rx="10"></rect>
+<text class="terminal" x="619" y="547">VIRTUAL</text>
+<a xlink:href="sql-grammar.html#alter_sequence_set_schema_stmt" xlink:title="alter_sequence_set_schema_stmt">
+<rect x="51" y="573" width="238" height="32"></rect>
+<rect x="49" y="571" width="238" height="32" class="nonterminal"></rect>
+<text class="nonterminal" x="59" y="591">alter_sequence_set_schema_stmt</text>
+</a>
+<path class="line" d="m17 17 h2 m20 0 h10 m210 0 h10 m0 0 h768 m-1018 0 h20 m998 0 h20 m-1038 0 q10 0 10 10 m1018 0 q0 -10 10 -10 m-1028 10 v46 m1018 0 v-46 m-1018 46 q0 10 10 10 m998 0 q10 0 10 -10 m-1008 10 h10 m62 0 h10 m0 0 h10 m92 0 h10 m20 0 h10 m0 0 h132 m-162 0 h20 m142 0 h20 m-182 0 q10 0 10 10 m162 0 q0 -10 10 -10 m-172 10 v12 m162 0 v-12 m-162 12 q0 10 10 10 m142 0 q10 0 10 -10 m-152 10 h10 m34 0 h10 m0 0 h10 m68 0 h10 m20 -32 h10 m124 0 h10 m40 0 h10 m40 0 h10 m20 0 h10 m64 0 h10 m0 0 h28 m-132 0 h20 m112 0 h20 m-152 0 q10 0 10 10 m132 0 q0 -10 10 -10 m-142 10 v24 m132 0 v-24 m-132 24 q0 10 10 10 m112 0 q10 0 10 -10 m-122 10 h10 m90 0 h10 m0 0 h2 m-122 -10 v20 m132 0 v-20 m-132 20 v24 m132 0 v-24 m-132 24 q0 10 10 10 m112 0 q10 0 10 -10 m-122 10 h10 m92 0 h10 m20 -88 h186 m-418 0 h20 m398 0 h20 m-438 0 q10 0 10 10 m418 0 q0 -10 10 -10 m-428 10 v112 m418 0 v-112 m-418 112 q0 10 10 10 m398 0 q10 0 10 -10 m-408 10 h10 m72 0 h10 m0 0 h10 m38 0 h10 m20 0 h10 m58 0 h10 m0 0 h42 m-140 0 h20 m120 0 h20 m-160 0 q10 0 10 10 m140 0 q0 -10 10 -10 m-150 10 v24 m140 0 v-24 m-140 24 q0 10 10 10 m120 0 q10 0 10 -10 m-130 10 h10 m100 0 h10 m20 -44 h88 m-408 -10 v20 m418 0 v-20 m-418 20 v68 m418 0 v-68 m-418 68 q0 10 10 10 m398 0 q10 0 10 -10 m-388 10 h10 m98 0 h10 m20 0 h10 m0 0 h48 m-78 0 h20 m58 0 h20 m-98 0 q10 0 10 10 m78 0 q0 -10 10 -10 m-88 10 v12 m78 0 v-12 m-78 12 q0 10 10 10 m58 0 q10 0 10 -10 m-68 10 h10 m38 0 h10 m-216 -32 h20 m216 0 h20 m-256 0 q10 0 10 10 m236 0 q0 -10 10 -10 m-246 10 v56 m236 0 v-56 m-236 56 q0 10 10 10 m216 0 q10 0 10 -10 m-226 10 h10 m90 0 h10 m0 0 h106 m-226 -10 v20 m236 0 v-20 m-236 20 v24 m236 0 v-24 m-236 24 q0 10 10 10 m216 0 q10 0 10 -10 m-226 10 h10 m92 0 h10 m0 0 h104 m-226 -10 v20 m236 0 v-20 m-236 20 v24 m236 0 v-24 m-236 24 q0 10 10 10 m216 0 q10 0 10 -10 m-226 10 h10 m62 0 h10 m20 0 h10 m0 0 h68 m-98 0 h20 m78 0 h20 m-118 0 q10 0 10 10 m98 0 q0 -10 10 -10 m-108 10 v12 m98 0 v-12 m-98 12 q0 10 10 10 m78 0 q10 0 10 -10 m-88 10 h10 m58 0 h10 m20 -32 h16 m20 -164 h10 m122 0 h10 m-408 -10 v20 m418 0 v-20 m-418 20 v220 m418 0 v-220 m-418 220 q0 10 10 10 m398 0 q10 0 10 -10 m-408 10 h10 m78 0 h10 m0 0 h300 m-438 -460 l20 0 m-1 0 q-9 0 -9 -10 l0 -12 q0 -10 10 -10 m438 32 l20 0 m-20 0 q10 0 10 -10 l0 -12 q0 -10 -10 -10 m-438 0 h10 m0 0 h428 m-988 22 v20 m1018 0 v-20 m-1018 20 v484 m1018 0 v-484 m-1018 484 q0 10 10 10 m998 0 q10 0 10 -10 m-1008 10 h10 m238 0 h10 m0 0 h740 m23 -570 h-3"></path>
+<polygon points="1067 17 1075 13 1075 21"></polygon>
+<polygon points="1067 17 1059 13 1059 21"></polygon>
+</svg></div>