25min

Basic Snowflake Setup

Let's connect your Snowflake 'Data Cloud' database

Go ahead and gather the basic details to connect to your Snowflake Data Cloud:

  • Snowflake account (usually in the URL/Address Bar)
  • Snowflake User credentials with permissions to create a user and a warehouse

Snowflake Specifications and Recommendations:

  • If you have a networking policy with only specific allowed IP addresses on Snowflake you will need to assign the DataLakeHouse.io IP addresses to that policy to allow us to work with you Snowflake account.

Instructions (Basic Connection Setup)

Scroll down to ensure you review all steps, as needed...

Remember DataLakeHouse.io connects to your database instance with credentials supplied by you. We store your credentials securely with our bank-grade protocols.

  1.  Create a DataLakeHouse user on Snowflake
    1. Log into the Snowflake account with administrator account, usually an account with ACCOUNTADMIN role access
    2. Create a new Worksheet
    3. Copy and paste the script below into the worksheet and then follow the steps directly below this script to see any adjustments you may consider before executing/running the script...
    4. In the first part of the the script the 'set' values are local variables.  We recommend changing the user_password value before running the script.  If you need to change any other variables you may do so but it is not recommended unless you are an advanced user.
    5. Now, click on the 'All Queries' checkbox at the top of the worksheet next to the 'Run Button', 
    6. Execute the script by clicking the 'Run Button' 
      • An alternative would be to highlight the entire script and then click the Run button.
    7. Once the script completes you can return to this DataLakeHouse.io form for your Snowflake connection and enter the details of your new/updated user and following the continued steps below here...
  2. On the Connection Form :: Enter your Credentials and Other Information
    • Enter in the Name/Alias field, the name you'll use within datalakehouse.io to differentiate this connection from others
    • Enter in the Server/Host field, the name of the public server name or the IP Address (most customers use the IP for this field)
      • Use the full URL, for example, bbbxxx123.snowflakecomputing.com
    • Enter in the Port field, where this database is accessible and the firewall restrictions are open. For Snowflake we always assume port 443, which is standard but we have it here for future-proofing.
    • Enter in the Database field, the name of the database to connect
      • In most cases this is the DATALAKEHOUSE_RAW database
    • Enter in the Username/Alias field, the username of user you created in the steps above to give access to DataLakeHouse.io
      • In most cases this is the DATALAKEHOUSE_USER 
    • Enter in the Role field, the username of user you created in the steps above to give access to DataLakeHouse.io
      • In most cases this is the DATALAKEHOUSE_ROLE 
    • Leave Auth Type field alone. It is set to password because DataLakeHouse is currently only using SSL/TLS and requires username and password credentials to access the database
    • Enter in the Password field, the password for the user you created in the steps above
    • Click on Save & Test to save the connection and test that we can connect.
  3. If updating the form Click Save & Test or just Test
    • Clicking on Save & Test will again save any changes such as the password change, etc.  You will not be able to change the prefix of the schema that will be the target in the destination. Any test of the connection will attempt to connect to your database with the credentials and info provided.
    • A message of success or failure will be shown:
      • If success you'll be prompted with the schema objects objects of the database and will need to complete the final steps for configuration shown below.
      • If failure happens with the test connection, the connection is still saved but you will need to correct the failure based on the failure reason information provided in the message
  4. Snowflake Network Policy Settings
    1. As mentioned above, if you have configured a Snowflake Network Policy, please update it to use our grantlist of IP Address.  If you have an existing policy find the policy name and run the following script:
      1. Modify Existing Networking Policy

Other Information About This Connection

From time to time we will update the instruction set here to inform you about this connection or how specifically we must connect to optimally synchronize your data.

If you require any other type of authorization to connect to your account instance please reach out to our support team via our DataLakeHouse Support Portal.



Updated 04 May 2022
Did this page help you?
Yes
No