Skip to content

docs(snowflake): clarify output format and link native Ossie semantic-view functions #208

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alphonse-terrier wants to merge 3 commits into
base: main
Choose a base branch
from
+9 −0
Open

docs(snowflake): clarify output format and link native Ossie semantic-view functions #208

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ebe5973
docs(snowflake): clarify output format and Ossie semantic-view functions
alphonse-terrier Jul 15, 2026
614299b
docs(snowflake): clarify output format and link native Ossie semantic…
alphonse-terrier Jul 15, 2026
51b88fa
docs(snowflake): rename *_OSI_* functions into *_OSSIE_*
alphonse-terrier Jul 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions converters/snowflake/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@

Converts Ossie YAML semantic models to [Snowflake Cortex Analyst](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-analyst) semantic model YAML. Pure offline conversion — no Snowflake connection required.

> **Output format:** This converter produces the **legacy** Cortex Analyst semantic model YAML — the stage-based format. It is *not* the newer Snowflake [semantic view YAML](https://docs.snowflake.com/en/user-guide/views-semantic/semantic-view-yaml-spec) (`views-semantic`) that pairs with the `CREATE SEMANTIC VIEW` DDL. The two structures overlap heavily but are distinct Snowflake surfaces. See [Ossie YAML and Snowflake semantic views](#ossie-yaml-and-snowflake-semantic-views) below for how to get to an actual semantic view.

> **Note:** This converter is under active development. It handles common cases but has not been thoroughly tested against all edge cases — use with caution in production.

## Setup
Expand All @@ -44,3 +46,10 @@ python3 -m pytest tests/
## Limitations

Some Ossie concepts (e.g., `ai_context` on relationships) do not have a native counterpart in the Snowflake semantic model. These are dropped during conversion and the converter will emit warnings so you know what was left behind.

## Ossie YAML and Snowflake semantic views

A dedicated open-source Ossie ↔ semantic-view converter would be a welcome future addition. In the meantime, Snowflake can already read and write Ossie YAML natively, so the round-trip works today:

- [`SYSTEM$CREATE_SEMANTIC_VIEW_FROM_OSSIE_YAML`](https://docs.snowflake.com/en/sql-reference/stored-procedures/system_create_semantic_view_from_ossie_yaml) — create a semantic view directly from Ossie YAML (Ossie YAML → semantic view).
- [`SYSTEM$READ_OSSIE_YAML_FROM_SEMANTIC_VIEW`](https://docs.snowflake.com/en/sql-reference/functions/system_read_ossie_yaml_from_semantic_view) — export an existing semantic view to Ossie YAML (semantic view → Ossie YAML).