Snowflake Semanticview

1---2name: snowflake-semanticview3description: Create, alter, and validate Snowflake semantic views using Snowflake CLI (snow). Use when asked to build or troubleshoot semantic views/semantic layer definitions with CREATE/ALTER SEMANTIC VIEW, to validate semantic-view DDL against Snowflake via CLI, or to guide Snowflake CLI installation and connection setup.4---5 6# Snowflake Semantic Views7 8## One-Time Setup9 10- Verify Snowflake CLI installation by opening a new terminal and running `snow --help`.11- If Snowflake CLI is missing or the user cannot install it, direct them to https://docs.snowflake.com/en/developer-guide/snowflake-cli/installation/installation.12- Configure a Snowflake connection with `snow connection add` per https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection.13- Use the configured connection for all validation and execution steps.14 15## Workflow For Each Semantic View Request16 171. Confirm the target database, schema, role, warehouse, and final semantic view name.182. Confirm the model follows a star schema (facts with conformed dimensions).193. Draft the semantic view DDL using the official syntax:20   - https://docs.snowflake.com/en/sql-reference/sql/create-semantic-view214. Populate synonyms and comments for each dimension, fact, and metric:22   - Read Snowflake table/view/column comments first (preferred source):23     - https://docs.snowflake.com/en/sql-reference/sql/comment24   - If comments or synonyms are missing, ask whether you can create them, whether the user wants to provide text, or whether you should draft suggestions for approval.255. Use SELECT statements with DISTINCT and LIMIT (maximum 1000 rows) to discover relationships between fact and dimension tables, identify column data types, and create more meaningful comments and synonyms for columns.266. Create a temporary validation name (for example, append `__tmp_validate`) while keeping the same database and schema.277. Always validate by sending the DDL to Snowflake via Snowflake CLI before finalizing:28   - Use `snow sql` to execute the statement with the configured connection.29   - If flags differ by version, check `snow sql --help` and use the connection option shown there.308. If validation fails, iterate on the DDL and re-run the validation step until it succeeds.319. Apply the final DDL (create or alter) using the real semantic view name.3210. Run a sample query against the final semantic view to confirm it works as expected. It has a different SQL syntax as can be seen here: https://docs.snowflake.com/en/user-guide/views-semantic/querying#querying-a-semantic-view33Example:34 35```SQL36SELECT * FROM SEMANTIC_VIEW(37    my_semview_name38    DIMENSIONS customer.customer_market_segment39    METRICS orders.order_average_value40)41ORDER BY customer_market_segment;42```43 4411. Clean up any temporary semantic view created during validation.45 46## Synonyms And Comments (Required)47 48- Use the semantic view syntax for synonyms and comments:49 50```51WITH SYNONYMS [ = ] ( 'synonym' [ , ... ] )52COMMENT = 'comment_about_dim_fact_or_metric'53```54 55- Treat synonyms as informational only; do not use them to reference dimensions, facts, or metrics elsewhere.56- Use Snowflake comments as the preferred and first source for synonyms and comments:57  - https://docs.snowflake.com/en/sql-reference/sql/comment58- If Snowflake comments are missing, ask whether you can create them, whether the user wants to provide text, or whether you should draft suggestions for approval.59- Do not invent synonyms or comments without user approval.60 61## Validation Pattern (Required)62 63- Never skip validation. Always execute the DDL against Snowflake with Snowflake CLI before presenting it as final.64- Prefer a temporary name for validation to avoid clobbering the real view.65 66## Example CLI Validation (Template)67 68```bash69# Replace placeholders with real values.70snow sql -q "<CREATE OR ALTER SEMANTIC VIEW ...>" --connection <connection_name>71```72 73If the CLI uses a different connection flag in your version, run:74 75```bash76snow sql --help77```78 79## Notes80 81- Treat installation and connection setup as one-time steps, but confirm they are done before the first validation.82- Keep the final semantic view definition identical to the validated temporary definition except for the name.83- Do not omit synonyms or comments; consider them required for completeness even if optional in syntax.