From 4499dd8672703e9c20351fee590ed963d06fb6ae Mon Sep 17 00:00:00 2001 From: Matt Linville Date: Fri, 1 Nov 2024 12:10:16 -0700 Subject: [PATCH] Copyedit --- .../releases/v24.3/v24.3.0-beta.3.md | 61 ++++++++++--------- 1 file changed, 31 insertions(+), 30 deletions(-) diff --git a/src/current/_includes/releases/v24.3/v24.3.0-beta.3.md b/src/current/_includes/releases/v24.3/v24.3.0-beta.3.md index 8caea82df65..25e457e8769 100644 --- a/src/current/_includes/releases/v24.3/v24.3.0-beta.3.md +++ b/src/current/_includes/releases/v24.3/v24.3.0-beta.3.md @@ -6,48 +6,53 @@ Release Date: November 5, 2024

Security updates

-- We add detailed client error messages in case of incorrect service account credentials for ldap authentication and authorization. The error message will be as follows: ``` ERROR: LDAP authentication: error binding as LDAP service user with configured credentials (SQLSTATE 28000) ``` [#133812][#133812] +- Client authentication errors using LDAP now log more details to help with troubleshooting authentication and authorization issues. [#133812][#133812] +~~~ -

{{ site.data.products.enterprise }} edition changes

+

Sql changes

-- Added a timer for inner sink client flushes. Fixed a bug where timers were not correctly registered with the metric system. [#133288][#133288] -- Rows replicated by LDR in immediate mode are now factored into the determination of when to recompute SQL table statistics. Epic: CRDB-40872. [#133591][#133591] +- [Physical Cluster Replication]({% link v24.3/physical-cluster-replication-overview.md %}) reader catalogs now bypass AOST timestamps using the `bypass_pcr_reader_catalog_aos`t session variable, which can be used to modify cluster settings within the reader. [#133876][#133876]

Operational changes

-- The cluster setting kvadmission.flow_controller.token_reset_epoch is an advanced setting that can be used to refill replication admission control v2 tokens. It should only be used after consultation with an expert. [#133294][#133294] -- The goschedstats.always_use_short_sample_period.enabled setting should be set to true for any serious production cluster, to prevent unnecessary queuing in admission control CPU queues. [#133585][#133585] +- 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]

DB Console changes

-- In the v2 database and db details pages, the refresh button tooltip will now include the cache refresh progress when the job is running as well as when the update started. [#133351][#133351] +- In [Database]({% link v24.3/ui-database-page.md %}) and [Database Details]({% link v24.2/ui-database-details-page.md %}) pages, the **Refresh** tooltip now includes details about the progress of cache updates and when the job started. [#133351][#133351]

Bug fixes

-- This commit fixes a bug which causes new connections to fail with the following error after upgrading to v24.2: ``` ERROR: invalid value for parameter "vectorize": "unknown(1)" SQLSTATE: 22023 HINT: Available values: off,on,experimental_always ``` In order to hit this bug, the cluster must have: 1. been on version v21.1 at some point in the past 2. run `SET CLUSTER SETTING sql.defaults.vectorize = 'on';` on v21.1 3. not set sql.defaults.vectorize after upgrading past v21.1 4. upgraded all the way to v24.2 The conditions required for this bug can be detected using: ``` SELECT * FROM system.settings WHERE name = 'sql.defaults.vectorize'; ``` If the value is '1', the following statement should be run to fix it before upgrading to v24.2: ``` RESET CLUSTER SETTING sql.defaults.vectorize; ``` This commit fixes the bug by making '1' a legal value for sql.defaults.vectorize again (mapping to 'on'). [#133371][#133371] -- Previously, CockroachDB could encounter an internal error of the form `interface conversion: coldata.Column is` in an edge case and this is now fixed. The bug is present in versions 22.2.13+, 23.1.9+, 23.2+. [#133762][#133762] -- A bug has been fixed that caused incorrect NOT NULL constraint violation errors on `UPSERT` and `INSERT .. ON CONFLICT .. DO UPDATE` statements when those statements updated an existing row and a subset of columns which did not include a `NOT NULL` column of the table. This bug has been present since at least version 20.1.0. [#133820][#133820] -- A bug has been fixed that caused non-reusable query plans, e.g., plans for DDL and `SHOW ...` statements, to be cached and reused in future executions, possibly causing stale results to be returned. This bug only occurred when `plan_cache_mode` was set to `auto` or `force_generic_plan`, both of which are not currently the default settings. [#133073][#133073] -- Fix an unhandled error that could occur when using `REVOKE ... ON SEQUENCE FROM ... user` on an object that is not a sequence. [#133710][#133710] -- Address a panic inside CREATE TABLE AS if sequence builtin expressions had invalid function overloads. [#133870][#133870] +- 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. -

Miscellaneous

+ To detect this bug, run the following query: -

Sql changes

+ {% include_cached copy-clipboard.html %} + ~~~ sql + SELECT * FROM system.settings WHERE name = 'sql.defaults.vectorize + ~~~ -- Allow PCR reader catalogs to bypass AOST timestamps using the bypass_pcr_reader_catalog_aost session variable, which can, which can be used to modify cluster settings within the reader. [#133876][#133876] + If the command returns `1` instead of `on`, run the following statement before upgrading. -

Changes without release note annotation

- -- [#133472][#133472] [023e9aa7b][023e9aa7b] release-24.3: roachtest: string match for transient errors as a fallback -- [#133472][#133472] [9d3056016][9d3056016] release-24.3: roachtest: string match for transient errors as a fallback -- [#133472][#133472] [a289a1001][a289a1001] release-24.3: roachtest: string match for transient errors as a fallback -- [#133414][#133414] [a4ff6db79][a4ff6db79] release-24.3: producer: export scanning range stats - -

Doc updates

- -{% comment %}Docs team: Please add these manually.{% endcomment %} + {% include_cached copy-clipboard.html %} + ~~~ sql + RESET CLUSTER SETTING sql.defaults.vectorize; + ~~~ + This commit makes `1` a legal value for the setting, which maps 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 the command `CREATE TABLE AS` if sequence builtin expressions had invalid function overloads. [#133870][#133870] [#133073]: https://github.com/cockroachdb/cockroach/pull/133073 @@ -65,7 +70,3 @@ Release Date: November 5, 2024 [#133820]: https://github.com/cockroachdb/cockroach/pull/133820 [#133870]: https://github.com/cockroachdb/cockroach/pull/133870 [#133876]: https://github.com/cockroachdb/cockroach/pull/133876 -[023e9aa7b]: https://github.com/cockroachdb/cockroach/commit/023e9aa7b -[9d3056016]: https://github.com/cockroachdb/cockroach/commit/9d3056016 -[a289a1001]: https://github.com/cockroachdb/cockroach/commit/a289a1001 -[a4ff6db79]: https://github.com/cockroachdb/cockroach/commit/a4ff6db79