Setup Snowflake

Create a free Vantage account then follow the steps below to integrate Snowflake costs.

Connecting Your Snowflake Account

Vantage integrates with your Snowflake account through a secure, read-only user that has access to Snowflake usage tables. Optionally, see below for instructions on creating a specific schema for the Vantage user.

Vantage requires read-only access to the following tables:

• SNOWFLAKE.ORGANIZATION_USAGE.WAREHOUSE_METERING_HISTORY

  Returns hourly credit usage for both virtual warehouse credit usage and cloud service credit usage per each warehouse for all warehouses in your account. Data retained for 1 year.

• SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY

  Query history with various dimensions, including total elapsed time, warehouse used, data bytes scanned, etc. Data retained for 1 year.

• SNOWFLAKE.ORGANIZATION_USAGE.USAGE_IN_CURRENCY_DAILY

  Returns the daily credit usage and usage in currency for an organization.

Snowflake Schema for Vantage

A best practice is to create a schema specifically for the Vantage user. Note that this is optional. After creating the schema you can add only the needed views to that schema and grant the vantage user access to the schema. Below are a set of commands to accomplish this modified from the Snowflake instructions here.

To start create a user vantage, a role vantage and a warehouse vantage and grant necessary permissions.

use role accountadmin;
create database vantage;
create role vantage;
create user vantage;
grant role vantage to user vantage;
grant role vantage to role accountadmin;
create warehouse vantage;
grant all on warehouse vantage to role vantage;
alter user vantage set DEFAULT_WAREHOUSE=vantage, DEFAULT_ROLE=vantage;
alter user vantage set password='<A STRONG PASSWORD>';

Next, setup the Vantage specific schema to read billing and usage data from your account.

use warehouse vantage;
create view VANTAGE.PUBLIC.QUERY_HISTORY as select * from SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY;
create view VANTAGE.PUBLIC.WAREHOUSE_METERING_HISTORY as select * from SNOWFLAKE.ORGANIZATION_USAGE.WAREHOUSE_METERING_HISTORY;
create view VANTAGE.PUBLIC.USAGE_IN_CURRENCY_DAILY as select * from SNOWFLAKE.ORGANIZATION_USAGE.USAGE_IN_CURRENCY_DAILY;
grant usage on schema vantage.public to role vantage;
grant usage on database vantage to role vantage;
grant select on all views in schema VANTAGE.PUBLIC to role vantage;

Lastly, test your setup.

use role vantage;
select * from vantage.public.query_history limit 1;

After creating the user and granting access you can visit the integrations page and click "Add" on the Snowflake section.