docs(snowflake): document queryTag connection option

[igorlukanin]

Summary

• Documents the Snowflake driver's queryTag connection option, which had no docs since it shipped (feat(snowflake-driver): Add queryTag connection parameter #9889)
• Explains it's connection-scoped (not per-query) and only settable via a custom driverFactory, since there's no env var for it

Test plan

• Preview renders correctly in Mintlify (heading, code block, links resolve)

[claude]

Claude finished @igorlukanin's task in 1m 24s —— View job

---

Review: docs(snowflake): document queryTag connection option

Verified against packages/cubejs-snowflake-driver/src/SnowflakeDriver.ts:109,416-417 — the option exists and is applied on connection. The #driver_factory anchor also resolves in reference/configuration/config.mdx.

Verdict: ship-able. One minor link nit and a couple of small suggestions.

Findings — 0 blocking, 1 minor, 2 nits

Minor — link points to a page that doesn't mention QUERY_TAG

docs-mintlify/admin/connect-to-data/data-sources/snowflake.mdx:401

[snowflake-docs-query-tag]: https://docs.snowflake.com/en/developer-guide/node-js/nodejs-driver-options#additional-connection-options

This is the exact same URL as [snowflake-docs-connection-options] on the line above, and the "Additional connection options" section on that page does not actually document QUERY_TAG — the reader clicks "query tag" and lands on a generic connection-options table. Snowflake's canonical page for the session parameter is:

https://docs.snowflake.com/en/sql-reference/parameters#query-tag

That page explains what QUERY_TAG does, its length limit (2000 chars), and how it surfaces in QUERY_HISTORY — which is exactly what someone following the "query tag" link would want to read.

Nit — section placement

### Query tagging sits as an H3 under ## Setup alongside "Manual" and "Cube Cloud", but it isn't a setup mode — it's an optional post-setup config for either. Consider promoting it to an H2 (e.g. ## Query tagging) after ## Setup, or nesting it under a general "Additional configuration" heading. Not blocking; the current placement is still discoverable.

Nit — reader may wonder about connection details

The driverFactory example only passes queryTag, which works because SnowflakeDriver's constructor falls back to CUBEJS_DB_* env vars for account/warehouse/user/pass — but that's not obvious from the snippet alone. A one-line reassurance ("other connection settings continue to be read from CUBEJS_DB_* env vars") would head off a common "did I just wipe out my connection?" question. Optional.

· [Branch](https://github.com/cube-js/cube/tree/igor/snowflake-query-tag-docs)

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
cubed3	🟢 Ready	View Preview	Jul 27, 2026, 8:18 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
cubed3	🟡 Building	–	Jul 27, 2026, 8:17 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.