Release Notes for v24.3-v24.3.12 (#19573)

* Update release notes for v24.3-v24.3.12

Co-authored-by: Rich Loveland <[email protected]>

Author: release-notes-automation[bot]

src/current/_data/releases.yml

@@ -9022,4 +9022,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).
+      [contact support](https://support.cockroachlabs.com/hc/requests/new).
+
+- release_name: v24.3.12
+  major_version: v24.3
+  release_date: '2025-04-30'
+  release_type: Production
+  go_version: go1.23.7
+  sha: cde00dd1b97fb000bf2f3479eb0a50bfbb5f8337
+  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.3.11
+  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).

src/current/_data/versions.csv

@@ -15,6 +15,6 @@ v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,202
 v23.2,2024-02-05,2025-02-05,2025-08-05,23.2.6,23.2.7,2024-07-08,2025-07-08,2026-07-08,v23.1,release-23.2,N/A
 v24.1,2024-05-20,2025-05-20,2025-11-20,24.1.5,24.1.6,2024-10-21,2025-10-21,2026-10-21,v23.2,release-24.1,N/A
 v24.2,2024-08-12,2025-02-12,N/A,N/A,N/A,N/A,N/A,N/A,v24.1,release-24.2,2028-08-12
-v24.3,2024-11-18,2025-11-18,2026-05-18,N/A,N/A,N/A,N/A,N/A,v24.2,release-24.3,N/A
+v24.3,2024-11-18,2025-11-18,2026-05-18,24.3.11,24.3.12,2025-05-05,2026-05-05,2027-05-05,v24.2,release-24.3,N/A
 v25.1,2025-02-18,2026-08-18,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1,N/A
 v25.2,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v25.1,release-25.2,N/A

src/current/_includes/releases/v24.3/v24.3.12.md

@@ -0,0 +1,67 @@
+## v24.3.12
+
+Release Date: April 30, 2025
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v24-3-12-general-changes">General changes</h3>
+
+- CockroachDB v24.3.12 and subsequent v24.3 releases are eligible for [long term support (LTS)]({% link releases/release-support-policy.md %}#support-types).
+
+<h3 id="v24-3-12-sql-language-changes">SQL language changes</h3>
+
+- Added the `WITH IGNORE_FOREIGN_KEYS` option to `SHOW CREATE TABLE` which omits foreign key constraints from the output schema. This option is also allowed in `SHOW CREATE VIEW`, but has no effect. It cannot be combined with the `WITH REDACT` option. [#142162][#142162]
+- `EXPLAIN ANALYZE` statements now display the number of transaction retries and time spent retrying, if non-zero, in the plan output. [#142929][#142929]
+- A new `execution time` statistic is now reported on `EXPLAIN ANALYZE` output for most operators. Previously, this statistic was only available on the DistSQL diagrams in `EXPLAIN ANALYZE (DISTSQL)` output. [#143897][#143897]
+
+<h3 id="v24-3-12-operational-changes">Operational changes</h3>
+
+- Added the cluster setting `server.child_metrics.include_aggregate.enabled` (default: `true`) that controls the behavior of Prometheus child metrics reporting (`/_status/vars`). When set to `true`, child metrics include an aggregate time series, maintaining the existing behavior. When set to `false`, it stops reporting the aggregate time series, preventing double counting when querying metrics. [#142745][#142745]
+- The `sys.cpu.host.combined.percent-normalized` metric has been updated to include additional counters for more accurate host CPU measurement and to reduce underreporting. It now accounts for time spent processing hardware (`irq`) and software (`softirq`) interrupts, as well as `nice` time, which represents low-priority user-mode activity. [#142905][#142905]
+- The `server.client_cert_expiration_cache.capacity` cluster setting has been removed. The `security.certificate.expiration.client` and `security.certificate.ttl.client` metrics now report the lowest value observed for a user in the last 24 hours. [#143591][#143591]
+
+<h3 id="v24-3-12-bug-fixes">Bug fixes</h3>
+
+- Fixed a bug in client certificate expiration metrics, `security.certificate.expiration.client` and `security.certificate.ttl.client`. [#142843][#142843]
+- Fast failback could succeed even if the standby cluster protected timestamp had been removed, causing the reverse physical cluster replication (PCR) stream to enter a crashing loop. This patch ensures the failback command fast fails. [#143078][#143078]
+- Fixed a bug that caused changefeeds to fail on startup when scanning a single key. [#143149][#143149]
+- MVCC garbage collection is now fully subject to IO admission control. Previously, it was possible for MVCC GC to cause store overload (such as LSM inversion) when a large amount of data would become eligible for garbage collection. Should any issues arise from subjecting MVCC GC to admission control, the `kv.mvcc_gc.queue_kv_admission_control.enabled` cluster setting can be set to `false` to restore the previous behavior. [#143276][#143276]
+- Fixed a bug where calling a stored procedure could drop the procedure if it had `OUT` parameters that were not used by the calling routine. This bug had existed since PL/pgSQL `CALL` statements were introduced in v24.1. [#143289][#143289]
+- Fixed a bug where CockroachDB would encounter an internal error when decoding the gists of plans with `CALL` statements. The bug had been present since v23.2. [#143314][#143314]
+- The reader virtual cluster now starts if the user begins a physical cluster replication (PCR) stream from a cursor via `ALTER VIRTUAL CLUSTER virtual_cluster START REPLICATION OF virtual_cluster ON pgurl_physical_cluster WITH READ VIRTUAL CLUSTER`. [#143369][#143369]
+- Fixed a crash due to "use of enum metadata before hydration" when using logical data replication (LDR) with user-defined types (UDTs). [#143376][#143376]
+- Fixed a potential deadlock that could occur during client certificate updates while metrics were being collected. This issue affected the reliability of certificate expiration reporting. [#143591][#143591]
+- Fixed a bug in `v24.1.14`, `v24.3.7`, `v24.3.8`, and `v25.1` that could cause a nil-pointer error when a column's default expression contained a volatile expression (like `nextval`) as a UDF argument. [#143636][#143636]
+- Previously, the fields `maximum memory usage` and `max sql temp disk usage` in the `EXPLAIN ANALYZE` output could be under-reported for distributed plans when memory-intensive operations were fully performed on the remote nodes. This is now fixed. The bug existed in v22.1 and later. [#143793][#143793]
+- The ALTER VIRTUAL CLUSTER SET REPLICATION READ VIRTUAL CLUSTER syntax is now supported for adding a reader virtual cluster for an existing PCR standby. [#143905][#143905]
+- Previously, whenever CockroachDB collected a statement bundle when plan-gist-based matching was used, `plan.txt` would be incomplete. This is now fixed. The bug had been present since the introduction of plan-gist-based matching in v23.1, and was partially addressed in v24.2. [#143935][#143935]
+- Fixed a bug where CockroachDB could encounter a `cannot specify timestamp older than ...` error during table statistics collection in some cases (e.g., when the cluster is overloaded). The bug was present since v19.1. [#144017][#144017]
+- Fixed a bug that could cause a stack overflow during execution of a prepared statement that invoked a PL/pgSQL routine with a loop. The bug existed in versions v23.2.22, v24.1.15, v24.3.9, v25.1.2, v25.1.3, and pre-release versions of v25.2 prior to v25.2.0-alpha.3. [#144030][#144030]
+
+<h3 id="v24-3-12-miscellaneous">Miscellaneous</h3>
+
+- Fixed a rare corruption bug that impacts `IMPORT` and materialized views. [#144688][#144688]
+- SQL queries run on the source cluster by logical data replication (LDR) and physical cluster replication (PCR) will account to internal metrics like `sql.statements.active.internal` instead of the metrics like `sql.statements.active` that are used to monitor application workload. [#145115][#145115]
+
+[#144030]: https://github.com/cockroachdb/cockroach/pull/144030
+[#143314]: https://github.com/cockroachdb/cockroach/pull/143314
+[#143905]: https://github.com/cockroachdb/cockroach/pull/143905
+[#142905]: https://github.com/cockroachdb/cockroach/pull/142905
+[#143591]: https://github.com/cockroachdb/cockroach/pull/143591
+[#143276]: https://github.com/cockroachdb/cockroach/pull/143276
+[#143289]: https://github.com/cockroachdb/cockroach/pull/143289
+[#143369]: https://github.com/cockroachdb/cockroach/pull/143369
+[#143793]: https://github.com/cockroachdb/cockroach/pull/143793
+[#142162]: https://github.com/cockroachdb/cockroach/pull/142162
+[#142745]: https://github.com/cockroachdb/cockroach/pull/142745
+[#143935]: https://github.com/cockroachdb/cockroach/pull/143935
+[#144688]: https://github.com/cockroachdb/cockroach/pull/144688
+[#144017]: https://github.com/cockroachdb/cockroach/pull/144017
+[#145115]: https://github.com/cockroachdb/cockroach/pull/145115
+[#142929]: https://github.com/cockroachdb/cockroach/pull/142929
+[#143149]: https://github.com/cockroachdb/cockroach/pull/143149
+[#143078]: https://github.com/cockroachdb/cockroach/pull/143078
+[#143376]: https://github.com/cockroachdb/cockroach/pull/143376
+[#143636]: https://github.com/cockroachdb/cockroach/pull/143636
+[#143897]: https://github.com/cockroachdb/cockroach/pull/143897
+[#142843]: https://github.com/cockroachdb/cockroach/pull/142843