Skip to content

Updating public docs with Reverse-ETL DB2 source setup guide #7664

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 25 commits into from
Jun 23, 2025
Merged
Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
ded4a49
add db2 to supported retl sources
gilsegment Jun 6, 2025
53a2fc0
add db2 setup guide
gilsegment Jun 6, 2025
0fb8cb6
[netlify-build]
gilsegment Jun 6, 2025
efae4b2
[netlify-build] add DB2 source to dropdown menu
gilsegment Jun 7, 2025
cd96a3a
[netlify-build] small fixes
gilsegment Jun 8, 2025
9f68558
[netlify-build] more fixes
gilsegment Jun 9, 2025
11ab780
Update src/_data/sidenav/main.yml
gilsegment Jun 11, 2025
1dcbf58
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
73240ca
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
3c5c38c
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
7086a9f
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
fab1552
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
b98e62f
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
395ae0f
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
41f68c7
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
6703997
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
7eeb28c
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
81e188c
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
d8a752c
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
b7b8003
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
f1cb559
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
c036ce8
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
66ee83d
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
d118797
Update src/connections/reverse-etl/reverse-etl-source-setup-guides/db…
gilsegment Jun 11, 2025
f1a05db
Update src/connections/reverse-etl/setup.md
gilsegment Jun 11, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions src/_data/sidenav/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,8 @@ sections:
title: BigQuery Reverse ETL Setup
- path: /connections/reverse-etl/reverse-etl-source-setup-guides/databricks-setup
title: Databricks Reverse ETL Setup
- path: /connections/reverse-etl/reverse-etl-source-setup-guides/db2-setup
title: DB2 Reverse ETL Setup
- path: /connections/reverse-etl/reverse-etl-source-setup-guides/postgres-setup
title: Postgres Reverse ETL Setup
- path: /connections/reverse-etl/reverse-etl-source-setup-guides/redshift-setup
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: DB2 Reverse ETL Setup
---

Set up DB2 as your Reverse ETL source.

At a high level, when you set up DB2 for Reverse ETL, the configured database user must have read permissions on any tables involved in the query, and write permissions on a managed schema (`SEGMENT_REVERSE_ETL`) that Segment uses to track sync progress. Authentication is handled through username and password credentials configured in the Segment app.



## Required 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).
* **Permission to create and manage a schema** for tracking sync metadata.
* **Permission to create tables in the database**, needed for internal metadata tables.


> info "Use a dedicated user for Segment"
> It's recommended to create a dedicated DB2 user for Segment with access limited to only the relevant schemas and tables.

1. In IBM Cloud, go to your DB2 instance and navigate to **Administration > User management**.
2. Click **Add**.
3. Create a new user with *user* privileges. Make sure to save the username and password—these are needed to configure the Segment
source connection later.


> info ""
> The `SEGMENT_REVERSE_ETL` schema will be created and managed by Segment to track the status of each sync.
> You can also choose to create this schema yourself by running:
> `CREATE SCHEMA SEGMENT_REVERSE_ETL`
> Then grant Segment the appropriate privileges.



Run the following SQL commands to grant Segment the required permissions:

```sql
-- Grant permissions to create and manage objects within the SEGMENT_REVERSE_ETL schema
GRANT CREATEIN, DROPIN ON SCHEMA SEGMENT_REVERSE_ETL TO USER <username>;

-- Grant permission to create tables in the database
GRANT CREATETAB ON DATABASE TO USER <username>;

-- Grant read access on each table used in the model
GRANT SELECT ON TABLE <schema_name>.<table_name> TO USER <username>;
-- Repeat the above command for all tables involved in your model
```


## Set Up Guide

To set up DB2 as your Reverse ETL source:

1. Make sure your DB2 database is network-accessible from [Segment's IPs](/docs/connections/storage/warehouses/faq/#which-ips-should-i-allowlist).
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**.
6. Fill in the DB2 connection settings:
* Hostname: `<hostname>`
* Port: `<port>`
* Database: `<db_name>`
* Username: `<segment_db2_user>`
* Password: `<password>`
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.
1 change: 1 addition & 0 deletions src/connections/reverse-etl/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
- [Postgres Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/postgres-setup)
- [Redshift Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/redshift-setup)
- [Snowflake Reverse ETL setup guide](/docs/connections/reverse-etl/reverse-etl-source-setup-guides/snowflake-setup)
Expand Down