How much time does it take to sync?
And so the syncing begins...
You've just pressed the "Start Syncing Now!" button at the bottom of your configuration page. At first glance, you think, "Is anything happening?" Or, "I just added/updated a contact, but the changes haven't been synced to the other app yet. Is PieSync working?"
If you've just activated PieSync or updated your configuration and see the icon load with text that says PieSync is scanning through your apps, telling you to "Grab a coffe while you wait," this means that PieSync is scanning every single one of your contacts in both applications - even if you're only choosing to just sync a subset!
After this scan, the synchronization will start!
Here you can read more about the different Health Dashboard states.
What types of syncs does PieSync run?
There are two types of syncs that PieSync runs--initial syncs and incremental syncs.
An initial sync is the state of a connection when:
- It has been activated for the very first time or
- There's been a reconfiguration and you click "Save and Resume Syncing" as the bottom of your configuration page.
During an initial sync, PieSync runs through all of the contacts in both apps, which takes longer to do than an incremental sync, which we speak to further below. For every single contact record in an initial sync, PieSync runs the "operation" you have in place.
Running the "operation" means that PieSync compares each contact against the combination of all of your connection rules, settings, and field mappings to see which ones meet the criteria in your configuration.
The larger your database, the longer the initial sync might take.
Once the initial sync is done and the connection is active, PieSync will scan your databases every 4-5 minutes for updates and creations, or run an incremental sync.
An incremental sync is the state of the connection when it's:
- Active and
- Only syncing new updates and creations.
This means that PieSync only runs your operation for each update to a contact, not all contacts all over again. If a contact has been kept in sync and has never been updated since then, this means PieSync only ran the operation on your contact the first time PieSync processed it.
PieSync nevers runs your operation more than once for each update on a contact because if it did, PieSync would create a sync loop. This means that PieSync would never stop syncing your contacts and the number of API calls it would make would skyrocket into infinity.
Because the load is much lighter, incremental syncs happen much faster than initial syncs.
This might be delayed if you have multiple connections set-up with the same account from the same app. To avoid conflicts, PieSync only activates one sync at a time so it might be waiting for the other sync to finish running first.
If either of these sync-types takes longer than 3 hours, be sure to contact PieSync Support at email@example.com!