All resources

Getting Started with Goldilox Insights

Everything you need to install Insights, point it at the right tables, and start applying clustering key recommendations — typically in under 15 minutes, entirely inside your Snowflake account.

Overview

Goldilox Insights is a Snowflake Native App. It studies how your queries actually read your tables, then recommends clustering keys that improve partition pruning — so queries scan less data, run faster, and cost less. Because compute is billed by warehouse runtime, a faster query is a cheaper query.

Insights never moves your data. It runs as an app inside your Snowflake account and reads only query metadata and table statistics — never the contents of your tables.

Requirements

  • A Snowflake account on a supported cloud and region.
  • Privileges to install a Native App from the Snowflake Marketplace (typically ACCOUNTADMIN, or a role granted the marketplace import privilege).
  • A warehouse the app can use to run its analysis.
  • Query history available for the tables you want to optimize — the more representative your recent workload, the better the recommendations.

1Install the app

Open the Goldilox Insights listing on the Snowflake Marketplace and click Get. Installing the app gives you a free preview of the Insights dashboard — no recommendations or payment required. There are no external services to deploy and nothing to host.

Installing only previews the dashboard. The free promotion and paid tiers unlock full clustering key recommendations with estimated savings.

2Grant permissions

On first launch, the app's setup screen requests the privileges it needs to analyze your workload. At a high level, Insights needs to:

  • Read query history and access patterns, so it can see which columns your queries filter and join on.
  • Read table and micro-partition metadata, so it can measure current pruning efficiency.
  • Use a warehouse to run its analysis.

Grant the privileges through the in-app prompts. Insights does not request access to the contents of your tables.

3Select tables to monitor

Choose the tables you want Insights to watch. The best candidates are your largest, most-queried fact tables — the ones where excessive scanning costs the most. Insights highlights high-impact tables with low pruning efficiency so you can prioritize. Your plan determines how many tables you can monitor at once.

4Automated analysis

Once tables are selected, Insights begins analyzing your query telemetry. It uses trained prediction models to identify the clustering key that would maximize partition pruning for each table's real access pattern. As your workload shifts over time, recommendations adapt.

5Review recommendations

The dashboard shows, per table:

  • The recommended clustering key.
  • Current versus predicted partitions scanned.
  • Estimated credit and dollar savings, based on your own historical query costs.
  • Ready-to-run SQL to apply the change.

Because every recommendation carries an estimated saving, you can sort by impact and apply the changes that matter most first.

6Apply changes

Insights generates the SQL for each recommendation. Applying a clustering key in Snowflake looks like this:

ALTER TABLE my_db.my_schema.STORE_SALES
  CLUSTER BY (SS_SOLD_DATE_SK, SS_STORE_SK);

You stay in full control: Insights recommends, you review and apply at your discretion. After Snowflake reclusters the table, new queries benefit from improved pruning automatically — no query rewrites needed.

Snowflake performs automatic clustering as a background service, which consumes credits while it reorganizes a newly clustered table. Insights factors steady-state query savings into its estimates; for very large tables, apply during a window where some background reclustering cost is acceptable.

Ongoing monitoring

Clustering is not one-and-done. As query patterns evolve, a key that was optimal can drift. Insights continuously monitors your selected tables and updates recommendations when a better key emerges, so your tables stay tuned without manual re-analysis.

Data & security

Insights runs entirely within your Snowflake environment. Your data never leaves your account, and only query metadata and telemetry are analyzed — never the contents of your tables. See the Privacy Policy and Terms of Use for details.

Troubleshooting

I don't see recommendations yet

Insights needs enough query history on a selected table to model its access pattern. Give it a short window after installation to gather data, and make sure the table has been queried recently.

Recommendations look different from last month

That's expected — recommendations adapt to your current workload. If your queries have shifted, the optimal clustering key can shift with them.

Estimated savings seem conservative

Estimates are grounded in your actual historical query costs rather than best-case projections, so they tend to be realistic rather than optimistic.

Support

Questions or issues? Email support@goldilox.com or request a demo.

Ready to start? Install Insights and preview the dashboard for free.

Try Free on Snowflake Marketplace