diff --git a/src/current/_data/releases.yml b/src/current/_data/releases.yml index 62bc7e6c4cf..91d89ac7af7 100644 --- a/src/current/_data/releases.yml +++ b/src/current/_data/releases.yml @@ -6948,4 +6948,72 @@ 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.4 + major_version: v24.2 + release_date: '2024-10-17' + release_type: Production + go_version: go1.22.5 + sha: 8140b8e294fb16a293d0aae662bcf5c1d488c852 + 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.3 + 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). + +- release_name: v23.2.13 + major_version: v23.2 + release_date: '2024-10-17' + release_type: Production + go_version: go1.22.5 + sha: f00c152761838e05049d293198840b12605b545b + 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: v23.2.12 + 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/v23.2/v23.2.13.md b/src/current/_includes/releases/v23.2/v23.2.13.md new file mode 100644 index 00000000000..110a5dc9517 --- /dev/null +++ b/src/current/_includes/releases/v23.2/v23.2.13.md @@ -0,0 +1,90 @@ +## v23.2.13 + +Release Date: October 17, 2024 + +{% include releases/new-release-downloads-docker-image.md release=include.release %} + +

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

+ +- The description for the [cluster setting]({% link v23.2/cluster-settings.md %}) `changefeed.sink_io_workers` now lists all [changefeed sinks]({% link v23.2/changefeed-sinks.md %}) that support the setting. [#130372][#130372] +- Network metrics have been added for the following [changefeed sinks]({% link v23.2/changefeed-sinks.md %}): +- Added two network metrics, `changefeed.network.bytes_in` and `changefeed.network.bytes_out`. These metrics track the number of bytes sent by individual [changefeeds]({% link v23.2/change-data-capture-overview.md %}) to the following sinks: + - [Kafka sinks]({% link v23.2/changefeed-sinks.md %}#kafka). If child metrics are enabled, the metric will have a `kafka` label. + - [Webhook sinks]({% link v23.2/changefeed-sinks.md %}#webhook-sink). If child metrics are enabled, the metric will have a `webhook` label. + - [Pub/Sub sinks]({% link v23.2/changefeed-sinks.md %}#google-cloud-pub-sub). If child metrics are enabled, the metric will have a `pubsub` label. + - [SQL sink]({% link v23.2/changefeed-for.md %}). If child metrics are enabled, the metric will have a `sql` label. + + [#130664][#130664] + +- The new [metric]({% link v23.2/metrics.md %}) `changefeed.total_ranges` allows observation of the number of changes that are watched by a changefeed aggregator. It uses the same polling interval as `changefeed.lagging_ranges`, which is controlled by the changefeed option `lagging_ranges_polling_interval`. [#130984][#130984] +- The following groups of [metrics]({% link v23.2/metrics.md %}) and [logs]({% link v23.2/logging.md %}) have been renamed to include the buffer they are associated with. The previous metrics are still maintained for backward compatibility. + - `changefeed.buffer_entries.*` + - `changefeed.buffer_entries_mem.*` + - `changefeed.buffer_pushback_nanos.*` + + [#131417][#131417] +- Added timers and corresponding [metrics]({% link v24.2/metrics.md %} for key parts of the [changefeed]({% link v24.2/change-data-capture-overview.md %}) pipeline to help debug issues with feeds. The `changefeed.stage.{stage}.latency` metrics now emit latency histograms for each stage. The metrics respect the changefeed `scope` label to debug a specific feed. [#131428][#131428] + +

Operational changes

+ +- The new [metric]({% link v23.2/metrics.md %}) `ranges.decommissioning` shows the number of ranges with a replica on a [decommissioning node]({% link v23.2/node-shutdown.md %}). [#130251][#130251] +- The following new [metrics]({% link v23.2/metrics.md %}) show the number of RPC TCP connections established to remote nodes: + - `rpc.connection.connected`: the number of gRPC TCP level connections established to remote nodes. + - `rpc.client.bytes.egress`: the number of TCP bytes sent over gRPC on connections initiated by the cluster. + - `rpc.client.bytes.ingress`: the number of TCP bytes received over gRPC on connections initiated by the cluster. + + [#130521][#130521] +- Added a new configuration parameter, `server.cidr_mapping_url`, which maps IPv4 CIDR blocks to arbitrary tag names. [#130528][#130528] +- The [metrics]({% link v23.2/metrics.md %}) `sql.bytesin` and `sql.bytesout` are now aggregate metrics if child metrics are enabled. [#130528][#130528] +- The following new [metrics]({% link v23.2/metrics.md %}) track the number of bytes sent by an individual [changefeed]({% link v23.2/change-data-capture-overview.md %}) to each sink: + - `changefeed.network.bytes_in` + - `changefeed.network.bytes_out` + + [#130664][#130664] +- You can now set the log format for the `STDERR` changefeed sink using the `format` field in the `stderr` sink section of the [logging]({% link v23.2/logging.md %}) configuration. [#131533][#131533] + +

DB Console changes

+ +- The [DB Console]({% link v24.2/ui-overview.md %}) now shows a notification if the cluster has no [Enterprise license]({% link v24.2/enterprise-licensing.md %}) set. Refer to [upcoming license changes](https://www.cockroachlabs.com/enterprise-license-update/) for more information. [#130425][#130425] + +

Bug fixes

+ +- Fixed a bug where the command `SHOW CLUSTER SETTING FOR VIRTUAL CLUSTER` would erroneously return `NULL` for some settings. [#128782][#128782] +- Fixed a bug where a node could fail to start with the error `could not insert session ...: unexpected value` if an ambiguous result error occurred while inserting data into the `sqlliveness` table. [#130343][#130343] +- Fixed a bug that could prevent [upgrade finalization]({% link v23.2/upgrade-cockroach-version.md %}) due to the upgrade pre-condition for repairing descriptor corruption. [#130519][#130519] +- Fixed a rare bug where a lease transfer could lead to a `side-transport update saw closed timestamp regression` panic. The bug could occur when a node was overloaded and failing to heartbeat its node liveness record. [#130790][#130790] +- Fixed a bug that could result in the erroneous log message `expiration of liveness record ... is not greater than expiration of the previous lease ... after liveness heartbeat`. [#130790][#130790] +- Fixed a bug where queries that are not initiated within a SQL session could fail to respect a statement timeout, including [background jobs]({% link v23.2/show-jobs.md %}), queries issued by the [DB Console]({% link v23.2/ui-overview.md %}) that perform introspection, and the [CockroachDB {{ site.data.products.cloud }} SQL Shell]({% link cockroachcloud/sql-shell.md %}). [#130790][#130790] +- Fixed a bug where a connection could be incorrectly dropped if the client was attempting to change a schema at the same time that the same schema's objects were being dropped. [#130964][#130964] +- Fixed a bug that could cause the following error to be logged when executing a query under [READ COMMITTED]({% link v23.2/read-committed.md %}) isolation if it involved a table with `NOT NULL` virtual columns: `internal error: Non-nullable column ...`. [#131065][#131065] +- Fixed a potential memory leak in [changefeeds]({% link v23.2/change-data-capture-overview.md %}) that use a cloud storage sink. The memory leak could occur if both of the [cluster settings]({% link v23.2/cluster-settings.md %}) `changefeed.fast_gzip.enabled` and `changefeed.cloudstorage.async_flush.enabled` were `true` **and** if the changefeed received an error while attempting to write to the sink. [#130614][#130614] +- Fixed a bug introduced in v23.2.6, where [statistics]({% link v23.2/create-statistics.md %}) forecasting could predict a result of zero rows for a downward-trending statistic when `sql.stats.forecasts.max_decrease` is `false`. The setting is now enabled (set to `1/3` by default). [#131128][#131128] +- Fixed a bug introduced in v23.1 that can cause incorrect results in the following scenario: + 1. The query contains a correlated subquery. + 1. The correlated subquery has a `GroupBy` or `DistinctOn` operator with an outer-column reference in its input. + 1. The correlated subquery is in the input of a `SELECT` or `JOIN` clause that has a filter that sets the outer-column reference equal to an inner column that is in the input of the grouping operator. + 1. The set of grouping columns does not include the replacement column explicitly. + + [#130988][#130988] +- Fixed a bug where [AWS S3 and HTTP client configurations]({% link v23.2/cloud-storage-authentication.md %}) were not considered when implicit authentication was used. [#131201][#131201] +- Fixed a bug that could prevent a [changefeed]({% link v23.2/change-data-capture-overview.md %}) from resuming from a prolonged paused state. [#130919][#130919] + +[#128782]: https://github.com/cockroachdb/cockroach/pull/128782 +[#130251]: https://github.com/cockroachdb/cockroach/pull/130251 +[#130343]: https://github.com/cockroachdb/cockroach/pull/130343 +[#130372]: https://github.com/cockroachdb/cockroach/pull/130372 +[#130425]: https://github.com/cockroachdb/cockroach/pull/130425 +[#130519]: https://github.com/cockroachdb/cockroach/pull/130519 +[#130521]: https://github.com/cockroachdb/cockroach/pull/130521 +[#130528]: https://github.com/cockroachdb/cockroach/pull/130528 +[#130614]: https://github.com/cockroachdb/cockroach/pull/130614 +[#130664]: https://github.com/cockroachdb/cockroach/pull/130664 +[#130790]: https://github.com/cockroachdb/cockroach/pull/130790 +[#130919]: https://github.com/cockroachdb/cockroach/pull/130919 +[#130988]: https://github.com/cockroachdb/cockroach/pull/130988 +[#131065]: https://github.com/cockroachdb/cockroach/pull/131065 +[#131128]: https://github.com/cockroachdb/cockroach/pull/131128 +[#131201]: https://github.com/cockroachdb/cockroach/pull/131201 +[#131417]: https://github.com/cockroachdb/cockroach/pull/131417 +[#131428]: https://github.com/cockroachdb/cockroach/pull/131428 +[#131533]: https://github.com/cockroachdb/cockroach/pull/131533 diff --git a/src/current/_includes/releases/v24.2/v24.2.4.md b/src/current/_includes/releases/v24.2/v24.2.4.md new file mode 100644 index 00000000000..f3c30e54ed6 --- /dev/null +++ b/src/current/_includes/releases/v24.2/v24.2.4.md @@ -0,0 +1,94 @@ +## v24.2.4 + +Release Date: October 17, 2024 + +{% include releases/new-release-downloads-docker-image.md release=include.release %} + +

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

+ +- Updated the cluster setting [`changefeed.sink_io_workers`]({% link v24.2/cluster-settings.md %}#setting-changefeed-sink-io-workers) with all the [changefeed sinks]({% link v24.1/changefeed-sinks.md %}) that support the setting. [#130374][#130374] +- Added two network metrics, `changefeed.network.bytes_in` and `changefeed.network.bytes_out`. [#130578][#130578] + These metrics track the number of bytes sent by individual [changefeeds]({% link v24.2/change-data-capture-overview.md %}) to the following sinks: + - [Kafka sinks]({% link v24.2/changefeed-sinks.md %}#kafka). If [child metrics are enabled]({% link v24.2/cluster-settings.md %}#setting-server-child-metrics-enabled), the metric will have a `kafka` label. + - [Webhook sinks]({% link v24.2/changefeed-sinks.md %}#webhook-sink). If child metrics are enabled, the metric will have a `webhook` label. + - [Pub/Sub sinks]({% link v24.2/changefeed-sinks.md %}#google-cloud-pub-sub). If child metrics are enabled, the metric will have a `pubsub` label. + - [SQL sink]({% link v24.2/changefeed-for.md %}). If child metrics are enabled, the metric will have a `sql` label. +- Added a `changefeed.total_ranges` metric that can be used to monitor the number of ranges that are watched by [changefeed]({% link v24.2/change-data-capture-overview.md %}) aggregators. It shares the same polling interval as `changefeed.lagging_ranges`, which is controlled by the existing `lagging_ranges_polling_interval` option. [#130982][#130982] +- Disambiguated [metrics]({% link v24.2/essential-metrics-self-hosted.md %}) and [logs]({% link v24.2/logging-overview.md %}) for the two buffers used by the KV feed. The following metrics now have a suffix indicating which buffer they correspond to: `changefeed.buffer_entries.*`, `changefeed.buffer_entries_mem.*`, or `changefeed.buffer_pushback_nanos.*`. The previous metric names are retained for backward compatibility. [#131419][#131419] +- Added timers and corresponding [metrics]({% link v24.2/metrics.md %} for key parts of the [changefeed]({% link v24.2/change-data-capture-overview.md %}) pipeline to help debug issues with feeds. The `changefeed.stage.{stage}.latency` metrics now emit latency histograms for each stage. The metrics respect the changefeed `scope` label to debug a specific feed. [#131372][#131372] + +

SQL language changes

+ +- The [session variable]({% link v24.2/set-vars.md %}) `enforce_home_region_follower_reads_enabled` is now deprecated, in favor of `enforce_home_region`. The deprecated variable will be removed in a future release. [#129587][#129587] + +

Operational changes

+ +- Added the new [metric]({% link v24.2/metrics.md %}) `ranges.decommissioning` to show the number of ranges that have a replica on a [decommissioning node]({% link v24.2/node-shutdown.md %}?filters=decommission). [#130247][#130247] +- You can now configure the log format for the [`stderr` log sink]({% link v24.2/configure-logs.md %}#output-to-stderr) by setting the `stderr.format` field in the [YAML configuration]({% link v24.2/configure-logs.md %}#yaml-payload). [#131539][#131539] + +

DB Console changes

+ +- Streamlined [metric chart]({% link v24.2/ui-overview.md %}#metrics) legends by removing the name of the chart from labels, where it was an identical prefix for all labels on the chart. [#129359][#129359] +- The [DB Console]({% link v24.2/ui-overview.md %}) now shows a notification if the cluster has no [Enterprise license]({% link v24.2/enterprise-licensing.md %}) set. Refer to [upcoming license changes](https://www.cockroachlabs.com/enterprise-license-update/) for more information. [#130417][#130417] + +

Bug fixes

+ +- Fixed a bug that could prevent [upgrade finalization]({% link v24.2/upgrade-cockroach-version.md %}) when attempting to resolve a large number of corrupt descriptors. [#130517][#130517] +- Fixed a potential memory leak in [changefeeds]({% link v24.2/change-data-capture-overview.md %}) using a [cloud storage sink]({% link v24.2/changefeed-sinks.md %}#cloud-storage-sink). The memory leak could occur if both [`changefeed.fast_gzip.enabled`]({% link v24.2/cluster-settings.md %}#setting-changefeed-fast-gzip-enabled) and `changefeed.cloudstorage.async_flush.enabled` were `true`, and the changefeed received an error while attempting to write to the cloud storage sink. [#130602][#130602] +- Fixed a bug where zone configuration changes issued by the [declarative schema changer]({% link v24.2/online-schema-changes.md %}#declarative-schema-changer) were not blocked if a table had `schema_locked` set. [#130705][#130705] +- Fixed a bug in which some [`SELECT FOR UPDATE`]({% link v24.2/select-for-update.md %}) or [`SELECT FOR SHARE`]({% link v24.2/select-for-update.md %}) queries using `NOWAIT` could still block on locked rows when using the `optimizer_use_lock_op_for_serializable` [session setting]({% link v24.2/session-variables.md %}) under [`SERIALIZABLE`]({% link v24.2/demo-serializable.md %}) isolation. This bug was introduced with [`optimizer_use_lock_op_for_serializable`]({% link v24.2/session-variables.md %}#optimizer-use-lock-op-for-serializable) in v23.2.0. [#130430][#130430] +- Fixed a bug that caused the [optimizer]({% link v24.2/cost-based-optimizer.md %}) to plan unnecessary post-query uniqueness checks during [`INSERT`]({% link v24.2/insert.md %}), [`UPSERT`]({% link v24.2/upsert.md %}), and [`UPDATE`]({% link v24.2/update.md %}) statements on tables with [partial]({% link v24.2/partial-indexes.md %}), [unique]({% link v24.2/create-index.md %}#unique-indexes) [hash-sharded indexes]({% link v24.2/hash-sharded-indexes.md %}). These unnecessary checks added overhead to execution of these statements, and caused the statements to error when executed under [`READ COMMITTED`]({% link v24.2/read-committed.md %}) isolation. [#130570][#130570] +- Fixed a bug that could result in the inability to garbage collect an [MVCC]({% link v24.2/architecture/storage-layer.md %}#mvcc) range tombstone within a [global table]({% link v24.2/global-tables.md %}). [#130940][#130940] +- Fixed a bug where a connection could be dropped if the client was attempting a [schema change]({% link v24.2/online-schema-changes.md %}) while the same schema objects were being dropped. [#130962][#130962] +- Fixed a bug introduced in v23.2 where the [`IS NOT NULL`]({% link v24.2/null-handling.md %}#nulls-and-simple-comparisons) clause would incorrectly allow tuples containing `NULL` elements, e.g. `(1, NULL)` or `(NULL, NULL)`. [#130947][#130947] +- Fixed a bug that could cause errors with the message `internal error: Non-nullable column ...` when executing statements under [`READ COMMITTED`]({% link v24.2/read-committed.md %}) isolation that involved tables with [`NOT NULL`]({% link v24.2/not-null.md %}) [virtual columns]({% link v24.2/computed-columns.md %}). [#131019][#131019] +- Fixed a bug where [AWS S3 and HTTP client configurations]({% link v24.2/use-cloud-storage.md %}) were not considered when implicit authentication was used. [#131173][#131173] +- Fixed a bug introduced in v23.1 that can cause incorrect query results under the following conditions: + 1. The query contains a correlated subquery. + 1. The correlated subquery has a `GroupBy` or `DistinctOn` operator with an outer-column reference in its input. + 1. The correlated subquery is in the input of a `SELECT` or `JOIN` clause that has a filter that sets the outer-column reference equal to an inner column that is in the input of the grouping operator. + 1. The set of grouping columns does not include the replacement column explicitly. + + [#130990][#130990] +- Fixed a bug where jobs created in a session with a timezone offset configured could fail to start or could report an incorrect creation time in the output of [`SHOW JOBS`]({% link v24.2/show-jobs.md %}) and in the [DB Console]({% link v24.2/ui-overview.md %}). [#131407][#131407] +- Fixed a bug that could prevent a [changefeed]({% link v24.2/change-data-capture-overview.md %}) from resuming after a prolonged [paused state]({% link v24.2/create-and-configure-changefeeds.md %}#pause). [#130921][#130921] + +

Performance improvements

+ +- The [query optimizer]({% link v24.2/cost-based-optimizer.md %}) now plans limited [partial index]({% link v24.2/partial-indexes.md %}) scans in more cases when the new [session variable]({% link v24.2/session-variables.md %}) `optimizer_push_limit_into_project_filtered_scan` is set to `on`. [#130335][#130335] +- Reduced the write-amplification impact of rebalances by splitting snapshot [SST files]({% link v24.2/architecture/storage-layer.md %}#pebble) before ingesting them into [Pebble]({% link v24.2/architecture/storage-layer.md %}#ssts). [#128997][#128997] + +[#128997]: https://github.com/cockroachdb/cockroach/pull/128997 +[#129359]: https://github.com/cockroachdb/cockroach/pull/129359 +[#129587]: https://github.com/cockroachdb/cockroach/pull/129587 +[#130247]: https://github.com/cockroachdb/cockroach/pull/130247 +[#130335]: https://github.com/cockroachdb/cockroach/pull/130335 +[#130374]: https://github.com/cockroachdb/cockroach/pull/130374 +[#130417]: https://github.com/cockroachdb/cockroach/pull/130417 +[#130430]: https://github.com/cockroachdb/cockroach/pull/130430 +[#130517]: https://github.com/cockroachdb/cockroach/pull/130517 +[#130570]: https://github.com/cockroachdb/cockroach/pull/130570 +[#130578]: https://github.com/cockroachdb/cockroach/pull/130578 +[#130602]: https://github.com/cockroachdb/cockroach/pull/130602 +[#130673]: https://github.com/cockroachdb/cockroach/pull/130673 +[#130676]: https://github.com/cockroachdb/cockroach/pull/130676 +[#130705]: https://github.com/cockroachdb/cockroach/pull/130705 +[#130921]: https://github.com/cockroachdb/cockroach/pull/130921 +[#130935]: https://github.com/cockroachdb/cockroach/pull/130935 +[#130940]: https://github.com/cockroachdb/cockroach/pull/130940 +[#130947]: https://github.com/cockroachdb/cockroach/pull/130947 +[#130962]: https://github.com/cockroachdb/cockroach/pull/130962 +[#130982]: https://github.com/cockroachdb/cockroach/pull/130982 +[#130990]: https://github.com/cockroachdb/cockroach/pull/130990 +[#131019]: https://github.com/cockroachdb/cockroach/pull/131019 +[#131173]: https://github.com/cockroachdb/cockroach/pull/131173 +[#131199]: https://github.com/cockroachdb/cockroach/pull/131199 +[#131210]: https://github.com/cockroachdb/cockroach/pull/131210 +[#131239]: https://github.com/cockroachdb/cockroach/pull/131239 +[#131311]: https://github.com/cockroachdb/cockroach/pull/131311 +[#131372]: https://github.com/cockroachdb/cockroach/pull/131372 +[#131391]: https://github.com/cockroachdb/cockroach/pull/131391 +[#131407]: https://github.com/cockroachdb/cockroach/pull/131407 +[#131419]: https://github.com/cockroachdb/cockroach/pull/131419 +[#131539]: https://github.com/cockroachdb/cockroach/pull/131539 +[#131619]: https://github.com/cockroachdb/cockroach/pull/131619