V25.1.0 ga

src/current/_config_cockroachdb.yml

@@ -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

src/current/_data/releases.yml

@@ -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).

src/current/_data/versions.csv

@@ -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

src/current/_includes/releases/v25.1/backward-incompatible.md

@@ -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

src/current/_includes/releases/v25.1/deprecations.md

@@ -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

src/current/_includes/releases/v25.1/feature-highlights-change-data-capture.html

@@ -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>

src/current/_includes/releases/v25.1/feature-highlights-cloud.html

@@ -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>

src/current/_includes/releases/v25.1/feature-highlights-disaster-recovery.html

@@ -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>

src/current/_includes/releases/v25.1/feature-highlights-kv.html

@@ -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>