Skip to content

Commit 5dcdbfe

Browse files
authored
Improve structure (#83)
1 parent d63b3ef commit 5dcdbfe

File tree

1 file changed

+13
-20
lines changed

1 file changed

+13
-20
lines changed

resources/usage-and-billing-faq.mdx

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -70,39 +70,32 @@ The most common cause of seeing excessive concurrent connections is opening mult
7070

7171
## Sync operations
7272

73-
While sync operations typically correspond to data mutations on synced rows (those in your Sync Rules), there are several scenarios that can increase your operation count:
73+
While sync operations typically correspond to data mutations on synced rows (those in your Sync Rules), there are several scenarios that can affect your operation count:
7474

7575
### Key Scenarios to Watch For
7676

77-
1. **New App Installations**
77+
1. **New App Installations:**
7878
When a new user installs your app, PowerSync needs to sync the complete operations history. We help manage this by:
7979
- Running automatic daily compacting on Cloud instances
8080
- Providing manual defragmentation options (in the PowerSync Dashboard)
8181

82-
2. **Existing Users**
82+
2. **Existing Users:**
8383
While compacting and defragmenting reduces the operations history, they trigger additional sync operations for existing users.
8484
- Want to optimize this? Check out our [defragmenting guide](/usage/lifecycle-maintenance/compacting-buckets#defragmenting-trade-offs)
8585

86-
### How do Sync Rule deployments impact sync operations?
86+
3. **Sync Rule Deployments:**
87+
When you deploy changes to Sync Rules, PowerSync recreates the sync buckets from scratch. This has two effects:
88+
- New app installations will sync fewer operations since the operations history is reset.
89+
- Existing users will temporarily experience increased sync operations as they need to re-sync the updated buckets.
8790

88-
When you deploy changes to Sync Rules, PowerSync recreates the sync buckets from scratch. This has two effects:
89-
1. New app installations will sync fewer operations since the operations history is reset.
90-
2. Existing users will temporarily experience increased sync operations as they need to re-sync the updated buckets.
91+
We are planning [incremental sync rule reprocessing](https://roadmap.powersync.com/c/85-more-efficient-sync-reprocessing), which will allow PowerSync to only reprocess buckets whose definitions have changed, rather than all buckets.
92+
4. **Unsynced Columns:**
93+
Any row update triggers a new operation in the logical replication stream, regardless of which columns changed. In other words, PowerSync tracks changes at the row level, not the column level. This means:
9194

92-
We are planning [incremental sync rule reprocessing](https://roadmap.powersync.com/c/85-more-efficient-sync-reprocessing), which will allow PowerSync to only reprocess buckets whose definitions have changed, rather than all buckets.
95+
- Updates to columns not included in your Sync Rules still create sync operations.
96+
- Even a no-op update like `UPDATE mytable SET id = id` generates a new operation for each affected row.
9397

94-
### Do updates to unsynced columns trigger sync operations?
95-
96-
Yes. Any row update triggers a new operation in the logical replication stream, regardless of which columns changed. This means:
97-
98-
- Updates to columns not included in your Sync Rules still create sync operations.
99-
- Even a no-op update like `UPDATE mytable SET id = id` generates a new operation for each affected row.
100-
101-
While selectively syncing columns helps with:
102-
- Data access control
103-
- Reducing data transfer size
104-
105-
It doesn't reduce the number of sync operations. PowerSync tracks changes at the row level, not the column level.
98+
While selectively syncing columns helps with data access control and reducing data transfer size, it doesn't reduce the number of sync operations.
10699

107100
## Data hosted
108101

0 commit comments

Comments
 (0)