You are here:
Amazon Redshift Connection
Create a remote connection using the Amazon Redshift connector to sync data from Amazon Redshift to CRM Analytics.
Connection Requirements
Before you create an Amazon Redshift connection, ensure that the Redshift cluster that you’re connecting to is SSL enabled. For more information about using SSL, see Configure Security Options for Connections in Amazon Web Services documentation.
Create the Connection
- On the Data Manager Connections tab, click New Connection.
- Click the name of the connector, and click Next.
- Enter the connector settings.
- To validate your settings and attempt to connect to the source, click Save & Test. If the connection fails, CRM Analytics shows possible reasons.
All settings require a value, unless otherwise indicated.
| Setting | Description |
|---|---|
| Connection Name | Identifies the connections. Use a convention that lets you easily distinguish between different connections. |
| Developer Name | API name for the connection. This name can’t include spaces. The API name is used in your recipes to reference data extracted through this connection. You can’t change the developer name after you create the connection. |
| Description | Description |
| Username | User name for your Amazon Redshift account. |
| Number Of Nodes in Cluster | The number of nodes in the Amazon Redshift cluster. |
| Schema | Your Amazon Redshift schema name. Only objects that exist within this schema are available for sync. |
| Cluster Node Type | Node type of the Amazon Redshift cluster. |
| JDBC URL | Your Amazon Redshift connection URL. Enter in the format: jdbc:redshift://<cluster>.<hostname>.<region>.redshift.amazonaws.com:<port>/<database> For help finding your URL, see Amazon Web Services’ Obtain the JDBC URL. Use the exact URL specified in the cluster database properties. For example: Serverless JDBC URLs are also supported. For example: |
| Password | Password for your Amazon Redshift account. |
| S3 Bucket Name | The name of your Amazon S3 bucket. Optional. |
Filter Data Synced to CRM Analytics
Exclude unnecessary or sensitive data from syncing to CRM Analytics with data sync filters. Filters run on the source object and speed up data sync by pulling only the data you need into CRM Analytics.
- From Data Manager, click the Connections tab.
- Select the connection associated with the object to filter.
- Click the name of the object to filter.
- Click Data Sync Filter.
- Enter the filter.
- Click Save.
For the Amazon Redshift connector, enter a filter in the syntax described in the Amazon Redshift help.
Amazon Redshift Connector Considerations
Keep these behaviors in mind when working with the Amazon Redshift connector.
- Connected object names must start with a letter and contain only letters, digits, or underscores. Object names can’t end with an underscore.
- Only field names with combinations of alphanumeric, dot, underscore, or dash characters are supported. If a connector includes field names that contain other characters, such as spaces or brackets, the sync fails.
- The connector can sync up to 100 million rows or 50 GB per object, whichever limit is reached first. When using the connector, Salesforce Government Cloud org data is protected in transit with advanced encryption and can sync up to 10 million rows or 5 GB for each connected object, whichever limit is reached first.
- Ensure that the Redshift cluster that you’re connecting to is SSL enabled. For more information about using SSL, see Configure Security Options for Connections in Amazon Web Services documentation.
- While connecting to a Redshift view, the field picker appears empty when a field’s length exceeds 32,000 characters and the source data table and view are in different database schemas. Decrease the field length in Redshift, or move the table and view to the same schema.
- When syncing a Redshift object, the job quits when the query takes longer than the 60-minute threshold or when Redshift can't send any data within a 20-minute window. Make sure the Redshift instance is sized properly to send data in the 20-minute window.
- Although allowing designated IPs isn’t usually the preferred or recommended practice in most cases, you must make your Redshift node available to Salesforce data centers with these IP ranges. Nodes in a VPC or behind a firewall aren’t supported.
When you run a sync job on a Redshift object using the legacy connector, the Redshift data is first staged in an Amazon S3 bucket and then pulled from the S3 bucket into CRM Analytics. To enable the connector to access the data, specify the name of the bucket, its secret access key, and its access key ID in the connection settings. You can only sync data included in the specified Amazon S3 bucket. The new connector version doesn’t use Amazon S3.
| Setting | Description |
|---|---|
| Master Symmetric Key | Optional. Your Amazon S3 master symmetric key used to enable client-side data encryption. This must be a 256-bit AES encryption key in Base64 format. |
| AWS Secret Access Key | Your Amazon secret access key. |
| AWS Access Key ID | Your Amazon S3 bucket access key ID. |
| S3 Bucket Name | The name of your Amazon S3 bucket. Required when using the legacy version of this connector. |

