Skip to content

Commit bc22194

Browse files
authored
Merge pull request #4687 from segmentio/Selective-Sync
Add Selective Sync content
2 parents b0536d4 + ab9b121 commit bc22194

File tree

1 file changed

+29
-1
lines changed

1 file changed

+29
-1
lines changed

src/unify/profiles-sync/index.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,15 +71,43 @@ Follow these steps to connect your warehouse:
7171
4. Segment prompts you to enter specific warehouse credentials. Enter them, then select **Test Connection**.
7272
5. If the connection test succeeds, Segment enables the **Next** button. Select it.
7373
* If the connection test fails, verify that you’ve correctly entered the warehouse credentials, then try again.
74-
6. Select **Next** on the **Sync schedule** page. Segment displays the Profiles Sync overview page.
74+
6. Set up a **Sync Schedule**, and select **Next**.
75+
7. From the [Set Selective Sync](#using-selective-sync) page, select the tables and columns you'd like to sync and click **Next**. Segment displays the Profiles Sync overview page.
7576
7. Select **Request sync to be enabled**.
7677

7778
Segment staff then receives and enables live sync for your account.
7879

80+
#### Using Selective Sync
81+
82+
Use Selective Sync to manage the data you send to your warehouses by choosing which tables and columns (also known as properties) to sync. Syncing fewer tables and properties will lead to faster and more frequent syncs, faster queries, and using less disk space.
83+
84+
You can access Selective Sync in two ways:
85+
- From the Set Selective Sync page as you connect your warehouse to Profiles Sync.
86+
- From the Profiles Sync settings (**Profiles Sync** > **Settings** > **Selective sync**).
87+
88+
You'll see a list of event type tables, event tables, and properties available to sync. Select the tables and properties that you'd like to sync, and be sure the ones you'd like to prevent from syncing aren't selected.
89+
90+
Regardless of schema size, only the first 5,000 collections and 5,000 properties per collection can be managed using your Segment space. To edit Selective Sync settings for any collection which exceeds this limit, [contact Segment support](https://app.segment.com/workspaces?contact=1){:target="blank"}.
91+
92+
> warning ""
93+
> Profiles Sync will always sync the External ID Mapping and ID Graph Updates tables. These tables can't be disabled with Selective Sync.
94+
95+
> info ""
96+
> You must be a workspace owner to change Selective Sync settings.
97+
98+
#### When to use Selective Sync
99+
100+
By default, Segment syncs all tables and properties to your warehouse. Use Selective Sync when you'd like to prevent specific tables and properties from syncing to your warehouse. Segment stops syncing from disabled tables or properties, but will not delete any historical data from your warehouse.
101+
102+
If you choose to re-enable a table or property to sync again, only new data generated will sync to your warehouse. Segment doesn't backfill data that was omitted with Selective Sync.
103+
79104
#### Using historical backfill
80105

81106
Profiles Sync sends profiles to your warehouse on an hourly basis, beginning after you complete setup. You can use backfill, however, to sync historical profiles to your warehouse, as well.
82107

108+
> info ""
109+
> You can only use historical backfill for tables that you enable with [Selective Sync](#using-selective-sync) during setup. Segment does not backfill tables that you disable with Selective Sync.
110+
83111
When Segment runs historical backfills:
84112

85113
- The `id_graph_updates` and `external_id_mapping_updates` tables sync your entire historical data to your warehouse.

0 commit comments

Comments
 (0)