From 8130214a31d8921398e81a7b8144a3f4dea45bf0 Mon Sep 17 00:00:00 2001 From: mikeCRL Date: Fri, 24 Jan 2025 01:10:28 -0500 Subject: [PATCH 1/6] Initial v25.1.0-beta.2 release notes --- src/current/_data/releases.yml | 28 +++++++++++ src/current/_data/versions.csv | 2 +- .../releases/v25.1/v25.1.0-beta.2.md | 48 +++++++++++++++++++ 3 files changed, 77 insertions(+), 1 deletion(-) create mode 100644 src/current/_includes/releases/v25.1/v25.1.0-beta.2.md diff --git a/src/current/_data/releases.yml b/src/current/_data/releases.yml index 35732b95115..75275683fc8 100644 --- a/src/current/_data/releases.yml +++ b/src/current/_data/releases.yml @@ -7924,3 +7924,31 @@ docker_arm_limited_access: false source: true previous_release: v25.1.0-alpha.3 + + +- release_name: v25.1.0-beta.2 + major_version: v25.1 + release_date: '2025-01-27' + release_type: Testing + go_version: go1.22.8 + sha: b13cf51d928597efcb5a57eb7a9dad19c67b109e + 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.1.0-beta.1 diff --git a/src/current/_data/versions.csv b/src/current/_data/versions.csv index 45c9397872a..278e4c377bd 100644 --- a/src/current/_data/versions.csv +++ b/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-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 diff --git a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md new file mode 100644 index 00000000000..35c401db833 --- /dev/null +++ b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md @@ -0,0 +1,48 @@ +## v25.1.0-beta.2 + +Release Date: January 27, 2025 + +{% include releases/new-release-downloads-docker-image.md release=include.release %} + +

SQL language changes

+ +- SHOW JOBS is now based on a new mechanism for storing information about the progress and status of running jobs. Epic: none. [#139230][#139230] +- SHOW TENANT WITH REPLICATION STATUS will now display the `ingestion_job_id` column after the `name` column. [#139275][#139275] + +

Operational changes

+ +- Customers must pass URIs as external connections to create LDR statments. [#139506][#139506] + +

DB Console changes

+ +- The /_admin/v1/settings API (and therfore cluster settings console page) now returns cluster settings using the same redaction logic as querying `SHOW CLUSTER SETTINGS` and `crdb_internal.cluster_settings`. This means that only settings flagged as "sensitive" will be redacted, all other settings will be visible. The same authorization is required for this endpoint, meaning the user must be an admin or have MODIFYCLUSTERSETTINGS or VIEWCLUSTERSETTINGS roles to hit this API. The exception is that if the user has VIEWACTIVITY or VIEWACTIVITYREDACTED, they will see console only settings. [#139277][#139277] +- The overload dashboard on DB Console now shows only the v2 replication admission control metrics, where previously it displayed both v1 and v2 metrics. Additionally, the aggregate size of queued replication entries is now shown. [#139566][#139566] + +

Bug fixes

+ +- Fixed a bug where the error "batch timestamp T must be after replica GC threshold" could occur during a schema change backfill operation, and cause the schema change job to retry infinitely. Now this error is treated as permanent, and will cause the job to enter the failed state. [#139251][#139251] + +

Performance improvements

+ +- Rpc.batch_stream_pool.enabled now defaults to false. This supersedes an earlier release note. The cluster setting is currently experimental and not listed publicly. [#139481][#139481] + +

Miscellaneous

+ +

Missing category

+ +- DROP INDEX can now only be run when `sql_safe_updates` are set to false. [#139505][#139505] + +

Doc updates

+ +{% comment %}Docs team: Please add these manually.{% endcomment %} + + + +[#139230]: https://github.com/cockroachdb/cockroach/pull/139230 +[#139251]: https://github.com/cockroachdb/cockroach/pull/139251 +[#139275]: https://github.com/cockroachdb/cockroach/pull/139275 +[#139277]: https://github.com/cockroachdb/cockroach/pull/139277 +[#139481]: https://github.com/cockroachdb/cockroach/pull/139481 +[#139505]: https://github.com/cockroachdb/cockroach/pull/139505 +[#139506]: https://github.com/cockroachdb/cockroach/pull/139506 +[#139566]: https://github.com/cockroachdb/cockroach/pull/139566 From 9eb3ced5af2b7f3a07e399c4581e54d3bbba7bff Mon Sep 17 00:00:00 2001 From: mikeCRL Date: Fri, 24 Jan 2025 16:46:02 -0500 Subject: [PATCH 2/6] Partial edit --- .../_includes/releases/v25.1/v25.1.0-beta.2.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md index 35c401db833..712bc5fc641 100644 --- a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md +++ b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md @@ -6,16 +6,21 @@ Release Date: January 27, 2025

SQL language changes

-- SHOW JOBS is now based on a new mechanism for storing information about the progress and status of running jobs. Epic: none. [#139230][#139230] -- SHOW TENANT WITH REPLICATION STATUS will now display the `ingestion_job_id` column after the `name` column. [#139275][#139275] +- `SHOW JOBS` is now based on a new mechanism for storing information about the progress and status of running jobs. [#139230][#139230] +- `SHOW TENANT WITH REPLICATION STATUS` now displays the `ingestion_job_id` column after the `name` column. [#139275][#139275]

Operational changes

-- Customers must pass URIs as external connections to create LDR statments. [#139506][#139506] +- Customers must pass URIs as [external connections]({% link {{ page.version.version }}/create-external-connection.md %}) when [setting up Logical Data Replication (LDR)]({% link {{ page.version.version }}/set-up-logical-data-replication.md %}). [#139506][#139506]

DB Console changes

-- The /_admin/v1/settings API (and therfore cluster settings console page) now returns cluster settings using the same redaction logic as querying `SHOW CLUSTER SETTINGS` and `crdb_internal.cluster_settings`. This means that only settings flagged as "sensitive" will be redacted, all other settings will be visible. The same authorization is required for this endpoint, meaning the user must be an admin or have MODIFYCLUSTERSETTINGS or VIEWCLUSTERSETTINGS roles to hit this API. The exception is that if the user has VIEWACTIVITY or VIEWACTIVITYREDACTED, they will see console only settings. [#139277][#139277] +- The DB Console Cluster Settings page and `/_admin/v1/settings` API now use the same authorization and redaction logic as `SHOW CLUSTER SETTINGS` and `crdb_internal.cluster_settings`: + - Users need `ADMIN`, `MODIFYCLUSTERSETTINGS`, or `VIEWCLUSTERSETTINGS` privileges to view settings. + - If you have [enabled redaction of sensitive settings]({% link {{ page.version.version }}/cluster-settings.md %}#setting-server-redact-sensitive-settings-enabled), only users with `ADMIN` or `MODIFYCLUSTERSETTINGS` permissions can view values of settings CockroachDB classifies as `sensitive`. + - Users with `VIEWACTIVITY` or `VIEWACTIVITYREDACTED` roles can only access settings pertaining to the DB Console. + + This change provides consistent behavior across all methods of accessing cluster settings. [#139277][#139277] - The overload dashboard on DB Console now shows only the v2 replication admission control metrics, where previously it displayed both v1 and v2 metrics. Additionally, the aggregate size of queued replication entries is now shown. [#139566][#139566]

Bug fixes

From 4c60926cc4b90fabc1e8437bc4d4f32e230d8488 Mon Sep 17 00:00:00 2001 From: mikeCRL Date: Sun, 26 Jan 2025 17:53:48 -0500 Subject: [PATCH 3/6] Use versioned links --- src/current/_includes/releases/v25.1/v25.1.0-beta.2.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md index 712bc5fc641..ba694cbf4ba 100644 --- a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md +++ b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md @@ -11,13 +11,13 @@ Release Date: January 27, 2025

Operational changes

-- Customers must pass URIs as [external connections]({% link {{ page.version.version }}/create-external-connection.md %}) when [setting up Logical Data Replication (LDR)]({% link {{ page.version.version }}/set-up-logical-data-replication.md %}). [#139506][#139506] +- Customers must pass URIs as [external connections]({% link v25.1/create-external-connection.md %}) when [setting up Logical Data Replication (LDR)]({% link v25.1/set-up-logical-data-replication.md %}). [#139506][#139506]

DB Console changes

- The DB Console Cluster Settings page and `/_admin/v1/settings` API now use the same authorization and redaction logic as `SHOW CLUSTER SETTINGS` and `crdb_internal.cluster_settings`: - Users need `ADMIN`, `MODIFYCLUSTERSETTINGS`, or `VIEWCLUSTERSETTINGS` privileges to view settings. - - If you have [enabled redaction of sensitive settings]({% link {{ page.version.version }}/cluster-settings.md %}#setting-server-redact-sensitive-settings-enabled), only users with `ADMIN` or `MODIFYCLUSTERSETTINGS` permissions can view values of settings CockroachDB classifies as `sensitive`. + - If you have [enabled redaction of sensitive settings]({% link v25.1/cluster-settings.md %}#setting-server-redact-sensitive-settings-enabled), only users with `ADMIN` or `MODIFYCLUSTERSETTINGS` permissions can view values of settings CockroachDB classifies as `sensitive`. - Users with `VIEWACTIVITY` or `VIEWACTIVITYREDACTED` roles can only access settings pertaining to the DB Console. This change provides consistent behavior across all methods of accessing cluster settings. [#139277][#139277] From 4bb2399c80075aa8d89c080dcd4270367efcc86c Mon Sep 17 00:00:00 2001 From: mikeCRL Date: Mon, 27 Jan 2025 16:55:45 -0500 Subject: [PATCH 4/6] Additional edits --- .../releases/v25.1/v25.1.0-alpha.1.md | 1 + .../releases/v25.1/v25.1.0-beta.2.md | 26 ++++--------------- 2 files changed, 6 insertions(+), 21 deletions(-) diff --git a/src/current/_includes/releases/v25.1/v25.1.0-alpha.1.md b/src/current/_includes/releases/v25.1/v25.1.0-alpha.1.md index 4d6c951e07b..9a1c7af4a42 100644 --- a/src/current/_includes/releases/v25.1/v25.1.0-alpha.1.md +++ b/src/current/_includes/releases/v25.1/v25.1.0-alpha.1.md @@ -113,6 +113,7 @@ Release Date: December 19, 2024 - Improved the internal caching logic for role membership information. This reduces the latency impact of commands such as `DROP ROLE`, `CREATE ROLE`, and `GRANT role TO user`, which cause the role membership cache to be invalidated. [#135852][#135852] - The session variable `plan_cache_mode` now defaults to `auto`, enabling generic query plans for some queries. [#135668][#135668] - GRPC streams are now pooled across unary intra-cluster RPCs, allowing for reuse of gRPC resources to reduce the cost of remote key-value layer access. This pooling can be disabled using the `rpc.batch_stream_pool.enabled` cluster setting. [#136648][#136648] + - This information was updated in the v25.1.0-beta.2 release notes.

Multi-tenancy

diff --git a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md index ba694cbf4ba..c23e4382d85 100644 --- a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md +++ b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md @@ -6,8 +6,9 @@ Release Date: January 27, 2025

SQL language changes

+- `DROP INDEX` is now labeled a [potentially unsafe SQL statement]({% link v25.1/cockroach-sql.md %}#allow-potentially-unsafe-sql-statements), so it can only be run when the `sql_safe_updates` session variable or `--safe_updates` flag is set to `false`. [#139505][#139505] - `SHOW JOBS` is now based on a new mechanism for storing information about the progress and status of running jobs. [#139230][#139230] -- `SHOW TENANT WITH REPLICATION STATUS` now displays the `ingestion_job_id` column after the `name` column. [#139275][#139275] +- `SHOW TENANT WITH REPLICATION STATUS` now includes an `ingestion_job_id` column that displays the ID of the Physical Cluster Replication (PCR) [ingestion job]({% link v25.1/physical-cluster-replication-monitoring.md %}). [#139275][#139275]

Operational changes

@@ -15,13 +16,8 @@ Release Date: January 27, 2025

DB Console changes

-- The DB Console Cluster Settings page and `/_admin/v1/settings` API now use the same authorization and redaction logic as `SHOW CLUSTER SETTINGS` and `crdb_internal.cluster_settings`: - - Users need `ADMIN`, `MODIFYCLUSTERSETTINGS`, or `VIEWCLUSTERSETTINGS` privileges to view settings. - - If you have [enabled redaction of sensitive settings]({% link v25.1/cluster-settings.md %}#setting-server-redact-sensitive-settings-enabled), only users with `ADMIN` or `MODIFYCLUSTERSETTINGS` permissions can view values of settings CockroachDB classifies as `sensitive`. - - Users with `VIEWACTIVITY` or `VIEWACTIVITYREDACTED` roles can only access settings pertaining to the DB Console. - - This change provides consistent behavior across all methods of accessing cluster settings. [#139277][#139277] -- The overload dashboard on DB Console now shows only the v2 replication admission control metrics, where previously it displayed both v1 and v2 metrics. Additionally, the aggregate size of queued replication entries is now shown. [#139566][#139566] +- The DB Console Cluster Settings page now uses the same redaction logic as `SHOW CLUSTER SETTINGS` when the setting `server.redact_sensitive_settings.enabled` is set to `true`. [#139277][#139277] +- The [Overload dashboard]({% link v25.1/ui-overload-dashboard.md %}) in DB Console now displays only V2 Replication Admission Control metrics, with no V2 label. Previously, it displayed both V1 and V2 metrics. Additionally, the aggregate size of queued replication entries is now displayed. [#139566][#139566]

Bug fixes

@@ -29,19 +25,7 @@ Release Date: January 27, 2025

Performance improvements

-- Rpc.batch_stream_pool.enabled now defaults to false. This supersedes an earlier release note. The cluster setting is currently experimental and not listed publicly. [#139481][#139481] - -

Miscellaneous

- -

Missing category

- -- DROP INDEX can now only be run when `sql_safe_updates` are set to false. [#139505][#139505] - -

Doc updates

- -{% comment %}Docs team: Please add these manually.{% endcomment %} - - +- The cluster setting `rpc.batch_stream_pool.enabled` now defaults to `false`. This supersedes an earlier release note. This cluster setting is experimental and is not listed as `public`. [#139481][#139481] [#139230]: https://github.com/cockroachdb/cockroach/pull/139230 [#139251]: https://github.com/cockroachdb/cockroach/pull/139251 From ff63f2d1be855b83c802cce322d1e187e1443b0c Mon Sep 17 00:00:00 2001 From: mikeCRL Date: Mon, 27 Jan 2025 17:01:51 -0500 Subject: [PATCH 5/6] Additional edits --- src/current/_includes/releases/v25.1/v25.1.0-beta.2.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md index c23e4382d85..139dce7dc5c 100644 --- a/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md +++ b/src/current/_includes/releases/v25.1/v25.1.0-beta.2.md @@ -16,8 +16,8 @@ Release Date: January 27, 2025

DB Console changes

-- The DB Console Cluster Settings page now uses the same redaction logic as `SHOW CLUSTER SETTINGS` when the setting `server.redact_sensitive_settings.enabled` is set to `true`. [#139277][#139277] -- The [Overload dashboard]({% link v25.1/ui-overload-dashboard.md %}) in DB Console now displays only V2 Replication Admission Control metrics, with no V2 label. Previously, it displayed both V1 and V2 metrics. Additionally, the aggregate size of queued replication entries is now displayed. [#139566][#139566] +- The DB Console Cluster Settings page now uses the same redaction logic as `SHOW CLUSTER SETTINGS` when the setting [`server.redact_sensitive_settings.enabled`]({% link v25.1/cluster-settings.md %}#setting-server-redact-sensitive-settings-enabled) is set to `true`. [#139277][#139277] +- The [Overload dashboard]({% link v25.1/ui-overload-dashboard.md %}) in DB Console now displays only V2 Replication Admission Control metrics and omits their previous V2 prefix. Previously, both V1 and V2 metrics were displayed. Additionally, the aggregate size of queued replication entries is now displayed. [#139566][#139566]

Bug fixes

From 34cb1d764c6e2653c2cffdd6601d3b1a5a73be93 Mon Sep 17 00:00:00 2001 From: mikeCRL Date: Mon, 27 Jan 2025 17:29:39 -0500 Subject: [PATCH 6/6] Revert branch for diagrams --- src/current/_data/versions.csv | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/current/_data/versions.csv b/src/current/_data/versions.csv index 278e4c377bd..45c9397872a 100644 --- a/src/current/_data/versions.csv +++ b/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,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,v24.3,release-24.3