From ebe5973c5aa02bdc2d833e08be61c993265d06e1 Mon Sep 17 00:00:00 2001 From: Alphonse Terrier Date: Wed, 15 Jul 2026 15:25:12 +0200 Subject: [PATCH 1/3] docs(snowflake): clarify output format and Ossie semantic-view functions --- converters/snowflake/README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/converters/snowflake/README.md b/converters/snowflake/README.md index 249624e..e95fddb 100644 --- a/converters/snowflake/README.md +++ b/converters/snowflake/README.md @@ -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 @@ -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_OSI_YAML` — create a semantic view directly from Ossie YAML (Ossie YAML → semantic view). +- `SYSTEM$READ_OSI_YAML_FROM_SEMANTIC_VIEW` — export an existing semantic view to Ossie YAML (semantic view → Ossie YAML). From 614299bc64f3e06a07dec3ca4ca8abd873d00f9d Mon Sep 17 00:00:00 2001 From: Alphonse Terrier Date: Wed, 15 Jul 2026 15:28:36 +0200 Subject: [PATCH 2/3] docs(snowflake): clarify output format and link native Ossie semantic-view functions --- converters/snowflake/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/converters/snowflake/README.md b/converters/snowflake/README.md index e95fddb..762fd30 100644 --- a/converters/snowflake/README.md +++ b/converters/snowflake/README.md @@ -51,5 +51,5 @@ Some Ossie concepts (e.g., `ai_context` on relationships) do not have a native c 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_OSI_YAML` — create a semantic view directly from Ossie YAML (Ossie YAML → semantic view). -- `SYSTEM$READ_OSI_YAML_FROM_SEMANTIC_VIEW` — export an existing semantic view to Ossie YAML (semantic view → Ossie YAML). +- [`SYSTEM$CREATE_SEMANTIC_VIEW_FROM_OSI_YAML`](https://docs.snowflake.com/en/sql-reference/stored-procedures/system_create_semantic_view_from_osi_yaml) — create a semantic view directly from Ossie YAML (Ossie YAML → semantic view). +- [`SYSTEM$READ_OSI_YAML_FROM_SEMANTIC_VIEW`](https://docs.snowflake.com/en/sql-reference/functions/system_read_osi_yaml_from_semantic_view) — export an existing semantic view to Ossie YAML (semantic view → Ossie YAML). From 51b88faa144e50e5cc0b28e8e38918410571a1ba Mon Sep 17 00:00:00 2001 From: Alphonse Terrier Date: Thu, 16 Jul 2026 16:57:00 +0200 Subject: [PATCH 3/3] docs(snowflake): rename *_OSI_* functions into *_OSSIE_* --- converters/snowflake/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/converters/snowflake/README.md b/converters/snowflake/README.md index 762fd30..66f5854 100644 --- a/converters/snowflake/README.md +++ b/converters/snowflake/README.md @@ -51,5 +51,5 @@ Some Ossie concepts (e.g., `ai_context` on relationships) do not have a native c 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_OSI_YAML`](https://docs.snowflake.com/en/sql-reference/stored-procedures/system_create_semantic_view_from_osi_yaml) — create a semantic view directly from Ossie YAML (Ossie YAML → semantic view). -- [`SYSTEM$READ_OSI_YAML_FROM_SEMANTIC_VIEW`](https://docs.snowflake.com/en/sql-reference/functions/system_read_osi_yaml_from_semantic_view) — export an existing semantic view to Ossie YAML (semantic view → Ossie YAML). +- [`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).