docs icon indicating copy to clipboard operation
docs copied to clipboard

[DOC-10090][DOC-10093] v24.1.0 deprecations, backward-incompatible changes, licensing updates

Open mdlinville opened this issue 9 months ago • 6 comments

[DOC-10090] v24.1.0 deprecations and backward-incompatible changes [DOC-10093] v24.1.0 licensing updates

  • Also fix a display bug in v23.1.0 release notes

Relates to [DOC-10061]

Preview: releases/v24.1.md

mdlinville avatar May 09 '24 18:05 mdlinville

Files changed:

github-actions[bot] avatar May 09 '24 18:05 github-actions[bot]

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
Latest commit 7615fd97baab43457bf4d194e5a4546c34d81850
Latest deploy log https://app.netlify.com/sites/cockroachdb-interactivetutorials-docs/deploys/6647d70504e6e400088ee0cc

netlify[bot] avatar May 09 '24 18:05 netlify[bot]

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
Latest commit 7615fd97baab43457bf4d194e5a4546c34d81850
Latest deploy log https://app.netlify.com/sites/cockroachdb-api-docs/deploys/6647d705daa0020008db8a16

netlify[bot] avatar May 09 '24 18:05 netlify[bot]

Netlify Preview

Name Link
Latest commit 7615fd97baab43457bf4d194e5a4546c34d81850
Latest deploy log https://app.netlify.com/sites/cockroachdb-docs/deploys/6647d705864e1a00080766f2
Deploy Preview https://deploy-preview-18530--cockroachdb-docs.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

netlify[bot] avatar May 09 '24 18:05 netlify[bot]

Here's my suggested addition:

The `sql.txn.read_committed_isolation.enabled` [cluster setting]({% link {{ page.version.version }}/cluster-setting.md %}) is now `true` by default. [`READ COMMITTED`]({% link {{ page.version.version }}/read-committed.md %}) transactions are no longer automatically upgraded to [`SERIALIZABLE`]({% link {{ page.version.version }}/demo-serializable.md %}), and will run as `READ COMMITTED`. As a result, upgrading CockroachDB may affect your application behavior. To see whether any transactions are being upgraded from weaker isolation levels to `SERIALIZABLE` on v23.2, check the [**Upgrades of SQL Transaction Isolation Level**]({% link {{ page.version.version }}/ui-sql-dashboard.md %}#upgrades-of-sql-transaction-isolation-level) graph in the DB Console. You may need to adjust those transactions before upgrading to v24.1.

If this needs to be associated with a PR, I think this should be the one: https://github.com/cockroachdb/cockroach/pull/118479

See: https://github.com/cockroachdb/cockroach/pull/118497 and this comment for context

taroface avatar May 09 '24 20:05 taroface

Here's my suggested addition:

The `sql.txn.read_committed_isolation.enabled` [cluster setting]({% link {{ page.version.version }}/cluster-setting.md %}) is now `true` by default. [`READ COMMITTED`]({% link {{ page.version.version }}/read-committed.md %}) transactions are no longer automatically upgraded to [`SERIALIZABLE`]({% link {{ page.version.version }}/demo-serializable.md %}), and will run as `READ COMMITTED`. As a result, upgrading CockroachDB may affect your application behavior. To see whether any transactions are being upgraded from weaker isolation levels to `SERIALIZABLE` on v23.2, check the [**Upgrades of SQL Transaction Isolation Level**]({% link {{ page.version.version }}/ui-sql-dashboard.md %}#upgrades-of-sql-transaction-isolation-level) graph in the DB Console. You may need to adjust those transactions before upgrading to v24.1.

If this needs to be associated with a PR, I think this should be the one: cockroachdb/cockroach#118479

See: cockroachdb/cockroach#118497 and this comment for context

Thanks, PTAL, I took your wording and gave it a few nitpicky tweaks.

mdlinville avatar May 09 '24 23:05 mdlinville