Follow these steps to connect your Snowflake data to Supermetrics and use your data in our data destinations — Google Sheets, Looker Studio, Excel, and Power BI, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.
You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.
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.
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 INTEGRATIONSecond command:
"Supermetrics App"
TYPE = OAUTH
ENABLED = TRUE
OAUTH_CLIENT = CUSTOM
OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
OAUTH_REDIRECT_URI = 'https://supermetrics.com/login-complete'
;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.
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
- 34.48.0.128/26
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#'
- Use this SQL workaround to use Date Control with this report type:
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.
- Choose to make this connection shared or private.
- Select an authentication method.
- Enter your credentials and click Start.
- Create an SQL query under Query SQL.
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.
- Select an authentication method.
- Enter your credentials and click Start.
- Select a query type and click Next.
- Create an SQL query under Query SQL or select your database table under Tables.
- In the pane's top right, click Connect.
- Click Create report.
- Click Add to report.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.
Make sure you've installed the Supermetrics add-on before you connect.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Snowflake.
- Choose to make this connection shared or private.
- Select an authentication method.
- Enter your credentials and click Start.
- Create an SQL query under Query SQL.
- Select your countries under Tables.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Export, click Power BI.
- Click Select data source.
- Select the Snowflake data source.
- Select an authentication method.
- Enter your credentials and click Start.
- Fill in the query details.
- Click Run query to test your query.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Transform, click Query Manager (API).
- Select for Supermetrics API from the dropdown menu next to the page title.
- Click Select data source.
- Select the Snowflake data source.
- Select an authentication method.
- Enter your credentials and click Start.
- Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
- Click Run to test your query.
- Log in to the Supermetrics Hub.
- In the left-side menu, select Connect → Data sources.
- Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
- Hover over the Snowflake data source, and click Connect.
- Select an authentication method.
- Enter your credentials and click Start.