diff --git a/README.md b/README.md index 577c254..d7217e9 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ Okay, this is just basic stuff, but we support cancelling queries. If you know t this might be relevant given than this is a transactional pooler but if you're new to Pg, don't worry about it, it works. ### Round-robin load balancing -This is the novel part. PgBouncer doesn't support it and suggests we use DNS of a TCP proxy instead. +This is the novel part. PgBouncer doesn't support it and suggests we use DNS or a TCP proxy instead. We prefer to have everything as part of one package; arguably, it's easier to understand and optimize. This pooler will round-robin between multiple replicas keeping load reasonably even. @@ -64,10 +64,16 @@ failing over could bring even more load and tip over the remaining healthy-ish r either lose 1/x of your traffic or risk losing it all eventually. Ideally you overprovision your system, so you don't necessarily need to make this choice :-). +### Sharding +We're implemeting Postgres' `PARTITION BY HASH` sharding function for `BIGINT` fields. This works well for tables that use `BIGSERIAL` primary key which I think is common enough these days. We can also add many more functions here, but this is a good start. See `src/sharding.rs` and `tests/sharding/setup.sql` for more details on the implementation. + +The biggest advantage of using this sharding function is that anyone can shard the dataset using Postgres partitions +while also access it for both reads and writes using this pooler. No custom obscure sharding function is needed and database sharding can be done entirely in Postgres. + ## Missing -1. Sharding. Soon :-). +1. Query routing based on shard. 2. Authentication, ehem, this proxy is letting anyone in at the moment. ## Benchmarks