From 690649b610ea2f7167dac9fe6e0d17d5bcca2690 Mon Sep 17 00:00:00 2001 From: Rich Loveland Date: Thu, 6 Feb 2025 15:44:58 -0500 Subject: [PATCH] Add release notes for v24.2.10 (#19349) Fixes REL-1967 --- src/current/_data/releases.yml | 36 +++++++++++- .../_includes/releases/v24.2/v24.2.10.md | 57 +++++++++++++++++++ 2 files changed, 92 insertions(+), 1 deletion(-) create mode 100644 src/current/_includes/releases/v24.2/v24.2.10.md diff --git a/src/current/_data/releases.yml b/src/current/_data/releases.yml index 6261d0937a6..6e39e7e24a0 100644 --- a/src/current/_data/releases.yml +++ b/src/current/_data/releases.yml @@ -8165,4 +8165,38 @@ This version is currently available only for select CockroachDB Cloud clusters. To request to upgrade a CockroachDB self-hosted cluster to this version, - [contact support](https://support.cockroachlabs.com/hc/requests/new). \ No newline at end of file + [contact support](https://support.cockroachlabs.com/hc/requests/new). + +- release_name: v24.2.10 + major_version: v24.2 + release_date: '2025-02-06' + release_type: Production + go_version: go1.22.8 + sha: 046116ac37efed5175dd59aaaadf91d1f7c12010 + 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 + docker_arm: true + docker_arm_experimental: false + docker_arm_limited_access: false + source: true + previous_release: v24.2.9 + cloud_only: true + cloud_only_message_short: 'Available only for select CockroachDB Cloud clusters' + cloud_only_message: > + This version is currently available only for select + CockroachDB Cloud clusters. To request to upgrade + a CockroachDB self-hosted cluster to this version, + [contact support](https://support.cockroachlabs.com/hc/requests/new). diff --git a/src/current/_includes/releases/v24.2/v24.2.10.md b/src/current/_includes/releases/v24.2/v24.2.10.md new file mode 100644 index 00000000000..808bc82fd58 --- /dev/null +++ b/src/current/_includes/releases/v24.2/v24.2.10.md @@ -0,0 +1,57 @@ +## v24.2.10 + +Release Date: February 6, 2025 + +{% include releases/new-release-downloads-docker-image.md release=include.release %} + +

General changes

+ +- The protected timestamp (PTS) records of running changefeeds are now updated when the set of targets changes, such as when system tables are added to the protected tables list. [#138653][#138653] + +

SQL language changes

+ +- The `legacy_varchar_typing` session setting has been added, which reverts the changes of [#133037][#133037] that cause the change in typing behavior described in [#137837][#137837]. Specifically, it makes type-checking and overload resolution ignore the newly added "unpreferred" overloads. This setting defaults to `on`. [#138002][#138002] +- Since v23.2 table statistics histograms had been collected for non-indexed JSON columns. Histograms are no longer collected for these columns if the `sql.stats.non_indexed_json_histograms.enabled` cluster setting is set to `false`. This reduces memory usage during table statistics collection, for both automatic and manual collection via `ANALYZE` and `CREATE STATISTICS`. [#140267][#140267] +- Added support for a new index hint, `AVOID_FULL_SCAN`, which will prevent the optimizer from planning a full scan for the specified table if any other plan is possible. The hint can be used in the same way as other existing index hints. For example, `SELECT * FROM table_name@{AVOID_FULL_SCAN};`. This hint is similar to `NO_FULL_SCAN`, but will not error if a full scan cannot be avoided. Note that normally a full scan of a partial index would not be considered a "full scan" for the purposes of the `NO_FULL_SCAN` and `AVOID_FULL_SCAN` hints, but if the user has explicitly forced the partial index via `FORCE_INDEX=index_name`, CockroachDB does consider it a full scan. [#140271][#140271] +- Added the `optimizer_prefer_bounded_cardinality` session setting, which instructs the optimizer to prefer query plans where every expression has a guaranteed upper-bound on the number of rows it will process. This may help the optimizer produce better query plans in some cases. This setting is disabled by default. [#140271][#140271] +- Added the `optimizer_min_row_count` session setting, which sets a lower bound on row count estimates for relational expressions during query planning. A value of `0`, which is the default, indicates no lower bound. Note that if this is set to a value greater than `0`, a row count of zero can still be estimated for expressions with a cardinality of zero, e.g., for a contradictory filter. Setting this to a value higher than `0`, such as `1`, may yield better query plans in some cases, such as when statistics are frequently stale and inaccurate. [#140271][#140271] + +

Operational changes

+ +- Schema object identifiers (e.g., database names, schema names, table names, function names, and type names) are no longer redacted when logging statements in the `EXEC` or `SQL_SCHEMA` log channels. If redaction of these names is required, then the new cluster setting `sql.log.redact_names.enabled` can be set to `true`. The default value of the setting is `false`. [#138656][#138656] +- Added a metric, `sql.schema_changer.object_count`, that keeps track of the count of schema objects in the cluster. [#138838][#138838] +- The `changefeed.max_behind_nanos` metric now supports scoping with metrics labels. [#139233][#139233] + +

Bug fixes

+ +- `CLOSE CURSOR` statements are now allowed in read-only transactions, similar to PostgreSQL. This bug had been present since at least v23.1. [#137791][#137791] +- `ALTER BACKUP SCHEDULE` no longer fails on schedules whose collection URI contains a space. [#138081][#138081] +- Previously, `SHOW CREATE TABLE` was showing incorrect data with regard to inverted indexes. It now shows the correct data in a format that can be repeatedly entered back into CockroachDB to recreate the same table. [#138084][#138084] +- Fixed a timing issue between `ALTER VIEW .. RENAME` and `DROP VIEW` that caused repeated failures in the `DROP VIEW` job. [#137888][#137888] +- Fixed a bug where querying the `pg_catalog.pg_constraint` table while the schema changer was dropping a constraint could result in a query error. [#138284][#138284] +- Queries that perform a cast from the string representation of an array containing `GEOMETRY` or `GEOGRAPHY` types to a SQL `ARRAY` type will now succeed. [#138694][#138694] +- Fixed a bug where secondary tenants could fatal when issuing HTTP requests during tenant startup. [#138754][#138754] +- Fixed a bug where CockroachDB could encounter an internal error `comparison of two different versions of enum` in some cases when a user-defined type was modified within a transaction and subsequent statements read the column of that user-defined type. The bug was introduced in v24.2. [#138053][#138053] +- When the session variable `allow_role_memberships_to_change_during_transaction` is set, it is now possible to create and drop users quickly even when there are contending transactions on the `system.users` and `system.role_options` system tables. [#139031][#139031] +- Fixed a bug where the error `batch timestamp ... must be after replica GC threshold` could occur during a schema change backfill operation, and cause the schema change job to retry infinitely. Now this error is treated as permanent, and will cause the job to enter the `failed` state. [#139249][#139249] + +[#137791]: https://github.com/cockroachdb/cockroach/pull/137791 +[#137888]: https://github.com/cockroachdb/cockroach/pull/137888 +[#138002]: https://github.com/cockroachdb/cockroach/pull/138002 +[#138053]: https://github.com/cockroachdb/cockroach/pull/138053 +[#138081]: https://github.com/cockroachdb/cockroach/pull/138081 +[#138084]: https://github.com/cockroachdb/cockroach/pull/138084 +[#138284]: https://github.com/cockroachdb/cockroach/pull/138284 +[#138653]: https://github.com/cockroachdb/cockroach/pull/138653 +[#138656]: https://github.com/cockroachdb/cockroach/pull/138656 +[#138694]: https://github.com/cockroachdb/cockroach/pull/138694 +[#138754]: https://github.com/cockroachdb/cockroach/pull/138754 +[#138838]: https://github.com/cockroachdb/cockroach/pull/138838 +[#138983]: https://github.com/cockroachdb/cockroach/pull/138983 +[#139031]: https://github.com/cockroachdb/cockroach/pull/139031 +[#139233]: https://github.com/cockroachdb/cockroach/pull/139233 +[#139249]: https://github.com/cockroachdb/cockroach/pull/139249 +[#140267]: https://github.com/cockroachdb/cockroach/pull/140267 +[#140271]: https://github.com/cockroachdb/cockroach/pull/140271 +[#133037]: https://github.com/cockroachdb/cockroach/pull/133037 +[#137837]: https://github.com/cockroachdb/cockroach/pull/137837