Merge pull request #4393 from segmentio/DOC-671

Redshift Reverse ETL setup

Author: stayseesong

src/_data/sidenav/main.yml

@@ -249,6 +249,8 @@ sections:
     title: Reverse ETL Overview
   - path: /reverse-etl/bigquery-setup
     title: BigQuery Reverse ETL Setup
+  - path: /reverse-etl/redshift-setup
+    title: Redshift Reverse ETL Setup
   - path: /reverse-etl/snowflake-setup
     title: Snowflake Reverse ETL Setup
 - section_title: Profiles

src/reverse-etl/bigquery-setup.md

@@ -2,7 +2,7 @@
 title: BigQuery Reverse ETL Setup
 ---
 
-Set up BigQuery as your Reverse ETL source. You can also choose to [set up Snowflake](/docs/reverse-etl/snowflake-setup/) as your source.
+Set up BigQuery as your Reverse ETL source. 
 
 > warning ""
 > You need to be an account admin to set up the Segment BigQuery connector as well as write permissions for the `__segment_reverse_etl` dataset.
@@ -26,7 +26,7 @@ To set up the Segment BigQuery connector:
 20. Click **Test Connection** to test to see if the connection works. If the connection fails, make sure you have the right permissions and credentials and try again.
 6. Click **Create Source** if the test connection is successful.
 
-Once you've added BigQuery as a source, you can [add a model](/docs/reverse-etl/#step-2-add-a-model).
+Once you've added BigQuery as a source, you can [add a model](/docs/reverse-etl#step-2-add-a-model).
 
 ## Constructing your own role or policy
 When you construct your own role or policy, Segment needs the following permissions:

src/reverse-etl/index.md

@@ -45,7 +45,7 @@ To add your warehouse as a source:
 
 1. Navigate to **Reverse ETL** in the Segment app.
 2. Click **Add Source**.
-3. Select the source you want to add. You can choose between **BigQuery** and **Snowflake**.
+3. Select the source you want to add. You can choose between **BigQuery**, **Snowflake**, and **Redshift**.
     * If you choose to use Snowflake, run the queries listed in the [Snowflake Reverse ETL setup guide](/docs/reverse-etl/snowflake-setup/) to set up the Segment Snowflake connector. Segment recommends using the `ACCOUNTADMIN` role to execute all the commands.
     * If you choose to use BigQuery, use the permissions outlined in the [BigQuery Reverse ETL setup guide](/docs/reverse-etl/bigquery-setup/), to create a Service Account and generate JSON credentials that will then be copied into the Segment UI when creating a Reverse ETL Source.
 4. Add the account information for your source.  

src/reverse-etl/redshift-setup.md

@@ -0,0 +1,28 @@
+---
+title: Redshift Reverse ETL Setup
+beta: true
+---
+
+Set up Redshift as your Reverse ETL source. 
+
+> info ""
+> Redshift for Reverse ETL is in beta and Segment’s [First-Access and Beta terms](https://segment.com/legal/first-access-beta-preview/) govern this feature. If you’d like to learn more, reach out to your CSM, AE, or SE.
+
+To set up Redshift with Reverse ETL: 
+1. Log in to Redshift and select the Redshift cluster you want to connect with Reverse ETL.
+2. Follow the [networking instructions](/docs/connections/storage/catalog/redshift/#networking) to configure the correct network and security settings. 
+3. Run the SQL commands below to create a user named `segment`. 
+
+    ```sql
+    -- create a user named "segment" that Segment will use when connecting to your Redshift cluster.
+    CREATE USER segment PASSWORD '<enter password here>';
+
+    -- allows the "segment" user to create new schemas on the specified database. (this is the name you chose when provisioning your cluster)
+    GRANT CREATE ON DATABASE "<enter database name here>" TO "segment";
+    ```
+4. Follow the steps listed in the [Add a source](/docs/reverse-etl#step-1-add-a-source) section to finish adding Redshift as your source.
+
+### Extra Permissions
+Give the `segment` user read permissions for any resources (databases, schemas, tables) the query needs to access. 
+
+Give the `segment` user write permissions for the Segment managed schema (`__segment_reverse_etl`), which keeps track of changes to the query results.  

src/reverse-etl/snowflake-setup.md

@@ -3,7 +3,7 @@ title: Snowflake Reverse ETL Setup
 beta: true
 ---
 
-Set up Snowflake as your Reverse ETL source. You can also choose to [set up BigQuery](/docs/reverse-etl/bigquery-setup/) as your source.
+Set up Snowflake as your Reverse ETL source. 
 
 At a high level, when you set up Snowflake 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.
 
@@ -57,4 +57,4 @@ Follow the instructions below to set up the Segment Snowflake connector. Segment
    -- role access
    GRANT ROLE segment_reverse_etl TO USER segment_reverse_etl_user;
    ```
-7. Follow the steps listed in the [Add a Source](/docs/reverse-etl/#step-1-add-a-source) section to finish adding Snowflake as a source.
+7. Follow the steps listed in the [Add a Source](/docs/reverse-etl#step-1-add-a-source) section to finish adding Snowflake as a source.