Merge remote-tracking branch 'origin/main' into DOC-10629

src/current/_data/products.yml

@@ -4,7 +4,7 @@ dedicated: Dedicated
 
 dedicated-advanced: Dedicated advanced
 
-core: Self-Hosted
+core: self-hosted
 
 enterprise: Enterprise
 

src/current/_data/releases.yml

@@ -7079,4 +7079,31 @@
     docker_arm_limited_access: false
   source: true
   previous_release: v23.2.13
-
+
+
+- release_name: v24.3.0-beta.3
+  major_version: v24.3
+  release_date: '2024-11-05'
+  release_type: Testing
+  go_version: go1.22.5
+  sha: c077ebf6e98bcd579481b93c83f14184ab94f2e6
+  has_sql_only: true
+  has_sha256sum: true
+  mac:
+    mac_arm: true
+    mac_arm_experimental: true
+    mac_arm_limited_access: false
+  windows: true
+  linux:
+    linux_arm: true
+    linux_arm_experimental: false
+    linux_arm_limited_access: false
+    linux_intel_fips: true
+    linux_arm_fips: false
+  docker:
+    docker_image: cockroachdb/cockroach-unstable
+    docker_arm: true
+    docker_arm_experimental: false
+    docker_arm_limited_access: false
+  source: true
+  previous_release: v24.3.0-beta.2

src/current/_includes/common/tls-cipher-suites.md

@@ -1,24 +1,13 @@
 {% if include.list == 'enabled' %}
-- `TLS_DHE_RSA_WITH_AES_128_GCM_SHA256`
-- `TLS_DHE_RSA_WITH_AES_256_GCM_SHA384`
-- `TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256`
-- `TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384`
+- `TLS_AES_128_GCM_SHA256`,
+- `TLS_AES_256_GCM_SHA384`,
+- `TLS_CHACHA20_POLY1305_SHA256`
 - `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`
 - `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`
-- `TLS_DHE_RSA_WITH_AES_128_CCM`
-- `TLS_DHE_RSA_WITH_AES_256_CCM`
+- `TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256`
+- `TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384`
 - `TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256`
 - `TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256`
-- `TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256`
-- `TLS_DHE_PSK_WITH_AES_128_GCM_SHA256`
-- `TLS_DHE_PSK_WITH_AES_256_GCM_SHA384`
-- `TLS_DHE_PSK_WITH_AES_128_CCM`
-- `TLS_DHE_PSK_WITH_AES_256_CCM`
-- `TLS_ECDHE_PSK_WITH_AES_128_GCM_SHA256`
-- `TLS_ECDHE_PSK_WITH_AES_256_GCM_SHA384`
-- `TLS_ECDHE_PSK_WITH_AES_128_CCM_SHA256`
-- `TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256`
-- `TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256`
 {% endif %}
 {% if include.list == 'disabled' %}
 - `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`

src/current/_includes/releases/v24.3/v24.3.0-beta.3.md

@@ -0,0 +1,71 @@
+## v24.3.0-beta.3
+
+Release Date: November 5, 2024
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v24-3-0-beta-3-security-updates">Security updates</h3>
+
+- Client authentication errors using LDAP now log more details to help with troubleshooting authentication and authorization issues. [#133812][#133812]
+
+<h3 id="v24-3-0-beta-3-sql-changes">SQL changes</h3>
+
+- [Physical Cluster Replication]({% link v24.3/physical-cluster-replication-overview.md %}) reader catalogs now bypass AOST timestamps using the `bypass_pcr_reader_catalog_aost` session variable, which can be used to modify cluster settings within the reader. [#133876][#133876]
+
+<h3 id="v24-3-0-beta-3-operational-changes">Operational changes</h3>
+
+- Added a timer for inner [changefeed sink]({% link v24.3/changefeed-sinks.md %}) client flushes. [#133288][#133288]
+- Rows replicated by Logical Data Replication in `immediate` mode are now considered in the decision to recompute SQL table statistics. [#133591][#133591]
+- The new cluster setting `kvadmission.flow_controller.token_reset_epoch` can be used to refill replication [admission control]({% link v24.3/admission-control.md %}) v2 tokens. This is an advanced setting. Use it only after consultation with your account team. [#133294][#133294]
+- The new cluster setting `goschedstats.always_use_short_sample_period.enabled`, when set to `true`, helps to prevent unnecessary queueing due to CPU [admission control]({% link v24.3/admission-control.md %}s. [#133585][#133585]
+
+<h3 id="v24-3-0-beta-3-db-console-changes">DB Console changes</h3>
+
+- In [Database]({% link v24.3/ui-databases-page.md %}) pages, the **Refresh** tooltip now includes details about the progress of cache updates and when the job started. [#133351][#133351]
+
+<h3 id="v24-3-0-beta-3-bug-fixes">Bug fixes</h3>
+
+- Fixed a bug where [changefeed sink]({% link v24.3/changefeed-sinks.md %})) timers were not correctly registered with the metric system. [#133288][#133288]
+- Fixed a bug that could cause new connections to fail with the following error after upgrading: `ERROR: invalid value for parameter "vectorize": "unknown(1)" SQLSTATE: 22023 HINT: Available values: off,on,experimental_always`. To encounter this bug, the cluster must have:
+    1. Run on version v21.1 at some point in the past
+    1. Run `SET CLUSTER SETTING sql.defaults.vectorize = 'on';` while running v21.1.
+    1. **Not** set `sql.defaults.vectorize` after upgrading past v21.1 4.
+    1. Subsequently upgraded to v24.2.upgraded all the way to v24.2.
+
+    To detect this bug, run the following query:
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    SELECT * FROM system.settings WHERE name = 'sql.defaults.vectorize
+    ~~~
+
+    If the command returns `1` instead of `on`, run the following statement before upgrading.
+
+    {% include_cached copy-clipboard.html %}
+    ~~~ sql
+    RESET CLUSTER SETTING sql.defaults.vectorize;
+    ~~~
+
+    `1` is now allowed as a value for this setting, and is equivalent to `on`. [#133371][#133371]
+- Fixed a bug in v22.2.13+, v23.1.9+, and v23.2 that could cause the internal error `interface conversion: coldata.Column is` in an edge case. [#133762][#133762]
+- Fixed a bug introduced in v20.1.0 that could cause erroneous `NOT NULL` constraint violation errors to be logged during `UPSERT` and `INSERT` statements with the `ON CONFLICT ...DO UPDATE` clause that update an existing row and a subset of columns that did not include a `NOT NULL` column of the table. [#133820][#133820]
+- Fixed a that could cache and reuse a non-reusable query plan, such as a plan for a DDL or `SHOW` statement, when `plan_cache_mode` was set to `auto` or `force_generic_plan`, which are not the default options. [#133073][#133073]
+- Fixed an unhandled error that could occur while running the command `REVOKE ... ON SEQUENCE FROM ... {user}` on an object that is not a sequence. [#133710][#133710]
+- Fixed a panic that could occur while running a `CREATE TABLE AS` statement that included a [sequence]({% link v24.3/create-sequence.md %}) with an invalid function overload. [#133870][#133870]
+
+
+[#133073]: https://github.com/cockroachdb/cockroach/pull/133073
+[#133288]: https://github.com/cockroachdb/cockroach/pull/133288
+[#133294]: https://github.com/cockroachdb/cockroach/pull/133294
+[#133351]: https://github.com/cockroachdb/cockroach/pull/133351
+[#133371]: https://github.com/cockroachdb/cockroach/pull/133371
+[#133414]: https://github.com/cockroachdb/cockroach/pull/133414
+[#133472]: https://github.com/cockroachdb/cockroach/pull/133472
+[#133585]: https://github.com/cockroachdb/cockroach/pull/133585
+[#133591]: https://github.com/cockroachdb/cockroach/pull/133591
+[#133710]: https://github.com/cockroachdb/cockroach/pull/133710
+[#133762]: https://github.com/cockroachdb/cockroach/pull/133762
+[#133812]: https://github.com/cockroachdb/cockroach/pull/133812
+[#133820]: https://github.com/cockroachdb/cockroach/pull/133820
+[#133870]: https://github.com/cockroachdb/cockroach/pull/133870
+[#133876]: https://github.com/cockroachdb/cockroach/pull/133876

src/current/_includes/v23.2/misc/session-vars.md

@@ -82,6 +82,7 @@
 | <a id="troubleshooting_mode_enabled"></a> `troubleshooting_mode_enabled` | When enabled, avoid performing additional work on queries, such as collecting and emitting telemetry data. This session variable is particularly useful when the cluster is experiencing issues, unavailability, or failure. | `off` | Yes | Yes |
 | <a id="use_declarative_schema_changer"></a> `use_declarative_schema_changer` | Whether to use the declarative schema changer for supported statements. See [Declarative schema changer]({% link {{ page.version.version }}/online-schema-changes.md %}#declarative-schema-changer) for more details. | `on` | Yes | Yes |
 | <a id="vectorize"></a> `vectorize` | The vectorized execution engine mode. Options include `on` and `off`. For more details, see [Configure vectorized execution for CockroachDB]({% link {{ page.version.version }}/vectorized-execution.md %}#configure-vectorized-execution). | `on` | Yes | Yes |
+| <a id="virtual_cluster_name"></a> `virtual_cluster_name` | The name of the virtual cluster that the SQL client is connected to. | Session-dependent | No | Yes |
 
 The following session variables are exposed only for backwards compatibility with earlier CockroachDB releases and have no impact on how CockroachDB runs:
 

src/current/_includes/v23.2/ui/ui-metrics-navigation.md

@@ -2,6 +2,8 @@ Use the **Graph** menu to display metrics for your entire cluster or for a speci
 
 To the right of the Graph and Dashboard menus, a time interval selector allows you to filter the view for a predefined or custom time interval. Use the navigation buttons to move to the previous, next, or current time interval. When you select a time interval, the same interval is selected in the [SQL Activity]({% link {{ page.version.version }}/ui-overview.md %}#sql-activity) pages. However, if you select 10 or 30 minutes, the interval defaults to 1 hour in SQL Activity pages.
 
-When viewing graphs, two perpendicular lines will appear at your mouse cursor providing further insight into the data. The metric values are displayed in the legend under the graph. Click anywhere within the graph to pin the values in place, decoupling the values from your mouse movements. Click anywhere within the graph to cause the values to change with your mouse movements once more.
+Hovering your mouse pointer over the graph title will display a tooltip with a description and the [metrics]({% link {{ page.version.version }}/essential-metrics-self-hosted.md %} ) used to create the graph.
 
-Hovering your mouse cursor over the graph title will display a tooltip with a description and the [metrics]({% link {{ page.version.version }}/essential-metrics-self-hosted.md %} ) used to create the graph.
+When hovering on graphs, crosshair lines will appear at your mouse pointer. The series' values corresponding to the given time in the cross hairs are displayed in the legend under the graph. Hovering the mouse pointer on a given series displays the corresponding value near the mouse pointer and highlights the series line (graying out other series lines). Click anywhere within the graph to freeze the values in place. Click anywhere within the graph again to cause the values to change with your mouse movements once more.
+
+In the legend, click on an individual series to isolate it on the graph. The other series will be hidden, while the hover will still work. Click the individual series again to make the other series visible. If there are many series, a scrollbar may appear on the right of the legend. This is to limit the size of the legend so that it does not get endlessly large, particularly on clusters with many nodes.

src/current/_includes/v24.1/known-limitations/datadog-self-hosted-limitations.md

@@ -1 +1 @@
-The CockroachDB {{ site.data.products.core }} integration with Datadog only supports displaying cluster-wide averages of reported metrics. Filtering by a specific node is unsupported.
+The integration of your CockroachDB {{ site.data.products.core }} cluster with Datadog only supports displaying cluster-wide averages of reported metrics. Filtering by a specific node is unsupported.

src/current/_includes/v24.1/misc/session-vars.md

@@ -85,6 +85,7 @@
 | <a id="troubleshooting_mode_enabled"></a> `troubleshooting_mode_enabled` | When enabled, avoid performing additional work on queries, such as collecting and emitting telemetry data. This session variable is particularly useful when the cluster is experiencing issues, unavailability, or failure. | `off` | Yes | Yes |
 | <a id="use_declarative_schema_changer"></a> `use_declarative_schema_changer` | Whether to use the declarative schema changer for supported statements. See [Declarative schema changer]({% link {{ page.version.version }}/online-schema-changes.md %}#declarative-schema-changer) for more details. | `on` | Yes | Yes |
 | <a id="vectorize"></a> `vectorize` | The vectorized execution engine mode. Options include `on` and `off`. For more details, see [Configure vectorized execution for CockroachDB]({% link {{ page.version.version }}/vectorized-execution.md %}#configure-vectorized-execution). | `on` | Yes | Yes |
+| <a id="virtual_cluster_name"></a> `virtual_cluster_name` | The name of the virtual cluster that the SQL client is connected to. | Session-dependent | No | Yes |
 
 The following session variables are exposed only for backwards compatibility with earlier CockroachDB releases and have no impact on how CockroachDB runs:
 

src/current/_includes/v24.1/ui/ui-metrics-navigation.md

@@ -2,6 +2,8 @@ Use the **Graph** menu to display metrics for your entire cluster or for a speci
 
 To the right of the Graph and Dashboard menus, a time interval selector allows you to filter the view for a predefined or custom time interval. Use the navigation buttons to move to the previous, next, or current time interval. When you select a time interval, the same interval is selected in the [SQL Activity]({% link {{ page.version.version }}/ui-overview.md %}#sql-activity) pages. However, if you select 10 or 30 minutes, the interval defaults to 1 hour in SQL Activity pages.
 
-When viewing graphs, two perpendicular lines will appear at your mouse cursor providing further insight into the data. The metric values are displayed in the legend under the graph. Click anywhere within the graph to pin the values in place, decoupling the values from your mouse movements. Click anywhere within the graph to cause the values to change with your mouse movements once more.
+Hovering your mouse pointer over the graph title will display a tooltip with a description and the [metrics]({% link {{ page.version.version }}/essential-metrics-self-hosted.md %} ) used to create the graph.
 
-Hovering your mouse cursor over the graph title will display a tooltip with a description and the [metrics]({% link {{ page.version.version }}/essential-metrics-self-hosted.md %} ) used to create the graph.
+When hovering on graphs, crosshair lines will appear at your mouse pointer. The series' values corresponding to the given time in the cross hairs are displayed in the legend under the graph. Hovering the mouse pointer on a given series displays the corresponding value near the mouse pointer and highlights the series line (graying out other series lines). Click anywhere within the graph to freeze the values in place. Click anywhere within the graph again to cause the values to change with your mouse movements once more.
+
+In the legend, click on an individual series to isolate it on the graph. The other series will be hidden, while the hover will still work. Click the individual series again to make the other series visible. If there are many series, a scrollbar may appear on the right of the legend. This is to limit the size of the legend so that it does not get endlessly large, particularly on clusters with many nodes.

src/current/_includes/v24.2/known-limitations/datadog-self-hosted-limitations.md

@@ -1 +1 @@
-The CockroachDB {{ site.data.products.core }} integration with Datadog only supports displaying cluster-wide averages of reported metrics. Filtering by a specific node is unsupported.
+The integration of your CockroachDB {{ site.data.products.core }} cluster with Datadog only supports displaying cluster-wide averages of reported metrics. Filtering by a specific node is unsupported.

src/current/_includes/v24.2/misc/session-vars.md

@@ -86,6 +86,7 @@
 | <a id="troubleshooting_mode_enabled"></a> `troubleshooting_mode_enabled` | When enabled, avoid performing additional work on queries, such as collecting and emitting telemetry data. This session variable is particularly useful when the cluster is experiencing issues, unavailability, or failure. | `off` | Yes | Yes |
 | <a id="use_declarative_schema_changer"></a> `use_declarative_schema_changer` | Whether to use the declarative schema changer for supported statements. See [Declarative schema changer]({% link {{ page.version.version }}/online-schema-changes.md %}#declarative-schema-changer) for more details. | `on` | Yes | Yes |
 | <a id="vectorize"></a> `vectorize` | The vectorized execution engine mode. Options include `on` and `off`. For more details, see [Configure vectorized execution for CockroachDB]({% link {{ page.version.version }}/vectorized-execution.md %}#configure-vectorized-execution). | `on` | Yes | Yes |
+| <a id="virtual_cluster_name"></a> `virtual_cluster_name` | The name of the virtual cluster that the SQL client is connected to. | Session-dependent | No | Yes |
 
 The following session variables are exposed only for backwards compatibility with earlier CockroachDB releases and have no impact on how CockroachDB runs:
 

src/current/_includes/v24.2/sidebar-data/optimize-performance.json

@@ -77,6 +77,12 @@
           "urls": [
             "/${VERSION}/apply-statement-performance-rules.html"
           ]
+        },
+        {
+          "title": "Troubleshoot Lock Contention",
+          "urls": [
+            "/${VERSION}/troubleshoot-lock-contention.html"
+          ]
         }
       ]
     }

src/current/_includes/v24.2/ui/ui-metrics-navigation.md

@@ -2,6 +2,8 @@ Use the **Graph** menu to display metrics for your entire cluster or for a speci
 
 To the right of the Graph and Dashboard menus, a time interval selector allows you to filter the view for a predefined or custom time interval. Use the navigation buttons to move to the previous, next, or current time interval. When you select a time interval, the same interval is selected in the [SQL Activity]({% link {{ page.version.version }}/ui-overview.md %}#sql-activity) pages. However, if you select 10 or 30 minutes, the interval defaults to 1 hour in SQL Activity pages.
 
-When viewing graphs, two perpendicular lines will appear at your mouse cursor providing further insight into the data. The metric values are displayed in the legend under the graph. Click anywhere within the graph to pin the values in place, decoupling the values from your mouse movements. Click anywhere within the graph to cause the values to change with your mouse movements once more.
+Hovering your mouse pointer over the graph title will display a tooltip with a description and the [metrics]({% link {{ page.version.version }}/essential-metrics-self-hosted.md %} ) used to create the graph.
 
-Hovering your mouse cursor over the graph title will display a tooltip with a description and the [metrics]({% link {{ page.version.version }}/essential-metrics-self-hosted.md %} ) used to create the graph.
+When hovering on graphs, crosshair lines will appear at your mouse pointer. The series' values corresponding to the given time in the cross hairs are displayed in the legend under the graph. Hovering the mouse pointer on a given series displays the corresponding value near the mouse pointer and highlights the series line (graying out other series lines). Click anywhere within the graph to freeze the values in place. Click anywhere within the graph again to cause the values to change with your mouse movements once more.
+
+In the legend, click on an individual series to isolate it on the graph. The other series will be hidden, while the hover will still work. Click the individual series again to make the other series visible. If there are many series, a scrollbar may appear on the right of the legend. This is to limit the size of the legend so that it does not get endlessly large, particularly on clusters with many nodes.