Search

Snowflake

Snowflake

Prerequisites

Whitelist CData IPs

To establish a connection to Snowflake, you need to allow access to Snowflake via CData’s IP. When hosting Snowflake behind a firewall, you must safelist these IP addresses in your firewall.

  • Range: 52.224.0.160 to 52.224.0.175

  • CIDR notation: 52.224.0.160/28

Ensure Snowflake is Publicly Accessible

Provide a public facing IP/domain to connect to this data source. The following private IP ranges do not work:

  • 10.0.0.0 to 10.255.255.255

  • 172.16.0.0 to 172.31.255.255

  • 192.168.0.0 to 192.168.255.255

  • 127.0.0.1 (aka ‘localhost’)

Setup Guide

Follow these steps to connect Snowflake to your CData Connect Cloud account:

  1. Open the Connections page of the CData Connect Cloud dashboard.

  2. Click + Add Connection in the upper-right corner.

  3. Type Snowflake into the search field, then click the data source name.

  4. On the Basic Settings tab of the new connection, enter a connection name or keep the default name.

  5. Enter the Snowflake Warehouse.

  6. Enter the URL of the Snowflake database. The URL is formatted as https://<org-name>-<conn-name>.snowflakecomputing.com and can be found in Snowflake by following these steps:

    1. Open the account selector in the bottom left corner of Snowflake and review the list of accounts that you previously signed in to.

    2. Locate the account for which you want to copy the account name.

    3. Hover over the account to view additional details, and then select the copy link icon to copy the account URL in the format http://<org-name>-<conn-name>.snowflakecomputing.com to your clipboard.

    4. Paste the URL in the URL field.

    For additional help, refer to the Snowflake documentation.

  7. Select the Authentication method, then proceed to the relevant section and follow those instructions.

Authentication Methods

Password

  1. Enter your user name in the User field and password in the Password field.

  2. In the Database section, enter the name of the Snowflake database to connect to.

  3. (Optional) Enter the schemas of the Snowflake database to connect to. If this is left blank, the connector has access to all schemas in the database.

  4. At the top of the CData Connect Cloud Add Snowflake Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Then, try again.

  5. In Snowflake, add the CData Connect Cloud static IP addresses to your connection whitelist.

Private Key

Follow these steps to configure private key authentication:

  1. Open your Snowflake keyfile (which ends in .p8) in a text editor.

  2. Copy the entire contents of the file.

  3. Enter the copied contents of your private key into the Private Key field.

  4. If your private key has a password, enter it in the Private Key Password field.

  5. Select the correct Private Key Type from the drop down.

  6. In the Database section, enter the name of the Snowflake database to connect to.

  7. (Optional) Enter the schemas of the Snowflake database to connect to. If this is left blank, the connector has access to all schemas in the database.

  8. At the top of the CData Connect Cloud Add Snowflake Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Then, try again.

  9. In Snowflake, add the CData Connect Cloud static IP addresses to your connection whitelist.

Okta

  1. Enter the following information:

    • User— The Okta user account.

    • Password— The password associated with the Okta account.

    • MFA Passcode— Set this to the OTP code that was sent to your device. This property should be used only when Multi-Factor Authentication is required for Okta sign on.

    • SSO Properties— are needed to authenticate to Okta:

      • Domain: Set this to the OKTA org domain name.
      • MFAType (optional): Set this to the multi-factor type. This property should be used only when the MFA is required for Okta sign on. This property accepts one of the following values:
        • OKTAVerify
        • Email
        • SMS
      • APIToken (optional): Set this to the API Token created by Okta. This is used when authenticating a user via a trusted application or proxy that overrides the Okta client request context.

  2. In the Database section, enter the name of the Snowflake database to connect to.

  3. (Optional) Enter the schemas of the Snowflake database to connect to. If this is left blank, the connector has access to all schemas in the database.

  4. At the top of the CData Connect Cloud Add Snowflake Connection page, click Save & Test.

    • If the connection test succeeds, a message indicates that your connection has been created.

    • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Then, try again.

  5. In Snowflake, add the CData Connect Cloud static IP addresses to your connection whitelist.

More Information

For more information about interactions between CData Connect Cloud and Snowflake, see this information page.