Skip to content

Commit fc43d7d

Browse files
release-notes-automation[bot]release-notes-automation[bot]
authored
Release Notes for v25.3-v25.3.0-alpha.2 (#19782)
1 parent 665aecb commit fc43d7d

File tree

2 files changed

+104
-0
lines changed

2 files changed

+104
-0
lines changed

‎src/current/_data/releases.yml

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8743,3 +8743,31 @@
87438743
docker_arm_experimental: false
87448744
docker_arm_limited_access: false
87458745
source: true
8746+
8747+
8748+
- release_name: v25.3.0-alpha.2
8749+
major_version: v25.3
8750+
release_date: '2025-06-16'
8751+
release_type: Testing
8752+
go_version: go1.23.7
8753+
sha: 5ccd93e6229fab8737eb2991f3116faa58ea1aec
8754+
has_sql_only: true
8755+
has_sha256sum: true
8756+
mac:
8757+
mac_arm: true
8758+
mac_arm_experimental: true
8759+
mac_arm_limited_access: false
8760+
windows: true
8761+
linux:
8762+
linux_arm: true
8763+
linux_arm_experimental: false
8764+
linux_arm_limited_access: false
8765+
linux_intel_fips: true
8766+
linux_arm_fips: false
8767+
docker:
8768+
docker_image: cockroachdb/cockroach-unstable
8769+
docker_arm: true
8770+
docker_arm_experimental: false
8771+
docker_arm_limited_access: false
8772+
source: true
8773+
previous_release: v25.3.0-alpha.1

‎src/current/_includes/releases/v25.3/v25.3.0-alpha.2.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
## v25.3.0-alpha.2
2+
3+
Release Date: June 16, 2025
4+
5+
{% include releases/new-release-downloads-docker-image.md release=include.release %}
6+
7+
<h3 id="v25-3-0-alpha-2-general-changes">General changes</h3>
8+
9+
- Changefeed source metadata now includes the `crdb_internal_table_id` field, enabling downstream consumers to uniquely identify tables even if table names change.
10+
[#147341][#147341]
11+
- Changefeeds emitting to Kafka sinks that were created in CockroachDB v24.2.1+, or v23.2.10+ and v24.1.4+ with the `changefeed.new_kafka_sink.enabled` cluster setting enabled now include the message key, size, and MVCC timestamp in message too large error logs.
12+
[#147543][#147543]
13+
14+
<h3 id="v25-3-0-alpha-2-sql-language-changes">SQL language changes</h3>
15+
16+
- Added support for query tagging, which allows users to add query tags to their SQL statements via comments. These query tags are included in:
17+
- All log entries generated during the execution of a SQL statement and are prefixed by `querytag-`.
18+
- Traces and are prefixed by `querytag-`.
19+
- In the `crdb_internal.cluster_execution_insights` and `crdb_internal.node_execution_insights` virtual tables in a new `query_tags` JSONB column.
20+
This feature is disabled by default and can be enabled using the `sql.sqlcommenter.enabled` cluster setting. Comments must follow the [SQLCommenter specification](https://google.github.io/sqlcommenter/spec/). [#145435][#145435]
21+
- Added a session variable `initial_retry_backoff_for_read_committed` that controls the initial backoff duration when retrying an individual statement in an explicit `READ COMMITTED` transaction. A duration of `0` disables exponential backoff. If a statement in an explicit `READ COMMITTED` transaction is failing with the `40001` error `ERROR: restart transaction: read committed retry limit exceeded; set by max_retries_for_read_committed=...`, then you should set `initial_retry_backoff_for_read_committed` to a duration proportional to the typical execution time of the statement (in addition to also increasing `max_retries_for_read_committed`). [#146860][#146860]
22+
- Added the `SHOW CREATE ALL ROUTINES` statement, which can be used to show `CREATE` statements for all user-defined functions (UDFs) and procedures in the current database.
23+
[#147452][#147452]
24+
- Added the metrics `sql.txn.auto_retry.count` and `sql.statements.auto_retry.count`, which count the number of automatic retries of SQL transactions and statements, respectively, within the database. These metrics differ from the related `txn.restarts.*` metrics, which count retryable errors emitted by the KV layer that must be retried. The new `sql.txn.auto_retry.count` and `sql.statements.auto_retry.count` metrics count auto-retry actions taken by the SQL layer in response to some of those retryable errors.
25+
[#147682][#147682]
26+
- Increased the default value for the `max_retries_for_read_committed` session variable from `10` to `100`. Testing has shown that some high-contention workloads running under `READ COMMITTED` isolation benefit from more statement retries. [#147869][#147869]
27+
- The session variable `initial_retry_backoff_for_read_committed` now defaults to `2` (milliseconds). Testing has shown that some high-contention workloads running under `READ COMMITTED` isolation benefit from exponential backoff. `2` might be too quick of an initial backoff for longer-running statements, but setting this value much higher than the normal duration of execution will cause excessive delay. [#147869][#147869]
28+
29+
<h3 id="v25-3-0-alpha-2-operational-changes">Operational changes</h3>
30+
31+
- Added an `alter_changefeed` structured log event to provide more visibility into when an `ALTER CHANGEFEED` event occurred and what changed.
32+
[#147679][#147679]
33+
- Added new timeseries metrics to the `storage.value_separation.*` namespace for observing the behavior of storage engine value separation.
34+
[#147728][#147728]
35+
36+
<h3 id="v25-3-0-alpha-2-db-console-changes">DB Console changes</h3>
37+
38+
- The Hot Ranges page node filter has been moved out of the main filter container and now filters nodes on the backend to reduce load time.
39+
[#147089][#147089]
40+
- The Insights page in the DB Console now displays SQL commenter query tags for statement executions. These tags provide application context (such as application name, user ID, or feature flags) embedded in SQL comments using the `sqlcommenter` format. This information can help correlate slow query performance with specific application states. The Query Tags column is available in the Statement Executions view's Statement Insights table, but it is hidden by default. To display it, use the Columns selector.
41+
[#147439][#147439]
42+
- Retry counts for statements executing under `READ COMMITTED` isolation are now more accurate.
43+
[#147682][#147682]
44+
45+
<h3 id="v25-3-0-alpha-2-bug-fixes">Bug fixes</h3>
46+
47+
- Fixed an issue where self-referencing triggers did not have their dependencies properly recorded, which could lead to broken dependencies. [#147018][#147018]
48+
- Fixed a security issue where optimizer predicate reordering could leak information about hidden rows protected by row-level security (RLS) policies. [#147348][#147348]
49+
- Fixed a bug on the SQL Activity Statements and Transactions pages where the time picker failed to support sub-hour time ranges when `sql.stats.aggregation.interval` was set to a value under 1 hour. Previously, selecting a short time window (e.g., 10 minutes) would query for a full hour of data. This fix ensures that the selected time range is respected, enabling more precise analysis of recent activity. [#147447][#147447]
50+
- `FUNCTION` and `PROCEDURE` are now shown via `\h SHOW CREATE` in the CLI doc. [#147666][#147666]
51+
- Fixed a bug where functions lost their row-level security (RLS) policy backreferences, leading to schema change failures. [#147696][#147696]
52+
- Fixed a bug where `ALTER TABLE` was modifying identity attributes on columns not backed by a sequence. [#147698][#147698]
53+
- Fixed an error in `crdb_internal.table_spans` when a table's schema had been dropped. [#147766][#147766]
54+
- Fixed a bug where introspection queries (e.g., querying the `crdb_internal` system catalog) could fail if a dropped constraint referenced a column that was also being dropped. [#147773][#147773]
55+
- Fixed a bug where adding multiple columns in a single statement with `AddGeometryColumn` would cause runtime errors. [#147998][#147998]
56+
57+
[#147018]: https://github.com/cockroachdb/cockroach/pull/147018
58+
[#147348]: https://github.com/cockroachdb/cockroach/pull/147348
59+
[#147447]: https://github.com/cockroachdb/cockroach/pull/147447
60+
[#147543]: https://github.com/cockroachdb/cockroach/pull/147543
61+
[#146860]: https://github.com/cockroachdb/cockroach/pull/146860
62+
[#147682]: https://github.com/cockroachdb/cockroach/pull/147682
63+
[#147679]: https://github.com/cockroachdb/cockroach/pull/147679
64+
[#147089]: https://github.com/cockroachdb/cockroach/pull/147089
65+
[#147666]: https://github.com/cockroachdb/cockroach/pull/147666
66+
[#147698]: https://github.com/cockroachdb/cockroach/pull/147698
67+
[#147773]: https://github.com/cockroachdb/cockroach/pull/147773
68+
[#147998]: https://github.com/cockroachdb/cockroach/pull/147998
69+
[#145435]: https://github.com/cockroachdb/cockroach/pull/145435
70+
[#147452]: https://github.com/cockroachdb/cockroach/pull/147452
71+
[#147869]: https://github.com/cockroachdb/cockroach/pull/147869
72+
[#147766]: https://github.com/cockroachdb/cockroach/pull/147766
73+
[#147439]: https://github.com/cockroachdb/cockroach/pull/147439
74+
[#147341]: https://github.com/cockroachdb/cockroach/pull/147341
75+
[#147728]: https://github.com/cockroachdb/cockroach/pull/147728
76+
[#147696]: https://github.com/cockroachdb/cockroach/pull/147696

0 commit comments

Comments
 (0)