Snowflake connection guide

Supermetrics Support Site Team

Modified on: Fri, 24 Feb, 2023 at 1:34 PM

Follow this guide to connect your Snowflake data to Supermetrics.

If you need to connect this data source to one of our data warehouse or cloud storage destinations, explore our data warehouse and cloud storage setup guides.

Before you begin

There are 2 ways to authenticate Snowflake: with OAuth, or with a username and password.

To connect with OAuth, you need an account with the Account admin role, plus a client ID and client secret.

How to create an OAuth client ID and client secret

Log in to Snowflake and click SYSADMIN.
Click Change, and select the ACCOUNTADMIN role.

Run the following 2 commands in a worksheet:
First command:

CREATE SECURITY INTEGRATION
  "Supermetrics App" 
  TYPE = OAUTH 
  ENABLED = TRUE 
  OAUTH_CLIENT = CUSTOM 
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' 
  OAUTH_REDIRECT_URI = 'https://supermetrics.com/login-complete' 
;

Second command:

SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('Supermetrics App');

Click row 1 in the output. You'll find this at the bottom of the screen.
A popup will open with 3 key-value pairs in JSON format.
Copy the values after the keys OAUTH_CLIENT_ID and OAUTH_CLIENT_SECRET. These are your client ID and client secret — keep them safe.

To connect with a username and password, you need a database username and secret key with username, password, hostname, warehouse name, database name, and database schema.

How to find your hostname, database name, and database schema

You can find your hostname in the URL when you're logged in to Snowflake. It should end in snowflakecomputing.com.

The warehouse name, database name, and database schema can be found in Snowflake at the top right of the query editor.

Allowlist IP

To enable Supermetrics for Snowflake, your database needs to accept connections from this IP address:

23.20.234.176

Query types

Database table-based report: Select a table from a schema, and use the columns of that table as the fields in Looker Studio.
- Make sure to check the "Warehouse, database name, and schema are case sensitive" optionon the Snowflake login screen to enable this report type to work properly.
- Date control doesn't work with this report type.
- If the account you're using has multiple roles and the default role doesn't give it the permissions it needs to retrieve the table list, you might encounter problems getting your full list of tables. Change the account's default role or create a new account with only one role to solve the issue.
Database query report: Build an SQL query and use it to create report fields. With the SQL query, combine data from several tables, including those that are in different schemas.
- Use this SQL workaround to use Date Control with this report type:
```
select * from MARKETING.MIX_PBI.GOOGLEADS_AD
where DATE >= '#start-date#'
AND DATE <= '#end-date#'
```

Note that SQL comments and Snowflake functions aren't supported in SQL-based reports.

Instructions

Make sure you've installed the Supermetrics add-on before you connect.

Open a new Google Sheets file.
Navigate to Extensions → Supermetrics → Launch sidebar to open Supermetrics.
Click Create new query.
Under Data source, select Snowflake.
Enter your credentials and click Start.
Navigate to Database query.
Create an SQL query under "Query SQL".
Select your countries under "Tables".

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.

Make sure you've connected Supermetrics to Looker Studio before following the steps below.

Open the Supermetrics Looker Studio data source gallery.
Navigate to Snowflake and click Start free trial.
You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
Once that's done, or if you've done it before, click the right-hand Authorize button (under "Snowflake requires authorization to connect to data").
Select a team that has access to the account you want to connect.
Choose to make this connection shared or private.
Click Start.
Enter your credentials and click Start.
Navigate to Database query.
Create an SQL query under "Query SQL".
Select your countries under "Tables".
Select a query type.
Scroll down to the bottom of the page. To create a report with our template, select Use report template for new reports. To create a blank report, deselect this option.
In the pane's top right, click Connect.
Click Create report.
Click Add to report.