v25.2 GA

src/current/_config_cockroachdb.yml

@@ -1,7 +1,7 @@
 baseurl: /docs
-current_cloud_version: v25.1
+current_cloud_version: v25.2
 destination: _site/docs
 homepage_title: CockroachDB Docs
 versions:
-  stable: v25.1
-  dev: v25.2
+  stable: v25.2
+  dev: v25.2

src/current/_data/releases.yml

@@ -9071,13 +9071,12 @@
       a CockroachDB self-hosted cluster to this version,
       [contact support](https://support.cockroachlabs.com/hc/requests/new).
 
-
-- release_name: v25.2.0-rc.1
+- release_name: v25.2.0
   major_version: v25.2
-  release_date: '2025-05-12'
-  release_type: Testing
+  release_date: '2025-05-09'
+  release_type: Production
   go_version: go1.23.7
-  sha: 4377500860ff39cc5ddf7954079ced214bd788dc
+  sha: TBD
   has_sql_only: true
   has_sha256sum: true
   mac:
@@ -9092,9 +9091,16 @@
     linux_intel_fips: true
     linux_arm_fips: false
   docker:
-    docker_image: cockroachdb/cockroach-unstable
+    docker_image: cockroachdb/cockroach
     docker_arm: true
     docker_arm_experimental: false
     docker_arm_limited_access: false
   source: true
   previous_release: v25.2.0-beta.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).

src/current/_data/versions.csv

@@ -17,4 +17,4 @@ v24.1,2024-05-20,2025-05-20,2025-11-20,24.1.5,24.1.6,2024-10-21,2025-10-21,2026-
 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,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
+v25.2,2025-05-09,2026-05-12,2026-11-12,N/A,N/A,N/A,N/A,N/A,v25.1,release-25.2,N/A

src/current/_includes/releases/v24.2/feature-detail-key.html

@@ -7,11 +7,11 @@
  <tbody>
   <tr>
    <td>&starf;</td>
-   <td>Features marked "All&starf;" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All*" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>&starf;&starf;</td>
-   <td>Features marked "All&starf;&starf;" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All**" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>{% include icon-yes.html %}</td>

src/current/_includes/releases/v24.3/feature-detail-key.html

@@ -7,11 +7,11 @@
  <tbody>
   <tr>
    <td>&starf;</td>
-   <td>Features marked "All&starf;" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All*" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>&starf;&starf;</td>
-   <td>Features marked "All&starf;&starf;" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All**" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>{% include icon-yes.html %}</td>

src/current/_includes/releases/v25.1/feature-detail-key.html

@@ -7,11 +7,11 @@
  <tbody>
   <tr>
    <td>&starf;</td>
-   <td>Features marked "All&starf;" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All*" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>&starf;&starf;</td>
-   <td>Features marked "All&starf;&starf;" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All**" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>{% include icon-yes.html %}</td>

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

@@ -1,33 +1,11 @@
-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.
+Before [upgrading to CockroachDB v25.2]({% link v25.2/upgrade-cockroach-version.md %}), be sure to review the following backward-incompatible changes, as well as [key cluster setting changes](#v25-2-0-cluster-settings), and adjust your deployment as necessary.
 
-- Bullet
+- 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. Users who do not want the autocommit behavior can preserve the previous behavior by changing the default value of `autocommit_before_ddl` with: `ALTER ROLE ALL SET autocommit_before_ddl = false;`. [#139871]
+- `DROP INDEX` can now only be run when `sql_safe_updates` is set to `false`. [#139456]
+- Vector indexes do not support mutation while being created with `CREATE INDEX` or rebuilt with `ALTER PRIMARY KEY`. To prevent inadvertent application downtime, set the `sql_safe_updates` session setting to `false` when using `CREATE INDEX` or `ALTER PRIMARY KEY` with a vector index. [#144601]
+- The variable arguments of polymorphic built-in functions (e.g., `concat`, `num_nulls`, `format`, `concat_ws`, etc.) no longer need to have the same type, matching PostgreSQL behavior. As a result, CockroachDB's type inference engine will no longer be able to infer argument types in some cases where it previously could, and there is a possibility that CockroachDB applications will encounter new errors. The new session variable `use_pre_25_2_variadic_builtins` restores the previous behavior (and limitations). [#144600]
 
-- Bullet
-
-- Bullet
-
-- Bullet
-
-- Bullet
-  - 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`.
-
-- Bullet
-
-    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; ``` 
-
-    [#][#]
-
-
-[#]: https://github.com/cockroachdb/cockroach/pull/
-[#]: https://github.com/cockroachdb/cockroach/pull/
-[#]: https://github.com/cockroachdb/cockroach/pull/
-[#]: https://github.com/cockroachdb/cockroach/pull/
-[#]: https://github.com/cockroachdb/cockroach/pull/
-[#]: https://github.com/cockroachdb/cockroach/pull/
+[#139871]: https://github.com/cockroachdb/cockroach/pull/139871
+[#139456]: https://github.com/cockroachdb/cockroach/pull/139456
+[#144601]: https://github.com/cockroachdb/cockroach/pull/144601
+[#144600]: https://github.com/cockroachdb/cockroach/pull/144600

src/current/_includes/releases/v25.2/cluster-setting-changes.md

@@ -1,49 +1,15 @@
-Changes to [cluster settings]({% link v25.1/cluster-settings.md %}) should be reviewed prior to upgrading. New default cluster setting values will be used unless you have manually set a value for a setting. This can be confirmed by running the SQL statement `SELECT * FROM system.settings` to view the non-default settings.
+Changes to [cluster settings]({% link v25.2/cluster-settings.md %}) should be reviewed prior to upgrading. New default cluster setting values will be used unless you have manually set a value for a setting. This can be confirmed by running the SQL statement `SELECT * FROM system.settings` to view the non-default settings.
 
-- Bullet
-- Bullet
-- Bullet
-- Bullet
-- Bullet
+<h5 id="v25-2-0-settings-added">Settings added</h5>
 
-<h5 id="v25-1-0-settings-added">Settings added</h5>
+- `feature.vector_index.enabled` - Set to `TRUE` to enable vector indexes. Default is `FALSE` (not enabled).
+- `server.child_metrics.include_aggregate.enabled` - When `TRUE`, reports both aggregate and child Prometheus metrics, which can be helpful for quick top-level insights or backward compatibility, but should be disabled if you’re seeing inflated values in Prometheus queries due to double counting. Defaults to `TRUE`.
+- `ui.default_timezone` - Allows you to set the time zone for displayed timestamps in the DB Console. (Refer to [DB Console timezone configuration]({% link v25.2/ui-overview.md %}#db-console-timezone-configuration).) Replaces the deprecated [`ui.display_timezone` cluster setting]({% link v25.2/cluster-settings.md %}#setting-ui-display-timezone). If that value had been set, it will automatically be applied to the new setting `ui.default_timezone`, which takes precedence.
+- `server.oidc_authentication.provider.custom_ca` - Supports a custom root CA for verifying certificates while authenticating with an OIDC provider.
+- `sql.stats.automatic_full_collection.enabled` - It is now possible to automatically collect partial table statistics, but disable automatic collection of full table statistics. To do so, change this setting to `FALSE`. It defaults to `TRUE`. In addition to this cluster setting, you can use the table setting `sql_stats_automatic_full_collection_enabled`.
 
-- Bullet
-
-- Bullet
-
-- Bullet
-
-- Bullet
-
-<h5 id="v25-1-0-settings-with-changed-defaults">Settings with changed defaults</h5>
-
-- Bullet
-
-- Bullet
-
-- Bullet
-
-- Bullet
-
-<h5 id="v25-1-0-settings-with-changed-visibility">Settings with changed visibility</h5>
+<h5 id="v25-2-0-settings-with-changed-visibility">Settings with changed visibility</h5>
 
 The following settings are now marked `public` after previously being `reserved`. Reserved settings are not documented and their tuning by customers is not supported.
 
-- Bullet
-
-<h5 id="v25-1-0-renamed-settings">Renamed settings</h5>
-
-- Bullet
-
-- Bullet
-
-<h5 id="v25-1-0-additional-cluster-setting-changes">Additional setting changes</h5>
-
-- Bullet
-
-- Bullet
-
-- Bullet
-
-- Bullet
+- `sql.stats.detailed_latency_metrics.enabled` - Percentile latencies are no longer available for **SQL Activity**. The implementation of these percentiles was error-prone and difficult to understand because it was computed differently from the other SQL statistics collected. Customers interested in viewing percentile latencies per statement fingerprint are encouraged to use the experimental per-fingerprint histograms that can be enabled with the `sql.stats.detailed_latency_metrics.enabled` cluster setting. This will enable externalized histogram metrics via the Prometheus scrape endpoint. [#139500](https://github.com/cockroachdb/cockroach/pulls/139500)

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

@@ -1,5 +1,3 @@
-The following deprecations are announced in v25.1.
+The following deprecations are announced in v25.2.
 
-- Bullet
-
-[#]: https://github.com/cockroachdb/cockroach/pull/
+- The [`ui.display_timezone` cluster setting]({% link v25.2/cluster-settings.md %}#setting-ui-display-timezone) is now deprecated and will be removed in a future release. If it has been set, its value will automatically be applied to the new setting `ui.default_timezone`, which takes precedence. For further detail, refer to [DB Console timezone configuration]({% link v25.2/ui-overview.md %}#db-console-timezone-configuration).

src/current/_includes/releases/v25.2/feature-detail-key.html

@@ -7,11 +7,11 @@
  <tbody>
   <tr>
    <td>&starf;</td>
-   <td>Features marked "All&starf;" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All*" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>&starf;&starf;</td>
-   <td>Features marked "All&starf;&starf;" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+   <td>Features marked "All**" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
   </tr>
   <tr>
    <td>{% include icon-yes.html %}</td>

src/current/_includes/releases/v25.2/upgrade-finalization.md

@@ -1,9 +1,5 @@
-During a major-version upgrade, certain features and performance improvements may not be available until the upgrade is finalized. In v25.1, these are:
+During a major-version upgrade, certain features and performance improvements may not be available until the upgrade is finalized. In v25.2, these are:
 
-- Bullet
-- Bullet
-- Bullet
-- Bullet
-  - `SHOW JOBS` is now based on a new mechanism for storing information about the progress and status of running jobs. [#](https://github.com/cockroachdb/cockroach/pull/)
-  - `ALTER JOB ... OWNER TO` can now be used to transfer ownership of a job between users/roles. [#](https://github.com/cockroachdb/cockroach/pull/)
-  - Users can now always see and control (pause/resume/cancel) jobs that they own. [#](https://github.com/cockroachdb/cockroach/pull/)
+- Row-level security
+- Creating a set-returning PL/pgSQL function
+- Support for the `jsonpath` data type