Skip to main content
In the case of Postgres, PowerSync cannot replicate Postgres foreign tables. However, PowerSync does have options available to support sharded databases in general.
When using MongoDB, MySQL, or SQL Server as the backend source database, PowerSync does not currently support connecting to sharded clusters.
The primary options are:
  1. Use a separate PowerSync Service instance per database.
  2. Add a connection for each database in the same PowerSync Service instance (planned; this capability will be available in a future release).
Where feasible, using separate PowerSync Service instances would give better performance and give more control over how changes are rolled out, especially around Sync Rule reprocessing. Some specific scenarios:

​
1. Different Tables on Different Databases

This is common when separate “services” use separate databases, but multiple tables across those databases need to be synced to the same users. Use a single PowerSync Service instance, with a separate connection for each source database (planned; this capability will be available in a future release). Use a unique connection tag for each source database, allowing them to be distinguished in your Sync Streams or Sync Rules.

​
2a. All Data for a Single Customer Is Contained in a Single Shard

This is common when sharding per customer account / organization. In this case, use a separate PowerSync Service instance for each database.

​
2b. Most Customer Data Is in a Single Shard, but Some Data Is in a Shared Database

If the amount of shared data is small, still use a separate PowerSync Service instance for each database, but also add the shared database connection to each PowerSync Service instance using a separate connection tag (planned; this capability will be available in a future release).

​
2c. Data for a Single Customer Is Split Across Multiple Shards

This is more complicated than the other cases listed above. Please reach out to us if this is your architecture.

​
3. Only Some Tables Are Sharded

In some cases, most tables would be on a shared server, with only a few large tables being sharded. For this case, use a single PowerSync Service instance. Add each shard as a new connection on this instance (planned; this capability will be available in a future release) — all with the same connection tag, so that the same Sync Streams or Sync Rules applies to each.