Amazon Redshift

This page describes how to create and maintain connections to your Amazon Redshift database.
Before you can write your transformed data to a table in Amazon Redshift, you should first establish a connection to your Amazon Redshift database.

Create a Redshift connection

Simple example

A Redshift connection can be created as simply as follows:
Note that a Redshift connection must specify the database it is connecting to within the connection string.
This means that in order to connect to multiple databases within your account, you need to create at least one connection per database.

Full example

The following example also creates a Redshift connection but additionally limits the maximum number of concurrent connections to your database by configuring an additional option MAX_CONCURRENT_CONNECTIONS:
For the full list of connection options with syntax and detailed descriptions, see: Redshift connection with SQL

Alter a Redshift connection

Certain connection options are considered mutable, meaning that in some cases, you can run a SQL command to alter an existing Redshift connection rather than creating a new one.
To change the database you are connecting to but keep everything else the same without having to create an entirely new connection, you can run the following command:
To check which specific connection options are mutable, see: Redshift connection with SQL

Drop a Redshift connection

If you no longer need a certain connection, you can easily drop it with the following SQL command:
However, note that if there are existing tables or jobs that are dependent upon the connection in question, the connection cannot be deleted. Attempting to do so will raise the following error:
Cannot delete connection due to usages: <tables> <jobs>
For more details, see: DROP CONNECTION