Skip to content

Conversation

@ddhodge
Copy link
Contributor

@ddhodge ddhodge commented Nov 25, 2025

In 2025.2.0 for new cluster deployed via yugabyted/YBA/Aeon, new flag defaults for:

  • Read Committed yb_enable_read_committed_isolation = true
  • CBO yb_enable_cbo=on
  • Enable Auto Analyze "ysql_enable_auto_analyze" : "true"
  • Bitmap scans yb_enable_bitmapscan=true
  • parallel append yb_enable_parallel_append=true

See also #29514

@ddhodge ddhodge self-assigned this Nov 25, 2025
@ddhodge ddhodge added the area/documentation Documentation needed label Nov 25, 2025
@github-project-automation github-project-automation bot moved this to In progress in Documentation Nov 25, 2025
@netlify
Copy link

netlify bot commented Nov 25, 2025

Deploy Preview for infallible-bardeen-164bc9 ready!

Name Link
🔨 Latest commit 87ea435
🔍 Latest deploy log https://app.netlify.com/projects/infallible-bardeen-164bc9/deploys/692897f8db4e6e0008ee905c
😎 Deploy Preview https://deploy-preview-29478--infallible-bardeen-164bc9.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 project configuration.

@ddhodge ddhodge changed the title [DOC-1080] Updated defaults for EPCM flags [DOC-1080][2025.2] Updated defaults for EPCM flags Nov 26, 2025
@ddhodge ddhodge requested a review from pkj415 November 26, 2025 16:55

For new universes running v2025.2 or later, Read Committed is enabled by default when you deploy using yugabyted, YugabyteDB Anywhere, or YugabyteDB Aeon.

In versions of YugabyteDB prior to v2025.2, or for manually deployed universes, `yb_enable_read_committed_isolation` is `false` (the default), and the Read Committed isolation level of YugabyteDB's transactional layer falls back to the stricter Snapshot isolation. This makes the default isolation level for the YSQL API effectively Snapshot because Read Committed, which is the YSQL API and PostgreSQL syntactic default, maps to Snapshot isolation.
Copy link
Contributor

@pkj415 pkj415 Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we also mention here that upgrading to a version >= 2025.2 will not change the default?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nvm, the "For new universes" part clarifies it


For new YSQL deployments, or when migrating from another system, to enable CBO, add the parameter to [ysql_pg_conf_csv](../../reference/configuration/yb-tserver/#ysql-pg-conf-csv) as follows:
For new universes running v2025.2 or later, CBO is enabled by default when you deploy using yugabyted, YugabyteDB Anywhere, or YugabyteDB Aeon.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we also mention that upgrading to >= 2025.2 will not enable cbo automatically if it was off?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nvm, the "For new universes" part clarifies it

For new universes running v2025.2 or later, parallel append is enabled by default when you deploy using yugabyted, YugabyteDB Anywhere, or YugabyteDB Aeon.

In addition, when upgrading a deployment to v2025.2 or later, if the universe has the cost-based optimizer enabled (`on`), YugabyteDB will enable parallel append.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we also mention that upgrading to a version >= 2025.2 will not automatically enable parallel append if it was off earlier

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nvm, the "For new universes" part clarifies it

To enable Read Committed isolation, set the YB-TServer flag [yb_enable_read_committed_isolation](../../../reference/configuration/yb-tserver/#yb-enable-read-committed-isolation) to `true`. By default this flag is `false` and in this case the Read Committed isolation level of the YugabyteDB transactional layer falls back to the stricter Snapshot isolation (in which case `READ COMMITTED` and `READ UNCOMMITTED` of YSQL also in turn use Snapshot isolation).
Read Committed is supported only if the YB-TServer flag `yb_enable_read_committed_isolation` is set to `true`.

For new universes running v2025.2 or later, Read Committed is enabled by default when you deploy using yugabyted, YugabyteDB Anywhere, or YugabyteDB Aeon.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we also mention here that upgrading to a version >= 2025.2 will not change the default?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nvm, the "For new universes" part clarifies it

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Documentation needed

Projects

Status: In progress

Development

Successfully merging this pull request may close these issues.

2 participants