Search
K
Comment on page

Amazon Redshift

Amazon Redshift is a fully managed data warehouse service in the cloud. This article will cover how to connect to Amazon Redshift from Noteable.

Prepare

You will need the following information to create the connection:
  • Database host (AWS Endpoint)
  • Database port (default: 5439)
  • Database name
  • Username & password
By default, Noteable attempts to connect to Redshift over SSL (default: Prefer). The options available are:
  • Prefer: first try an SSL connection; if that fails, try a non-SSL connection.
  • Require: only try an SSL connection.
  • Allow: first try a non-SSL connection; if that fails, try an SSL connection.
  • Verify-ca: only try an SSL connection and the server is verified by checking the certificate chain up to the root certificate stored on the client.
  • Verify-full: only try an SSL connection and the server is verified by checking the certificate chain up to the root certificate stored on the client and libpq will verify that the server hostname matches its certificate.
  • Disable: use a non-SSL connection.
If your data source is behind a firewall, you will need to ensure your firewall accepts incoming connections from Noteable. Read more: Data Connections

Create connections

To create a data connection:
  1. 1.
    Pick connection type.
  2. 2.
    Store credentials.
  3. 3.
    Start or restart the kernel.
There are multiple places you can create data connections:
Notebook
Resources page
To add a data connection from the notebook:
  1. 1.
    Open the Data Connections panel by clicking on the database icon (
    ) in the left sidebar.
  2. 2.
    Click on the
    sign to launch the Create a data connection modal.
  3. 3.
    Select Redshift for the connection type.
  4. 4.
    Provide a Name for the data connection and a description, if desired.
  5. 5.
    Provide your AWS endpoint as the Host.
  6. 6.
    Configure the Port value, if necessary.
  7. 7.
    Provide your Username & Password.
  8. 8.
    Provide the Database name.
  9. 9.
    Choose SSL configuration, if desired.
  10. 10.
    Choose the connection's Visibility - this cannot be changed later:
    • Private connections can only be seen, managed, or accessed by the user who created the connections, and can be used in any space.
    • Space-level connections can be seen and managed by all users who have Contributor or Owner access for the space but can only be used in notebooks within the designated space.
  11. 11.
    Click Create.
  12. 12.
    Restart the kernel, if prompted.
To add a data connection from the resources page:
  1. 1.
    Click on the Data Connections link in the main sidebar. This sidebar is visible from all space or project pages.
  2. 2.
    Click on the +Create a data connection button to launch the Add data connection modal.
  3. 3.
    Select Redshift for the connection type.
  4. 4.
    Provide a Name for the data connection and a description, if desired.
  5. 5.
    Provide your AWS endpoint as the Host.
  6. 6.
    Configure the port value, if necessary.
  7. 7.
    Provide your username & password.
  8. 8.
    Provide the database name (default: default).
  9. 9.
    Choose SSL configuration, if desired.
  10. 10.
    Choose the connection's Visibility - this cannot be changed later:
    • Private connections can only be seen, managed, or accessed by the user who created the connections, and can be used in any space.
    • Space-level connections can be seen and managed by all users who have Contributor or Owner access for the space but can only be used in notebooks within the designated space.
  11. 11.
    Click Create.
  12. 12.
    Restart any running kernels to use this connection.

Use connections

Learn more about how to use SQL cells here.