You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/_includes/content/how-a-sync-works.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
When Segment loads data into your warehouse, each sync goes through the following steps:
2
-
1.**Ping:** Segment servers connect to your warehouse. For Redshift warehouses, Segment also runs a query to determine how many slices a cluster has. <br/>Common reasons a sync would fail at this step include a blocked VPN/IP, a warehouse that isn't publicly available, and user permission/credential errors.
2
+
1.**Ping:** Segment servers connect to your warehouse. For Redshift warehouses, Segment also runs a query to determine how many slices a cluster has.
3
3
2.**Scan:** Segment finds new events in AWS S3 and updated objects in Dynamo.
4
4
3.**Download:** Segment pulls the events and objects into a staging area.
5
5
4.**Process:** The raw Segment event and object archive files are transformed into database-specific formats. The [warehouse schema](/docs/connections/storage/warehouses/schema/) is also defined in this step.
Copy file name to clipboardExpand all lines: src/connections/storage/warehouses/faq.md
+22-1Lines changed: 22 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -95,10 +95,31 @@ After a source is created, you can enable or disable a warehouse sync within the
95
95
96
96
## Can I be notified on warehouse sync failures?
97
97
98
+
You will recieve notifications in the Segment app for warehouse sync failiures.
99
+
100
+
To view the notifications:
101
+
1.
102
+
98
103
## How is my data formatted in my warehouse?
99
104
105
+
Data in your warehouse is formatted into **schemas**, which involve a detailed description of database elements (tables, views, indexes, synonyms, etc.) and the relationships that exist between elements. Segment's schemas use the following template: <br/>`<source>.<collection>.<property>`, for example, `segment-engineering.tracks.userId`, where Source refers to the source or project name (segment-engineering), collection refers to the event (tracks), and the property refers to the data being collected (userId). For more information about Warehouse Schemas, see the [Warehouse Schemas](/docs/connections/storage/warehouses/schema) page.
106
+
100
107
## If my syncs fail and get fixed, will I need to ask for a backfill?
101
108
102
-
Yes! If your syncs fail, you will need to ask for a backfill, as this is a manual process.
109
+
If your syncs fail, you will need to reach out to [Segment Support](https://segment.com/help/) to ask for a backfill. Be sure to include the following information in your request:
110
+
- The warehouse that requires the backfill
111
+
- What sources you need information from
112
+
- The timeframe of data that requires a backfill
103
113
104
114
## Can I change my schema names once they've been created?
115
+
116
+
If you'd like to change the name of your schema:
117
+
118
+
1. Open the Segment app.
119
+
2. Select your warehouse from the Sources tab.
120
+
3. On the source's overview page, select "Settings."
121
+
4. Under the "Enable Source" section, disable your warehouse and click "Save Changes."
122
+
5. Select the "SQL Settings" tab.
123
+
6. Update the "Schema Name" field with your intended schema name and click "Save Changes."
124
+
7. On the source's overview page, select "Basic."
125
+
8. Under the "Enable Source" section, disable your warehouse and click "Save Changes."
Copy file name to clipboardExpand all lines: src/connections/storage/warehouses/schema.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ Schemas of warehouse data are organized into the following template: <br/>
8
8
`<source>.<collection>.<property>` eg. `segment-engineering.tracks.userId`, where Source refers to the source or project name (segment-engineering), collection refers to the event (tracks), and the property refers to the data being collected (userId).
9
9
10
10
> note "Data warehouse column creation"
11
-
> **Note:** Segment creates tables for each of your custom events, and columns for each event's custom properties. Segment does not allow unbounded `event` or `property` spaces in your data. Instead of recording events like "Ordered Product 15", use a single property of "Product Number" or similar.
11
+
> **Note:** Segment creates tables for each of your custom events in your warehouse, with columns for each event's custom properties. Segment does not allow unbounded `event` or `property` spaces in your data. Instead of recording events like "Ordered Product 15", use a single property of "Product Number" or similar.
0 commit comments