citusdata / citus_docs

Documentation for Citus. Distributed PostgreSQL as an extension.
Creative Commons Attribution 4.0 International
58 stars 59 forks source link

Talk more about the threshold parameter of rebalance_table_shards() #844

Open begriffs opened 5 years ago

begriffs commented 5 years ago

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

marcocitus commented 5 years ago

The default is 0 since 7.4

begriffs commented 5 years ago

@marcocitus thanks for pointing that out. @saicitus we should talk about what, if anything, we still want say about the threshold.