Skip to content

Commit ac0027e

Browse files
Apply suggestions from code review
1 parent d0cf11d commit ac0027e

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

src/guides/how-to-guides/import-historical-data.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ When transitioning over to Segment, customers commonly want to import historical
99
## Method 1: Using a Custom Solution
1010

1111
### General Instructions
12-
Use any [server-side library](https://segment.com/docs/connections/sources/#server), which sends requests in batches to improve performance. Once you have data to import, follow the steps below:
12+
Use any [server-side library](/docs/connections/sources/#server), which sends requests in batches to improve performance. Once you have data to import, follow the steps below:
1313

1414
1. Export or collect the data to be imported.
1515

@@ -28,9 +28,9 @@ Use any [server-side library](https://segment.com/docs/connections/sources/#ser
2828

2929
3. Once you've done that, you'll need to write an application or worker to send the data to Segment.
3030

31-
You will need to cycle through each set of data and map it to a Segment server-side library method or build an array matching the [HTTP Import API format](https://segment.com/docs/connections/sources/catalog/libraries/server/http/#import).
31+
You will need to cycle through each set of data and map it to a Segment server-side library method or build an array matching the [HTTP Import API format](/docs/connections/sources/catalog/libraries/server/http/#import).
3232

33-
**Tip**: We recommend using a Segment library for this process, as they will set contextual message fields like `message_id` (used for deduping) and `sent_at` (used for correctly client clock skew) that our API will use to ensure correct behavior upon ingestion.
33+
**Tip**: Segment recommends using a Segment library for this process, as they set contextual message fields like `message_id` (used for deduping) and `sent_at` (used for correctly client clock skew) that Segment's API uses to correct behavior upon ingestion.
3434
3535
**Tip**: The server-side libraries will automatically batch requests to optimize for performance and prevent linear request volume. This batching behavior is modifiable, and some of the underlying libraries implement a configurable max queue size that may discard messages if you enqueue requests much faster than the client can flush them. We recommend overriding the max queue size parameter for the library to a high value you're comfortable you can remain under in your batch job.
3636

@@ -47,10 +47,10 @@ Additionally, one of Segment's Software Engineers developed a React App with mor
4747
[MarketLytics](http://marketlytics.com/){:target="_blank"} has documented their experience using the alpha prototype importer and offer some [helpful visuals and tips](http://marketlytics.com/blog/import-historic-data-to-segment){:target="_blank"}.
4848
4949
### Alternative solution
50-
If a server-side library doesn't meet your needs, you can use the Segment [bulk import HTTP API](https://segment.com/docs/connections/sources/catalog/libraries/server/http/#import) directly.
50+
If a server-side library doesn't meet your needs, you can use the Segment [bulk import HTTP API](/docs/connections/sources/catalog/libraries/server/http/#import) directly.
5151

52-
**Note:** When the historical data were initially exported by Segment, we recommend removing all the original `sent_at`, `message_id`, and `project_id` fields from the archived message before forwarding them to Segment.
52+
**Note:** When you use the HTTP API to export historical data to upload to Segment, remove all the original `sent_at``message_id`, and `project_id` fields from the archived message before forwarding them back to Segment.
5353

5454
## Method 2: Using Reverse ETL
5555

56-
Please refer to the [Reverse ETL guide](https://segment.com/docs/connections/reverse-etl/){:target="_blank"} for more details.
56+
Please refer to the [Reverse ETL guide](/docs/connections/reverse-etl/){:target="_blank"} for more details.

0 commit comments

Comments
 (0)