Skip to content

Commit e9ac971

Browse files
authored
Move schema max object to 'backwards-incompatible' (#21016)
In the v25.4.0 release notes, `sql.schema.approx_max_object_count` was already listed under 'Key cluster settings changes', but as discussed on DOC-14949 this is a backwards-incompatible change, since it will prevent users of large clusters from creating schema objects after the upgrade until they modify this setting. Moving it to the 'Backwards-incompatible changes' section for higher visibility to lower the chance of an unpleasant surprise for users during upgrade. Addresses DOC-14949
1 parent ad54603 commit e9ac971

File tree

2 files changed

+6
-6
lines changed

2 files changed

+6
-6
lines changed

src/current/_includes/releases/v25.4/backward-incompatible.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,9 @@
22

33
Removed the `bulkio.backup.deprecated_full_backup_with_subdir.enabled` cluster setting. This optional ability to specify a target subdirectory with the `BACKUP` command when creating a full backup was deprecated in v22.1. [#153628][#153628]
44

5-
[#153628]: https://github.com/cockroachdb/cockroach/pull/153628
5+
- `sql.schema.approx_max_object_count` (default: `20000`)
6+
7+
Added cluster setting `sql.schema.approx_max_object_count` to prevent creation of new schema objects when the limit is exceeded. The check uses cached table statistics for performance and is approximate - it may not be immediately accurate until table statistics are updated by the background statistics refreshing job. Clusters that have been running stably with a larger object count should raise the limit or disable the limit by setting the value to `0`. In future releases, the default value for this setting will be raised as more CockroachDB features support larger object counts. [#154576][#154576]
8+
9+
[#153628]: https://github.com/cockroachdb/cockroach/pull/153628
10+
[#154576]: https://github.com/cockroachdb/cockroach/pull/154576

src/current/_includes/releases/v25.4/cluster-setting-changes.md

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,6 @@ Changes to [cluster settings]({% link v25.4/cluster-settings.md %}) should be re
2020

2121
Added a cluster setting (`sql.log.scan_row_count_misestimate.enabled`) that enables logging a warning on the gateway node when optimizer estimates for scans are inaccurate. The log message includes the table and index being scanned, the estimated and actual row counts, the time since the last table stats collection, and the table's estimated staleness. [#155123][#155123]
2222

23-
- `sql.schema.approx_max_object_count` (default: `20000`)
24-
25-
Added cluster setting `sql.schema.approx_max_object_count` (default: 20,000) to prevent creation of new schema objects when the limit is exceeded. The check uses cached table statistics for performance and is approximate - it may not be immediately accurate until table statistics are updated by the background statistics refreshing job. Clusters that have been running stably with a larger object count should raise the limit or disable the limit by setting the value to 0. In future releases, the default value for this setting will be raised as more CockroachDB features support larger object counts. [#154576][#154576]
26-
2723
- `sql.stats.error_on_concurrent_create_stats.enabled` (default: `true`)
2824

2925
Introduced the cluster setting `sql.stats.error_on_concurrent_create_stats.enabled`, which modifies how CockroachDB reacts to concurrent auto stats jobs. The default, `true`, maintains the previous behavior. Setting `sql.stats.error_on_concurrent_create_stats.enabled` to `false` will cause the concurrent auto stats job to be skipped with just a log entry and no increased error counters. [#149538][#149538]
@@ -80,6 +76,5 @@ Changes to [cluster settings]({% link v25.4/cluster-settings.md %}) should be re
8076
[#153628]: https://github.com/cockroachdb/cockroach/pull/153628
8177
[#154459]: https://github.com/cockroachdb/cockroach/pull/154459
8278
[#154491]: https://github.com/cockroachdb/cockroach/pull/154491
83-
[#154576]: https://github.com/cockroachdb/cockroach/pull/154576
8479
[#155123]: https://github.com/cockroachdb/cockroach/pull/155123
8580
[#155561]: https://github.com/cockroachdb/cockroach/pull/155561

0 commit comments

Comments
 (0)