Skip to content

Commit

Permalink
Merge pull request #19382 from cockroachdb/v25.1.0-ga
Browse files Browse the repository at this point in the history
V25.1.0 ga
  • Loading branch information
shannonbradshaw authored Feb 18, 2025
2 parents 67a0093 + 3cece74 commit 63f1a4d
Show file tree
Hide file tree
Showing 17 changed files with 284 additions and 254 deletions.
4 changes: 2 additions & 2 deletions src/current/_config_cockroachdb.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
baseurl: /docs
current_cloud_version: v24.3
current_cloud_version: v25.1
destination: _site/docs
homepage_title: CockroachDB Docs
versions:
stable: v24.3
stable: v25.1
dev: v25.1
34 changes: 34 additions & 0 deletions src/current/_data/releases.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8199,3 +8199,37 @@
docker_arm_limited_access: false
source: true
previous_release: v25.1.0-beta.3

- release_name: v25.1.0
major_version: v25.1
release_date: '2025-02-18'
release_type: Production
go_version: go1.22.8
sha:
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: v25.1.0-rc.1
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).
2 changes: 1 addition & 1 deletion src/current/_data/versions.csv
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,4 @@ v23.2,2024-02-05,2025-02-05,2025-08-05,23.2.6,23.2.7,2024-07-08,2025-07-08,2026-
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
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
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
v25.1,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1
v25.1,2025-02-18,2026-02-18,2026-08-18,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1
35 changes: 29 additions & 6 deletions src/current/_includes/releases/v25.1/backward-incompatible.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,33 @@
Before [upgrading to CockroachDB v24.3]({% link v24.3/upgrade-cockroach-version.md %}), be sure to review the following backward-incompatible changes, as well as [key cluster setting changes](#v24-3-0-cluster-settings), and adjust your deployment as necessary.
Before [upgrading to CockroachDB v25.1]({% link v25.1/upgrade-cockroach-version.md %}), be sure to review the following backward-incompatible changes, as well as [key cluster setting changes](#v25-1-0-cluster-settings), and adjust your deployment as necessary.

If you plan to upgrade to v24.3 directly from v24.1 and skip v24.2, be sure to also review the [v24.2 release notes]({% link releases/v24.2.md %}) for backward-incompatible changes from v24.1.
- The old `BACKUP TO`, `RESTORE FROM <collectionURI>`, and `SHOW BACKUP IN <collectionURI>` syntaxes are now fully deprecated and no longer usable. [#133610][#133610]

- Upgrading to v24.3 is blocked if no [license]({% link v24.3/licensing-faqs.md %}) is installed, or if a trial/free license is installed with telemetry disabled. [#130576][#130576]
- Altering a paused backup schedule's recurrence or location no longer resumes the schedule. [#134829][#134829]

[#130576]: https://github.com/cockroachdb/cockroach/pull/130576
- `BACKUP`/`RESTORE` statements no longer return index entries and bytes backed up/restored. [#134516][#134516]

{% comment %}Remove this anchor when it is added to the v24.3.0 GA release notes{% endcomment %}
<a id="v24-3-0-cluster-settings"></a>
- Introduced the `legacy_varchar_typing` session setting. If `on`, type checking and overload resolution for VARCHAR types ignore overloads that cause errors, allowing comparisons between VARCHAR and non-STRING-like placeholder values to execute successfully. If `off`, type checking of these comparisons is more strict and must be handled with explicit type casts. As of v25.1.0 this setting defaults to `off`. [#137844][#137844]

- Several metrics are redundant and have been removed. The following list maps each removed metric to an existing, identical metric. [#138786][#138786]
- Removed `sql.schema_changer.running`, which is redundant with `jobs.schema_change.currently_running`.
- Removed `sql.schema_changer.successes`, which is redundant with `jobs.schema_change.resume_completed`.
- Removed `sql.schema_changer.retry_errors`, which is redundant with `jobs.schema_change.resume_retry_error`.
- Removed `sql.schema_changer.permanent_errors`, which is redundant with `jobs.schema_change.resume_failed`.

- The default value of the `autocommit_before_ddl` session variable is now `true`. This will cause any schema change statement that is sent during a transaction to make the current transaction commit before executing the schema change in a separate transaction.

This change is being made because CockroachDB does not have full support for multiple schema changes in a transaction, as described [here]({% link v25.1/online-schema-changes.md %}#schema-changes-within-transactions).

Users who do not desire the autocommit behavior can preserve the old behavior by changing the default value of `autocommit_before_ddl` with a command such as:

``` ALTER ROLE ALL SET autocommit_before_ddl = false; ```

[#140156][#140156]


[#133610]: https://github.com/cockroachdb/cockroach/pull/133610
[#134829]: https://github.com/cockroachdb/cockroach/pull/134829
[#134516]: https://github.com/cockroachdb/cockroach/pull/134516
[#137844]: https://github.com/cockroachdb/cockroach/pull/137844
[#138786]: https://github.com/cockroachdb/cockroach/pull/138786
[#140156]: https://github.com/cockroachdb/cockroach/pull/140156
6 changes: 3 additions & 3 deletions src/current/_includes/releases/v25.1/deprecations.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
The following deprecations are announced in v24.3. If you plan to upgrade to v24.3 directly from v24.1 and skip v24.2, be sure to also review the [v24.2 release notes]({% link releases/v24.2.md %}) for deprecations.
The following deprecations are announced in v25.1.

- The session variable [`enforce_home_region_follower_reads_enabled`]({% link v24.3/session-variables.md %}#enforce-home-region-follower-reads-enabled) is now deprecated, and will be removed in a future release. The related session variable [`enforce_home_region`]({% link v24.3/session-variables.md %}#enforce-home-region) is **not** deprecated. [#129024][#129024]
- The old `BACKUP TO`, `RESTORE FROM <collectionURI>`, and `SHOW BACKUP IN <collectionURI>` syntaxes are now fully deprecated and no longer usable. [#133610][#133610]

[#129024]: https://github.com/cockroachdb/cockroach/pull/129024
[#133610]: https://github.com/cockroachdb/cockroach/pull/133610
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,12 @@
<tbody>
<tr>
<td>
<p class="feature-summary">IAM authentication support for Amazon MSK Serverless</p>
<p class="feature-summary">Added a Human-Readable Format for Timestamps</p>
<p class="feature-description">
<a href="https://www.cockroachlabs.com/docs/v24.3/change-data-capture-overview.html">Changefeeds</a> support IAM Authentication with Amazon MSK Serverless clusters (Amazon Managed Streaming for Apache Kafka). This feature is generally available.
<a href="https://www.cockroachlabs.com/docs/v25.1/show-jobs.html#show-changefeed-jobs"><code>SHOW CHANGEFEED JOBS</code></a> output now includes timestamps in a human readable format via a new field called <code>readable_high_water_timestamp</code>. You can still find timestamps in the epoch nanosecond format in the field <code>high_water_timestamp</code>.
</p>
</td>
<td>24.3</td>
<td>25.1</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,16 +15,16 @@
<tbody>
<tr>
<td>
<p class="feature-summary">Free trial on CockroachDB Cloud</p>
<p class="feature-summary">Export Monthly CockroachDB Cloud Invoices as CSV</p>
<p class="feature-description">
New CockroachDB Cloud organizations can benefit from a 30-day free trial that enables you to consume up to $400 worth of free credits. Get started by signing up for <a href="https://cockroachlabs.cloud/signup">CockroachDB Cloud</a>
<a href="https://cockroachlabs.cloud/signup">CockroachDB Cloud</a> now enables you to <a href="https://www.cockroachlabs.com/docs/cockroachcloud/billing-management.html#export-invoices">export your CockroachDB Cloud monthly invoice as a CSV file</a> to share with your team or analyze billing data.
</p>
</td>
<td>All
<sup>&starf;</sup>
</td>
<td class="icon-center">{% include icon-no.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
</tr>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,35 +15,16 @@
<tbody>
<tr>
<td>
<p class="feature-summary">SELECT now supported on PCR standby clusters</p>
<p class="feature-summary">Now Supporting Workload Identify for Azure Blob Storage</p>
<p class="feature-description">
<a href="https://cockroachlabs.com/docs/v24.3/physical-cluster-replication-overview.html">Physical cluster replication (PCR)</a> has been enhanced to support <code>SELECT</code> operations on standby clusters. This enables you to scale read performance by running, for example, non-critical workloads on standby clusters.
CockroachDB now supports Workload Identity for implicit authentication with <a href="https://www.cockroachlabs.com/docs/dev/cloud-storage-authentication?filters=azure#azure-blob-storage-implicit-authentication">Azure Blob Storage</a>.
</p>
</td>
<td>24.3</td>
<td>25.1</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
</tr>
<tr>
<td>
<p class="feature-summary">Logical Data Replication in Preview</p>
<p class="feature-description">
<a href="https://cockroachlabs.com/docs/v24.3/logical-data-replication-overview.html">Logical data replication (LDR)</a> continuously replicates tables between an active source CockroachDB cluster to an active destination CockroachDB cluster. Both source and destination can receive application reads and writes, and participate in bidirectional LDR replication for eventual consistency in the replicating tables.
</p>
<p class="feature-description">
The active-active setup between clusters can provide protection against cluster, datacenter, or region failure while still achieving single-region low latency reads and writes in the individual CockroachDB clusters. Each cluster in an LDR job still benefits individually from multi-active availability with CockroachDB's built-in Raft replication providing data consistency across nodes, zones, and regions.
</p>
<p class="feature-description">
This feature is in Preview.
</p>
</td>
<td>24.3</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
<td class="icon-center">{% include icon-no.html %}</td>
</tr>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
</tr>
</tbody>
</table>
43 changes: 43 additions & 0 deletions src/current/_includes/releases/v25.1/feature-highlights-kv.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
<table>
<thead>
<tr>
<th class="center-align" colspan="1" rowspan="2">Feature</th>
<th class="center-align" colspan="5" rowspan="1">Availability</th>
</tr>
<tr>
<th colspan="1" rowspan="1">Ver.</th>
<th colspan="1" rowspan="1" style="white-space: nowrap;">Self-hosted</th>
<th colspan="1" rowspan="1">Advanced</th>
<th colspan="1" rowspan="1">Standard</th>
<th colspan="1" rowspan="1">Basic</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<p class="feature-summary">Admission Control Available on SQL Writes</p>
<p class="feature-description">
Added support for replication admission control on SQL writes, allowing writes and background cluster operations to be paced to prevent overloading the cluster during node restarts or joins.
</p>
</td>
<td>25.1</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
</tr>
<tr>
<td>
<p class="feature-summary">Improved Leaseholder Management (Preview)</p>
<p class="feature-description">
This release introduces <a href="https://www.cockroachlabs.com/docs/v25.1/architecture/replication-layer#leader-leases">Leader Leases</a> (now in preview) which are a new lease type designed to removes the dependency on node liveness in favor of a distrbuted store liveness fabric, making all nodes and ranges more resilient to node failures and partitions.
</p>
</td>
<td>25.1</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
<td class="icon-center">{% include icon-yes.html %}</td>
</tr>
</tbody>
</table>

This file was deleted.

This file was deleted.

Loading

0 comments on commit 63f1a4d

Please sign in to comment.