citusdata / citusdata/citus_docs

Talk more about the threshold parameter of rebalance_table_shards()

Open
#844 2 comments 0 reactions 0 assignees View on GitHub
blocked SE
Dominant language
CSS
Stars
58
Forks
60
PR merge metrics
No merged PRs in 30d

Description

## Communication goals (e.g. detailed howto vs orientation)

The parameter controls how precisely balanced shards should become. A value of 0.0 means perfectly balanced, but that takes more work by the rebalancer. The default is 0.1. It surprises some people when they see the imbalance, so we should update our examples to specify the threshold.

We should also mention the default value in our reference section if it doesn't already.

### Good locations for content in docs structure

* http://docs.citusdata.com/en/v8.1/admin_guide/cluster_management.html#rebalance-shards-without-downtime

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.