Skip to content

Commit 98115cf

Browse files
committed
add extensions docs
1 parent ab0104f commit 98115cf

File tree

5 files changed

+25
-5
lines changed

5 files changed

+25
-5
lines changed

src/connections/reverse-etl/reverse-etl-source-setup-guides/bigquery-setup.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,9 @@ To set up the Segment BigQuery connector:
3030

3131
After you've added BigQuery as a source, you can [add a model](/docs/connections/reverse-etl#step-2-add-a-model).
3232

33+
> info "BigQuery Reverse ETL sources support Segment's dbt extension"
34+
> If you have an existing dbt account with a Git repository, you can use [Segment's dbt extension](/docs/segment-app/extensions/dbt/) to centralize model management and versioning, reduce redundancies, and run CI checks to prevent breaking changes.
35+
3336
## Constructing your own role or policy
3437
When you construct your own role or policy, Segment needs the following permissions:
3538

src/connections/reverse-etl/reverse-etl-source-setup-guides/databricks-setup.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,10 @@ title: Databricks Reverse ETL Setup
44

55
Set up Databricks as your Reverse ETL source.
66

7-
At a high level, when you set up Databricks for Reverse ETL, the configured service-principal needs read permissions for any resources (databases, schemas, tables) the query needs to access. Segment keeps track of changes to your query results with a managed schema (`__SEGMENT_REVERSE_ETL`), which requires the configured service-principal to allow write permissions for that schema.
8-
9-
> info ""
10-
> Segment supports only OAuth (M2M) authentication. To generate a client ID and Secret, follow the steps listed in Databricks' [OAuth machine-to-machine (M2M) authentication](https://docs.databricks.com/en/dev-tools/auth/oauth-m2m.html){:target="_blank"} documentation.
7+
At a high level, when you set up Databricks for Reverse ETL, the configured service-principal needs read permissions for any resources (databases, schemas, tables) the query needs to access. Segment keeps track of changes to your query results with a managed schema (`__SEGMENT_REVERSE_ETL`), which requires the configured service-principal to allow write permissions for that schema. Segment supports only OAuth (M2M) authentication. To generate a client ID and Secret, follow the steps listed in Databricks' [OAuth machine-to-machine (M2M) authentication](https://docs.databricks.com/en/dev-tools/auth/oauth-m2m.html){:target="_blank"} documentation.
118

9+
> info "Databricks Reverse ETL sources support Segment's dbt extension"
10+
> If you have an existing dbt account with a Git repository, you can use [Segment's dbt extension](/docs/segment-app/extensions/dbt/) to centralize model management and versioning, reduce redundancies, and run CI checks to prevent breaking changes.
1211
1312
## Required permissions
1413
* Make sure the service principal you use to connect to Segment has permissions to use that warehouse. In the Databricks console go to **SQL warehouses** and select the warehouse you're using. Navigate to **Overview > Permissions** and make sure the service principal you use to connect to Segment has *can use* permissions.

src/connections/reverse-etl/reverse-etl-source-setup-guides/postgres-setup.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ Set up Postgres as your Reverse ETL source.
66

77
At a high level, when you set up Postgres for Reverse ETL, the configured user/role needs read permissions for any resources (databases, schemas, tables) the query needs to access. Segment keeps track of changes to your query results with a managed schema (`__SEGMENT_REVERSE_ETL`), which requires the configured user to allow write permissions for that schema.
88

9+
> info "Postgres Reverse ETL sources support Segment's dbt extension"
10+
> If you have an existing dbt account with a Git repository, you can use [Segment's dbt extension](/docs/segment-app/extensions/dbt/) to centralize model management and versioning, reduce redundancies, and run CI checks to prevent breaking changes.
11+
912
Segment supports the following Postgres database providers:
1013
- Heroku
1114
- RDS

src/connections/reverse-etl/reverse-etl-source-setup-guides/redshift-setup.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,10 @@ redirect_from:
55
- '/reverse-etl/redshift-setup/'
66
---
77

8-
Set up Redshift as your Reverse ETL source.
8+
Set up Redshift as your Reverse ETL source.
9+
10+
> info "Redshift Reverse ETL sources support Segment's dbt extension"
11+
> If you have an existing dbt account with a Git repository, you can use [Segment's dbt extension](/docs/segment-app/extensions/dbt/) to centralize model management and versioning, reduce redundancies, and run CI checks to prevent breaking changes.
912
1013
To set up Redshift with Reverse ETL:
1114
1. Log in to Redshift and select the Redshift cluster you want to connect with Reverse ETL.

src/connections/reverse-etl/system.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,18 @@ beta: false
55

66
View reference information about how Segment detects data changes in your warehouse and the rate and usage limits associated with Reverse ETL.
77

8+
## Extensions
9+
10+
Extensions integrate third-party tools into your existing Segment workspace to help you automate tasks.
11+
12+
> info ""
13+
> Extensions is currently in public beta and is governed by Segment’s First Access and Beta Preview Terms. During Public Beta, Extensions is available for Team and Developer plans only. Reach out to Segment if you’re on a Business Tier plan and would like to participate in the Public Beta.
14+
15+
Segment has two extensions that you can use to manage your Reverse ETL sources:
16+
17+
- [dbt models and dbt Cloud](/docs/segment-app/extensions/dbt/): Sync your Reverse ETL models with dbt labs models and syncs to help centralize model management and versioning, reduce redundancies, and run CI checks to prevent breaking changes.
18+
- [Git sync](/docs/segment-app/extensions/git/): Manage versioning by syncing changes you make to your Reverse ETL sources from your Segment workspace to a Git repository.
19+
820
## Record diffing
921
Reverse ETL computes the incremental changes to your data directly within your data warehouse. The Unique Identifier column is used to detect the data changes, such as new, updated, and deleted records.
1022

0 commit comments

Comments
 (0)