Skip to content
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

Redshift updates added to mirror Snowflake #4787

Merged
merged 1 commit into from
Feb 7, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ page_order: 4.1
page_type: landing

guide_top_header: "Braze Cloud Data Ingestion"
guide_top_text: "<h2>What is Braze Cloud Data Ingestion?</h2>Braze Cloud Data Ingestion allows you to set up a direct connection from your Snowflake instance to Braze to sync relevant user attributes, events, and purchases. Once synced to Braze, this data can be leveraged for use cases such as personalization or segmentation.<br><br>**Braze Cloud Data Ingestion capabilites:**<br> - Create a simple integration directly from your data warehouse to Braze in just a few minutes<br>- Securely sync user data, including attributes, events, and purchases from your data warehouse to Braze<br>- Close the data loop with Braze by combining Cloud Data Ingestion with Currents or Snowflake Data Sharing"
guide_top_text: "<h2>What is Braze Cloud Data Ingestion?</h2>Braze Cloud Data Ingestion allows you to set up a direct connection from your Snowflake or Redshift instance to Braze to sync relevant user attributes, events, and purchases. Once synced to Braze, this data can be leveraged for use cases such as personalization or segmentation.<br><br>**Braze Cloud Data Ingestion capabilites:**<br> - Create a simple integration directly from your data warehouse to Braze in just a few minutes<br>- Securely sync user data, including attributes, events, and purchases from your data warehouse to Braze<br>- Close the data loop with Braze by combining Cloud Data Ingestion with Currents or Snowflake Data Sharing"

guide_featured_title: "Section articles"
guide_featured_list:
Expand All @@ -18,6 +18,9 @@ guide_featured_list:
- name: Snowflake Integration
link: /docs/user_guide/data_and_analytics/user_data_collection/cloud_ingestion/snowflake/
fa_icon: fa-solid fa-snowflake
- name: Redshift Integration
link: /docs/user_guide/data_and_analytics/user_data_collection/cloud_ingestion/redshift/
fa_icon: fa-solid fa-gears

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,23 +11,23 @@ description: "This reference article provides an overview of Cloud Data Ingestio

## What is Cloud Data Ingestion?

Braze Cloud Data Ingestion allows you to set up a direct connection from your Snowflake instance to Braze to sync relevant user attributes, events, and purchases. Once synced to Braze, this data can be leveraged for use cases such as personalization or segmentation.
Braze Cloud Data Ingestion allows you to set up a direct connection from your data warehouse to Braze to sync relevant user attributes, events, and purchases. Once synced to Braze, this data can be leveraged for use cases such as personalization or segmentation. Cloud Data Ingestion can connect to Snowflake and Redshift data warehouses.

{% alert important %}
Braze Cloud Data Ingestion is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
Braze Cloud Data Ingestion for Redshift is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
{% endalert %}

### How it works

With Braze Cloud Data Ingestion, you set up an integration between your Snowflake instance and Braze app group to sync data on a recurring basis. This sync runs on a schedule you set, and each integration can have a different schedule. Syncs can run as frequently as every 15 minutes or as infrequently as once per month. For customers who need syncs to occur more frequently than 15 minutes, please speak with your customer success manager, or consider using REST API calls for real-time data ingestion.
With Braze Cloud Data Ingestion, you set up an integration between your data warehouse instance and Braze app group to sync data on a recurring basis. This sync runs on a schedule you set, and each integration can have a different schedule. Syncs can run as frequently as every 15 minutes or as infrequently as once per month. For customers who need syncs to occur more frequently than 15 minutes, please speak with your customer success manager, or consider using REST API calls for real-time data ingestion.

When a sync runs, Braze will directly connect to your Snowflake instance, retrieve all new data from the specified table, and update the corresponding user profiles on your Braze dashboard. Each time the sync runs, any updated data will be reflected on the user profiles.
When a sync runs, Braze will directly connect to your data warehouse instance, retrieve all new data from the specified table, and update the corresponding user profiles on your Braze dashboard. Each time the sync runs, any updated data will be reflected on the user profiles.

### What gets synced

Each time a sync runs, Braze looks for rows that have not previously been synced. We check this using the `UPDATED_AT` column in your table or view. Any rows where `UPDATED_AT` is later than the last synced row will be selected and pulled into Braze.

In Snowflake, you add the following users and attributes to your table, setting the `UPDATED_AT` time to the time you add this data:
In your data warehouse, you add the following users and attributes to your table, setting the `UPDATED_AT` time to the time you add this data:

| UPDATED_AT | EXTERNAL_ID | PAYLOAD |
| --- | --- | --- |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,8 @@
nav_title: Redshift
article_title: Braze Cloud Data Ingestion for Redshift
description: "This reference article covers Braze Cloud Data Ingestion and how to sync relevant user data to your Reshift integration."
page_order: 4.1
page_order: 2
page_type: reference
hidden: true

---

Expand Down Expand Up @@ -70,4 +69,39 @@ If you have a firewall or other network policies in place, you will need to give
| `18.205.178.15`| `3.68.144.188`
| | `3.70.107.88`

### Create a new integration in the Braze dashboard

Navigate to the Redshift page on Braze, under **Technology Partners**, and click **Create new import sync**.

1. **Add Redshift connection information and source table**<br>
Input the information for your Redshift data warehouse and source table, then proceed to the next step.<br>![][1]<br><br>
2. **Configure sync details**<br>
Next, choose a name for your sync and input contact emails. We’ll use this contact information to notify you of any integration errors (e.g., access to the table was removed unexpectedly).<br>![][2]<br><br> You will also choose the data type and sync frequency. Frequency can be anywhere in the range of every 15 minutes to once per month. We’ll use the time zone configured in your Braze dashboard to schedule the recurring sync. Supported data types are Custom Attributes, Custom Events, and Purchase Events and the data type for a sync cannot be changed after creation.

### Test connection

Once all configuration details for your sync are entered, click **Test connection**. If successful, you’ll see a preview of the data. If for some reason we can’t connect, we’ll display an error message to help you troubleshoot the issue.

![][3]

{% alert note %}
You must successfully test an integration before it can move from Draft into Active state. If you need to close out of the creation page, your integration will be saved, and you can revisit the details page to make changes and test.
{% endalert %}

### Set up additional integrations or users (optional)

You may set up multiple integrations with Braze, but each integration should be configured to sync a different table. When creating additional syncs, you may reuse existing credentials if connecting to the same Redshift account.
![][4]

If you reuse the same user across integrations, you will not be able to delete the user in the Braze dashboard until it's removed from all active syncs.

### Running the sync

Once activated, your sync will run on the schedule configured during setup. If you want to run the sync outside of the normal schedule for testing or to fetch the most recent data, click **Sync Now**. This run will not impact regularly scheduled future syncs.
![][5]

[1]: {% image_buster /assets/img/cloud_ingestion/ingestion_6.png %}
[2]: {% image_buster /assets/img/cloud_ingestion/ingestion_7.png %}
[3]: {% image_buster /assets/img/cloud_ingestion/ingestion_8.png %}
[4]: {% image_buster /assets/img/cloud_ingestion/ingestion_9.png %}
[5]: {% image_buster /assets/img/cloud_ingestion/ingestion_10.png %}
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,6 @@ page_type: reference

# Cloud Data Ingestion for Snowflake

{% alert important %}
Braze Cloud Data Ingestion for Snowflake is currently in early access. Contact your Braze account manager if you are interested in participating in the early access.
{% endalert %}

## Product setup

New Cloud Data Ingestion integrations require some setup on the Braze side and in your Snowflake instance. Follow these steps to set up the integration:
Expand Down
Binary file added assets/img/cloud_ingestion/ingestion_10.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/cloud_ingestion/ingestion_6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/cloud_ingestion/ingestion_7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/cloud_ingestion/ingestion_8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/cloud_ingestion/ingestion_9.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.