Updating public docs with Reverse-ETL DB2 source setup guide #7664
+73
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
gilsegment
force-pushed
the
db2SourceSetup
branch
from
7f4e3c4 to
53a2fc0
Compare
✅ Deploy Preview for segment-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
gilsegment
changed the title
prayansh
previously approved these changes
Jun 10, 2025
There was a problem hiding this comment.
Pull Request Overview
This PR adds official documentation for configuring DB2 as a Reverse ETL source.
- Adds a link to the new DB2 setup guide in the main Reverse ETL setup page
- Introduces
db2-setup.mdwith required permissions and step-by-step instructions - Updates the sidebar navigation to include the DB2 guide
Reviewed Changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| src/connections/reverse-etl/setup.md | Added a link to the DB2 Reverse ETL setup guide |
| src/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup.md | Created the DB2 Reverse ETL setup guide |
| src/_data/sidenav/main.yml | Inserted the DB2 Reverse ETL entry in the sidebar |
Comments suppressed due to low confidence (2)
src/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup.md:29
- The empty info directive lacks a title and may not render correctly; either supply a descriptive title or remove the empty info block.
> info ""
src/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup.md:5
- [nitpick] Consider adding the supported DB2 server versions or required driver versions at the top of this guide to help users verify compatibility.
Set up DB2 as your Reverse ETL source.
src/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup.md
Outdated
Show resolved
Hide resolved
src/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup.md
Outdated
Show resolved
Hide resolved
src/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup.md
Outdated
Show resolved
Hide resolved
|
|
||
| ## Required permissions | ||
|
|
||
| In order to run a Reverse ETL sync in a DB2 warehouse, Segment needs the following permissions: |
There was a problem hiding this comment.
Suggested change
| In order to run a Reverse ETL sync in a DB2 warehouse, Segment needs the following permissions: | |
| In order to run a Reverse ETL sync in your Db2 warehouse, you'll create a user with the following permissions: |
|
|
||
| In order to run a Reverse ETL sync in a DB2 warehouse, Segment needs the following permissions: | ||
|
|
||
| * **Permission to read from all tables used in the model** (i.e., the tables included in your SELECT query). |
There was a problem hiding this comment.
Suggested change
| * **Permission to read from all tables used in the model** (i.e., the tables included in your SELECT query). | |
| * **Permission to read from all tables used in the model**: The user must be able to access all tables included in your SELECT query. |
| 2. Open [your Segment workspace](https://app.segment.com/workspaces){:target="_blank"}. | ||
| 3. Navigate to **Connections > Sources** then select the **Reverse ETL** tab. | ||
| 4. Click **+ Add Reverse ETL source**. | ||
| 5. Select **DB2** and click **Add Source**. |
There was a problem hiding this comment.
Is this DB2 or Db2 in the UI?
Suggested change
| 5. Select **DB2** and click **Add Source**. | |
| 5. Select **Db2** and click **Add Source**. |
| 3. Navigate to **Connections > Sources** then select the **Reverse ETL** tab. | ||
| 4. Click **+ Add Reverse ETL source**. | ||
| 5. Select **DB2** and click **Add Source**. | ||
| 6. Fill in the DB2 connection settings: |
There was a problem hiding this comment.
Suggested change
| 6. Fill in the DB2 connection settings: | |
| 6. Fill in the following Db2 connection settings: |
| 7. Click **Test Connection** to validate the setup. | ||
| 8. If the connection is successful, click **Add source**. | ||
|
|
||
| After successfully adding your DB2 source, [add a model](/docs/connections/reverse-etl/setup/#step-2-add-a-model) and follow the rest of the steps in the Reverse ETL setup guide. |
There was a problem hiding this comment.
Suggested change
| After successfully adding your DB2 source, [add a model](/docs/connections/reverse-etl/setup/#step-2-add-a-model) and follow the rest of the steps in the Reverse ETL setup guide. | |
| After successfully adding your Db2 source, [add a model](/docs/connections/reverse-etl/setup/#step-2-add-a-model) and follow the rest of the steps in the Reverse ETL setup guide. |
| @@ -28,6 +28,7 @@ To add your warehouse as a source: | |||
| - [Azure Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/azure-setup) | |||
| - [BigQuery Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/bigquery-setup) | |||
| - [Databricks Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/databricks-setup) | |||
| - [DB2 Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup) | |||
There was a problem hiding this comment.
Suggested change
| - [DB2 Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup) | |
| - [Db2 Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup) |
Co-authored-by: forstisabella <[email protected]>
…2-setup.md Co-authored-by: forstisabella <[email protected]>
…2-setup.md Co-authored-by: forstisabella <[email protected]>
…2-setup.md Co-authored-by: forstisabella <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Ticket
https://twilio-engineering.atlassian.net/browse/RETL-1858
Proposed changes
Adding new DB2 source to Reverse-ETL
Merge timing
TBD