Merge branch 'main' into DOC-14237

Author: mikeCRL

src/current/_config_cockroachdb.yml

@@ -3,5 +3,5 @@ current_cloud_version: v25.3
 destination: _site/docs
 homepage_title: CockroachDB Docs
 versions:
-  stable: v25.2
+  stable: v25.3
   dev: v25.3

src/current/_data/releases.yml

@@ -9217,7 +9217,7 @@
 
 - release_name: v24.3.16
   major_version: v24.3
-  release_date: '2025-07-23'
+  release_date: '2025-07-28'
   release_type: Production
   go_version: go1.23.7
   sha: 3705b047131b82ff6b584369c9f9fe278f60ca2c
@@ -9245,7 +9245,7 @@
 
 - release_name: v24.1.21
   major_version: v24.1
-  release_date: '2025-07-23'
+  release_date: '2025-07-28'
   release_type: Production
   go_version: go1.23.7
   sha: 1a78511371ecb81db7afb19bfb5ec66ad49a85f3
@@ -9268,4 +9268,201 @@
     docker_arm_experimental: false
     docker_arm_limited_access: false
   source: true
-  previous_release: v24.1.20
+  previous_release: v24.1.20
+
+  
+- release_name: v25.1.9
+  major_version: v25.1
+  release_date: '2025-07-28'
+  release_type: Production
+  go_version: go1.23.7
+  sha: 2fcef9301ac20e8cb084cf7e2c2c24bede0ee1e7
+  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.8
+
+  
+- release_name: v25.2.3
+  major_version: v25.2
+  release_date: '2025-07-28'
+  release_type: Production
+  go_version: go1.23.7
+  sha: adfe5601ff6cb72c0f65090995978ca9ebbdc647
+  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.2.2
+
+- release_name: v24.1.22
+  major_version: v24.1
+  release_date: '2025-08-01'
+  release_type: Production
+  go_version: go1.24.5
+  sha: 0d417065f39706192c154f2f8efa34a48f3f06ef
+  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.1.21
+
+- release_name: v24.3.17
+  major_version: v24.3
+  release_date: '2025-08-01'
+  release_type: Production
+  go_version: go1.24.5
+  sha: 4b7d71c98252df426bd10a14b1a580c48de1af8c
+  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.16
+
+- release_name: v25.1.10
+  major_version: v25.1
+  release_date: '2025-08-01'
+  release_type: Production
+  go_version: go1.24.5
+  sha: 1dbd5c09009fc79628d5145289ed309c002835e4
+  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.9
+
+- release_name: v25.2.4
+  major_version: v25.2
+  release_date: '2025-08-01'
+  release_type: Production
+  go_version: go1.24.5
+  sha: db39678e142ec9f40d40b7139c3f821a94fcb80f
+  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.2.3
+  
+- release_name: v25.3.0
+  major_version: v25.3
+  release_date: '2025-08-04'
+  release_type: Production
+  go_version: go1.23.7
+  sha: 35b7c853b5a2d898fd054a13c617fc236d6b5bde
+  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.3.0-rc.1
+  cloud_only: true
+  cloud_only_message_short: 'Currently available for CockroachDB Advanced only'
+  cloud_only_message: >
+      This version is currently available only for
+      CockroachDB Cloud clusters on the Advanced plan.
+

src/current/_data/versions.csv

@@ -1,21 +1,21 @@
-major_version,release_date,maint_supp_exp_date,asst_supp_exp_date,last_ga_patch,initial_lts_patch,initial_lts_release_date,lts_maint_supp_exp_date,lts_asst_supp_exp_date,previous_version,crdb_branch_name,binary_removal_date
-v1.0,2017-05-10,2018-05-10,2018-11-10,N/A,N/A,N/A,N/A,N/A,N/A,release-1.0,2024-01-01
-v1.1,2017-10-12,2018-10-12,2019-04-12,N/A,N/A,N/A,N/A,N/A,v1.0,release-1.1,2024-01-01
-v2.0,2018-04-04,2019-04-04,2019-10-04,N/A,N/A,N/A,N/A,N/A,v1.1,release-2.0,2024-01-01
-v2.1,2018-10-30,2019-10-30,2020-04-30,N/A,N/A,N/A,N/A,N/A,v2.0,release-2.1,2024-01-01
-v19.1,2019-04-30,2020-04-30,2020-10-30,N/A,N/A,N/A,N/A,N/A,v2.1,release-19.1,2024-01-01
-v19.2,2019-11-12,2020-11-12,2021-05-12,N/A,N/A,N/A,N/A,N/A,v19.1,release-19.2,2024-01-01
-v20.1,2020-05-12,2021-05-12,2021-11-12,N/A,N/A,N/A,N/A,N/A,v19.2,release-20.1,2025-05-12
-v20.2,2020-11-10,2021-11-10,2022-05-10,N/A,N/A,N/A,N/A,N/A,v20.1,release-20.2,2025-05-12
-v21.1,2021-05-18,2022-05-18,2022-11-18,N/A,N/A,N/A,N/A,N/A,v20.2,release-21.1,2025-05-18
-v21.2,2021-11-16,2022-11-16,2023-05-16,N/A,N/A,N/A,N/A,N/A,v21.1,release-21.2,2025-11-16
-v22.1,2022-05-24,2023-05-24,2023-11-24,N/A,N/A,N/A,N/A,N/A,v21.2,release-22.1,2026-05-24
-v22.2,2022-12-05,2023-12-05,2024-06-05,N/A,N/A,N/A,N/A,N/A,v22.1,release-22.2,2026-12-05
-v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,2025-11-13,v22.2,release-23.1,2027-05-15
-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,2028-02-05
-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,2028-05-20
-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,2028-11-18
-v25.1,2025-02-18,2025-08-18,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1,2029-02-18
-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,2029-05-09
-v25.3,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v25.2,release-25.3,N/A
+major_version,release_date,maint_supp_exp_date,asst_supp_exp_date,last_ga_patch,initial_lts_patch,initial_lts_release_date,lts_maint_supp_exp_date,lts_asst_supp_exp_date,previous_version,crdb_branch_name,binary_removal_date
+v1.0,2017-05-10,2018-05-10,2018-11-10,N/A,N/A,N/A,N/A,N/A,N/A,release-1.0,2024-01-01
+v1.1,2017-10-12,2018-10-12,2019-04-12,N/A,N/A,N/A,N/A,N/A,v1.0,release-1.1,2024-01-01
+v2.0,2018-04-04,2019-04-04,2019-10-04,N/A,N/A,N/A,N/A,N/A,v1.1,release-2.0,2024-01-01
+v2.1,2018-10-30,2019-10-30,2020-04-30,N/A,N/A,N/A,N/A,N/A,v2.0,release-2.1,2024-01-01
+v19.1,2019-04-30,2020-04-30,2020-10-30,N/A,N/A,N/A,N/A,N/A,v2.1,release-19.1,2024-01-01
+v19.2,2019-11-12,2020-11-12,2021-05-12,N/A,N/A,N/A,N/A,N/A,v19.1,release-19.2,2024-01-01
+v20.1,2020-05-12,2021-05-12,2021-11-12,N/A,N/A,N/A,N/A,N/A,v19.2,release-20.1,2025-05-12
+v20.2,2020-11-10,2021-11-10,2022-05-10,N/A,N/A,N/A,N/A,N/A,v20.1,release-20.2,2025-05-12
+v21.1,2021-05-18,2022-05-18,2022-11-18,N/A,N/A,N/A,N/A,N/A,v20.2,release-21.1,2025-05-18
+v21.2,2021-11-16,2022-11-16,2023-05-16,N/A,N/A,N/A,N/A,N/A,v21.1,release-21.2,2025-11-16
+v22.1,2022-05-24,2023-05-24,2023-11-24,N/A,N/A,N/A,N/A,N/A,v21.2,release-22.1,2026-05-24
+v22.2,2022-12-05,2023-12-05,2024-06-05,N/A,N/A,N/A,N/A,N/A,v22.1,release-22.2,2026-12-05
+v23.1,2023-05-15,2024-05-15,2024-11-15,23.1.11,23.1.12,2023-11-13,2024-11-13,2025-11-13,v22.2,release-23.1,2027-05-15
+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,2028-02-05
+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,2028-05-20
+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,2028-11-18
+v25.1,2025-02-18,2025-08-18,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-25.1,2029-02-18
+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,2029-05-09
+v25.3,2025-08-04,2026-08-04,2027-02-04,N/A,N/A,N/A,N/A,N/A,v25.2,release-25.3,2029-08-04

src/current/_includes/releases/v24.1/v24.1.21.md

@@ -1,6 +1,6 @@
 ## v24.1.21
 
-Release Date: July 23, 2025
+Release Date: July 28, 2025
 
 {% include releases/new-release-downloads-docker-image.md release=include.release %}
 

src/current/_includes/releases/v24.1/v24.1.22.md

@@ -0,0 +1,13 @@
+## v24.1.22
+
+Release Date: August 1, 2025
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v24-1-22-bug-fixes">Bug fixes</h3>
+
+- Fixed a bug that could cause some errors returned by attempts to upload backup data to external storage providers to be undetected, potentially causing incomplete backups.
+ [#151098][#151098]
+
+
+[#151098]: https://github.com/cockroachdb/cockroach/pull/151098

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

@@ -1,6 +1,6 @@
 ## v24.3.16
 
-Release Date: July 23, 2025
+Release Date: July 28, 2025
 
 {% include releases/new-release-downloads-docker-image.md release=include.release %}
 

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

@@ -0,0 +1,13 @@
+## v24.3.17
+
+Release Date: August 1, 2025
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v24-3-17-bug-fixes">Bug fixes</h3>
+
+- Fixed a bug that could cause some errors returned by attempts to upload backup data to external storage providers to be undetected, potentially causing incomplete backups.
+ [#151094][#151094]
+
+
+[#151094]: https://github.com/cockroachdb/cockroach/pull/151094

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

@@ -0,0 +1,13 @@
+## v25.1.10
+
+Release Date: August 1, 2025
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v25-1-10-bug-fixes">Bug fixes</h3>
+
+- Fixed a bug that could cause some errors returned by attempts to upload backup data to external storage providers to be undetected, potentially causing incomplete backups.
+ [#151097][#151097]
+
+
+[#151097]: https://github.com/cockroachdb/cockroach/pull/151097

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

@@ -0,0 +1,54 @@
+## v25.1.9
+
+Release Date: July 28, 2025
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v25-1-9-sql-language-changes">SQL language changes</h3>
+
+- 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`).
+ [#148223][#148223]
+- 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.
+ [#148223][#148223]
+
+<h3 id="v25-1-9-db-console-changes">DB Console changes</h3>
+
+- Updated the "Learn more" link on the **Hot Ranges** page to direct users to a newer, more comprehensive reference guide about hotspots.
+ [#148521][#148521]
+
+<h3 id="v25-1-9-bug-fixes">Bug fixes</h3>
+
+- Fixed a data race in the `cloudstorage` sink.
+ [#147162][#147162]
+- Fixed an error in `crdb_internal.table_spans` that could occur when a table's schema had been dropped.
+ [#147976][#147976]
+- Fixed a bug where `libpq` clients using the async API could hang with large result sets (Python: psycopg; Ruby: ActiveRecord, ruby-pg).
+ [#148469][#148469]
+- The `RESET ALL` statement no longer affects the following session variables:
+  - `is_superuser`
+  - `role`
+  - `session_authorization`
+  - `transaction_isolation`
+  - `transaction_priority`
+  - `transaction_status`
+  - `transaction_read_only`
+  
+    This better matches PostgreSQL behavior for `RESET ALL`. In addition, the `DISCARD ALL` statement no longer errors when `default_transaction_use_follower_reads` is enabled.
+ [#149429][#149429]
+- In v25.1, automatic partial statistics collection was enabled by default (by setting the `sql.stats.automatic_partial_collection.enabled` cluster setting to `true`). Partial statistics collection may encounter certain expected scenarios that were previously reported as failed stats jobs with PostgreSQL error code `55000`. These errors are benign and are no longer reported. Instead, the stats job will be marked as "succeeded," though no new statistics will be created.
+ [#149624][#149624]
+- Fixed a slow memory leak that was introduced in v25.1.8, v25.2.1, v25.2.2, and v25.3 betas. The leak would accumulate whenever a node executed a part of the distributed plan (the gateway node of the plan was not affected), and could only be mitigated by restarting the node.
+ [#149925][#149925]
+- Fixed a bug that would allow a race condition in foreign key cascades under `READ COMMITTED` and `REPEATABLE READ` isolation levels.
+ [#150339][#150339]
+
+
+[#148521]: https://github.com/cockroachdb/cockroach/pull/148521
+[#147162]: https://github.com/cockroachdb/cockroach/pull/147162
+[#147976]: https://github.com/cockroachdb/cockroach/pull/147976
+[#148469]: https://github.com/cockroachdb/cockroach/pull/148469
+[#149925]: https://github.com/cockroachdb/cockroach/pull/149925
+[#150339]: https://github.com/cockroachdb/cockroach/pull/150339
+[#148223]: https://github.com/cockroachdb/cockroach/pull/148223
+[#149624]: https://github.com/cockroachdb/cockroach/pull/149624
+[#149429]: https://github.com/cockroachdb/cockroach/pull/149429