Merge branch 'main' into 20250414-DOC-10439-row-level-security

Author: rmloveland

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

@@ -9035,3 +9035,99 @@
     docker_arm_limited_access: false
   source: true
   previous_release: v24.3.11
+
+
+- release_name: v25.1.6
+  major_version: v25.1
+  release_date: '2025-04-30'
+  release_type: Production
+  go_version: go1.23.7
+  sha: 9af34db410ad57b58a35d8251d7c4fe1ddfcec69
+  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.5
+  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).
+
+- release_name: v25.2.0-rc.1
+  major_version: v25.2
+  release_date: '2025-05-12'
+  release_type: Testing
+  go_version: go1.23.7
+  sha: 4377500860ff39cc5ddf7954079ced214bd788dc
+  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-unstable
+    docker_arm: true
+    docker_arm_experimental: false
+    docker_arm_limited_access: false
+  source: true
+  previous_release: v25.2.0-beta.3
+
+- release_name: v25.2.0
+  major_version: v25.2
+  release_date: '2025-05-12'
+  release_type: Production
+  go_version: go1.23.7
+  sha: 4377500860ff39cc5ddf7954079ced214bd788dc
+  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.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

@@ -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/common/license/evolving.md

@@ -1 +1 @@
-CockroachDB is evolving. In late 2024, we will retire our Core offering to consolidate on a single CockroachDB Enterprise offering under a new [license](https://www.cockroachlabs.com/cockroachdb-software-license/). CockroachDB Enterprise will be available at no charge for individual users and small businesses and will offer all users, free and paid, the full breadth of CockroachDB capabilities. See the [CockroachDB licensing update page](https://www.cockroachlabs.com/enterprise-license-update/) for details.
+CockroachDB is evolving. In late 2024, we will retire our Core offering to consolidate on a single CockroachDB Enterprise offering under a new [license](https://www.cockroachlabs.com/cockroachdb-software-license/). CockroachDB Enterprise will be available at no charge for individual users and small businesses and will offer all users, free and paid, the full breadth of CockroachDB capabilities. See the [CockroachDB licensing update page](https://www.cockroachlabs.com/enterprise-license-update/) for details.

src/current/_includes/common/licensing-faqs.md

@@ -8,9 +8,10 @@ The table of licenses below refers to options for {{ site.data.products.core }}
 
 Type | Description
 -------------|------------
-**Enterprise** <a name="enterprise"></a> | This paid license allows usage of all CockroachDB features in accordance with the terms specified in the [CockroachDB Software License][csl]. License must be renewed annually or as negotiated. Support levels available include [Enterprise][support] or [Essential][support].
-**Enterprise Free** <a name="enterprise-free"></a> | Same functionality as **Enterprise**, but free of charge for businesses with less than $10M in annual revenue. Clusters will be [throttled](#throttling) after 7 days without sending [telemetry]({% link {{ page.version.version }}/telemetry.md %}). License must be renewed annually. Support level available is Community (i.e., [Docs]({% link {{ page.version.version }}/index.md %}), [Forum][forum], [Slack][slack]).
-**Enterprise Trial** <a name="enterprise-trial"></a> | A 30 day self-service trial license. [Telemetry]({% link {{ page.version.version }}/telemetry.md %}) is required during the trial. Clusters will be [throttled](#throttling) after 7 days without sending telemetry. Telemetry can be disabled once the cluster is upgraded to a paid **Enterprise** license. Support level available during trial is Community (i.e., [Docs]({% link {{ page.version.version }}/index.md %}), [Forum][forum], [Slack][slack]).
+**Enterprise** <a name="enterprise"></a> | This paid license allows usage of all CockroachDB features in accordance with the terms specified in the [CockroachDB Software License][csl]. License must be renewed annually or as negotiated. Support levels available include [Enterprise][support] or [Essential][support]. The type of enterprise license may be set to **Production**, **Pre-production**, or **Development** depending on the environment in which CockroachDB is deployed.
+**Free** <a name="enterprise-free"></a> | Same functionality as **Enterprise**, but free of charge for businesses with less than $10M in annual revenue. Clusters will be [throttled](#throttling) after 7 days without sending [telemetry]({% link {{ page.version.version }}/telemetry.md %}). License must be renewed annually. Support level available is Community (i.e., [Docs]({% link {{ page.version.version }}/index.md %}), [Forum][forum], [Slack][slack]).
+**Trial** <a name="enterprise-trial"></a> | A 30 day self-service trial license. [Telemetry]({% link {{ page.version.version }}/telemetry.md %}) is required during the trial. Clusters will be [throttled](#throttling) after 7 days without sending telemetry. Telemetry can be disabled once the cluster is upgraded to a paid **Enterprise** license. Support level available during trial is Community (i.e., [Docs]({% link {{ page.version.version }}/index.md %}), [Forum][forum], [Slack][slack]).
+**Evaluation** <a name="enterprise-evaluation"></a> | Same functionality as **Enterprise**, but may be provided by your sales team if needed for an extended evaluation period. Support level is equivalent to a enterprise license.
 
 <a href="mailto:[email protected]">Contact Sales</a> if you want to try CockroachDB without telemetry requirements or if you require an extended trial period.
 
@@ -23,7 +24,13 @@ Note that:
 
 ## Obtain a license
 
-To obtain a paid **Enterprise** license, <a href="mailto:[email protected]">contact Sales</a>.
+To obtain a paid **Enterprise** license, <a href="mailto:[email protected]">contact Sales</a>. Once a license is added to your account, it appears in the [CockroachDB {{ site.data.products.cloud }} Console][cloud-console] on the **Organization &raquo; Enterprise Licenses** page. This page is only accessible by users with **Organization Admin** permissions.
+
+[Sign up for a CockroachDB {{ site.data.products.cloud }} Console account](https://cockroachlabs.cloud/signup?experience=enterprise) if you do not already have one.
+
+{{site.data.alerts.callout_info}}
+Enterprise licenses generated prior to May 31st 2025 are not visible in the **Enterprise Licenses** page.
+{{site.data.alerts.end}}
 
 To obtain an **Enterprise Free** or **Enterprise Trial** license, take the following steps:
 

src/current/_includes/releases/v23.1/v23.1.0.md

@@ -293,12 +293,6 @@ With the move from Preview to GA, this feature brings many new capabilities, suc
    </tr>
   </thead>
   <tbody>
-  <tr>
-   <td><p>Support longer incremental backup chains</p>
-   </td>
-   <td><p>We now support up to 400 incremental backups, an 8x increase, enabling you to preserve your data even more effectively (reducing RPO) while being more cost-efficient. Incremental backups contain only the data that has changed since the last backup, so they are smaller and faster to produce.
-   </td>
-  </tr>
   <tr>
    <td><p>Restrict backups to a locality</p>
    </td>

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.1/v25.1.6.md

@@ -0,0 +1,86 @@
+## v25.1.6
+
+Release Date: April 30th, 2025
+
+{% include releases/new-release-downloads-docker-image.md release=include.release %}
+
+<h3 id="v25-1-6-sql-language-changes">SQL language changes</h3>
+
+- Added the `WITH IGNORE_FOREIGN_KEYS` option to `SHOW CREATE TABLE` which omits foreign key constraints from the output schema. This option is also allowed in `SHOW CREATE VIEW`, but has no effect. It cannot be combined with the `WITH REDACT` option.
+ [#142161][#142161]
+- `EXPLAIN ANALYZE` statements now display the number of transaction retries and time spent retrying, if non-zero, in the plan output.
+ [#142928][#142928]
+- A new `execution time` statistic is now reported on `EXPLAIN ANALYZE` output for most operators. Previously, this statistic was only available on the DistSQL diagrams in `EXPLAIN ANALYZE (DISTSQL)` output.
+ [#143895][#143895]
+
+<h3 id="v25-1-6-operational-changes">Operational changes</h3>
+
+- The `sys.cpu.host.combined.percent-normalized` metric has been updated to include additional counters for more accurate host CPU measurement and to reduce underreporting. It now accounts for time spent processing hardware (`irq`) and software (`softirq`) interrupts, as well as `nice` time, which represents low-priority user-mode activity.
+ [#142906][#142906]
+- The `server.client_cert_expiration_cache.capacity` cluster setting has been removed. The `security.certificate.expiration.client` and `security.certificate.ttl.client` metrics now report the lowest value observed for a user in the last 24 hours.
+ [#143729][#143729]
+
+<h3 id="v25-1-6-bug-fixes">Bug fixes</h3>
+
+- Previously, fast failback for physical cluster replication (PCR) could succeed even if the destination cluster protected timestamp had been removed, causing the reverse stream to enter a crashing loop. This fix ensures the failback command fast fails.
+ [#142922][#142922]
+- The reader virtual cluster now starts if the user begins a physical cluster replication (PCR) stream from a cursor via `ALTER VIRTUAL CLUSTER virtual_cluster START REPLICATION OF virtual_cluster ON physical_cluster WITH READ VIRTUAL CLUSTER`.
+ [#143141][#143141]
+- Fixed a bug that caused changefeeds to fail on startup when scanning a single key.
+ [#143150][#143150]
+- MVCC garbage collection is now fully subject to IO admission control. Previously, it was possible for MVCC GC to cause store overload (such as LSM inversion) when a large amount of data would become eligible for garbage collection. Should any issues arise from subjecting MVCC GC to admission control, the `kv.mvcc_gc.queue_kv_admission_control.enabled` cluster setting can be set to `false` to restore the previous behavior.
+ [#143277][#143277]
+- Fixed a bug where calling a stored procedure could drop the procedure if it had `OUT` parameters that were not used by the calling routine. This bug had existed since PL/pgSQL `CALL` statements were introduced in v24.1.
+ [#143290][#143290]
+- Fixed a bug where CockroachDB would encounter an internal error when decoding the gists of plans with `CALL` statements. The bug had been present since v23.2.
+ [#143315][#143315]
+- Fixed a crash due to `use of enum metadata before hydration` when using logical data replication (LDR) with user-defined types.
+ [#143373][#143373]
+- Fixed a bug where a GC threshold error (which appears as "batch timestamp must be after replica GC threshold ...") could cause a schema change that backfills data to fail. Now, the error will cause the backfill to be retried at a higher timestamp to avoid the error.
+ [#143520][#143520]
+- Fixed a bug in `v24.1.14`, `v24.3.7`, `v24.3.8`, and `v25.1` that could cause a nil-pointer error when a column's default expression contained a volatile expression (like `nextval`) as a UDF argument.
+ [#143634][#143634]
+- Fixed a potential deadlock that could occur during client certificate updates while metrics were being collected. This issue affected the reliability of certificate expiration reporting.
+ [#143729][#143729]
+- Previously, the fields `maximum memory usage` and `max sql temp disk usage` in the `EXPLAIN ANALYZE` output could be under-reported for distributed plans when memory-intensive operations were fully performed on the remote nodes. This is now fixed. The bug existed in v22.1 and later.
+ [#143794][#143794]
+- The `ALTER VIRTUAL CLUSTER SET REPLICATION READ VIRTUAL CLUSTER` syntax is now supported for adding a reader virtual cluster for an existing Physical Cluster Replication (PCR) standby.
+ [#143853][#143853]
+- Fixed a bug where CockroachDB could encounter a `cannot specify timestamp older than ...` error during table statistics collection in some cases (e.g., when the cluster is overloaded). The bug was present since v19.1.
+ [#144018][#144018]
+- Fixed a bug that could cause a stack overflow during execution of a prepared statement that invoked a PL/pgSQL routine with a loop. The bug existed in versions v23.2.22, v24.1.15, v24.3.9, v25.1.2, v25.1.3, and pre-release versions of v25.2 prior to v25.2.0-alpha.3.
+ [#144031][#144031]
+- Fixed a bug that could lead to a node stall.
+ [#146410][#146410]
+
+<h3 id="v25-1-6-performance-improvements">Performance improvements</h3>
+
+- Schema changes that require data to be backfilled no longer hold a protected timestamp for the entire duration of the backfill; this means there is less overhead caused by MVCC garbage collection after the backfill completes.
+ [#143520][#143520]
+
+<h3 id="v25-1-6-miscellaneous">Miscellaneous</h3>
+
+- Fix rare corruption bug that impacts import and
+  materialized views. [#144687][#144687]
+
+
+[#142928]: https://github.com/cockroachdb/cockroach/pull/142928
+[#143729]: https://github.com/cockroachdb/cockroach/pull/143729
+[#143277]: https://github.com/cockroachdb/cockroach/pull/143277
+[#143853]: https://github.com/cockroachdb/cockroach/pull/143853
+[#144018]: https://github.com/cockroachdb/cockroach/pull/144018
+[#144031]: https://github.com/cockroachdb/cockroach/pull/144031
+[#143895]: https://github.com/cockroachdb/cockroach/pull/143895
+[#144687]: https://github.com/cockroachdb/cockroach/pull/144687
+[#143141]: https://github.com/cockroachdb/cockroach/pull/143141
+[#143150]: https://github.com/cockroachdb/cockroach/pull/143150
+[#143290]: https://github.com/cockroachdb/cockroach/pull/143290
+[#143373]: https://github.com/cockroachdb/cockroach/pull/143373
+[#142161]: https://github.com/cockroachdb/cockroach/pull/142161
+[#142906]: https://github.com/cockroachdb/cockroach/pull/142906
+[#142922]: https://github.com/cockroachdb/cockroach/pull/142922
+[#143315]: https://github.com/cockroachdb/cockroach/pull/143315
+[#143520]: https://github.com/cockroachdb/cockroach/pull/143520
+[#143634]: https://github.com/cockroachdb/cockroach/pull/143634
+[#143794]: https://github.com/cockroachdb/cockroach/pull/143794
+[#146410]: https://github.com/cockroachdb/cockroach/pull/146410