https://github.com/snowflake-labs/dbt_semantic_view
The DBT package to support Snowflake Semantic View as a new materialization.
https://github.com/snowflake-labs/dbt_semantic_view
Last synced: 9 months ago
JSON representation
The DBT package to support Snowflake Semantic View as a new materialization.
- Host: GitHub
- URL: https://github.com/snowflake-labs/dbt_semantic_view
- Owner: Snowflake-Labs
- License: apache-2.0
- Created: 2025-09-10T21:34:26.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T22:24:14.000Z (9 months ago)
- Last Synced: 2025-10-01T22:24:50.089Z (9 months ago)
- Language: Python
- Size: 987 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Snowflake Semantic View dbt Package
Professional dbt macros and integration tests for building, dropping, and renaming Snowflake Semantic Views. This package lets you materialize Semantic Views via dbt and reference them from downstream models.
### At a glance
- **Materialization**: `semantic_view`
- **Warehouse**: Snowflake
- **dbt Compatibility**: dbt 1.x
### Quickstart
Follow these steps on macOS/Linux with Python 3 installed. No prior dbt installation is required.
1) Clone and enter the repo
```
git clone https://github.com/Snowflake-Labs/dbt-snowflake-semantic-view.git
cd dbt-snowflake-semantic-view
```
2) Create an isolated Python environment and install dependencies
```
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install dbt-snowflake
```
3) Configure Snowflake credentials (env vars)
Set the following environment variables for the integration profile. For username/password auth use `SNOWFLAKE_TEST_AUTHENTICATOR=snowflake`.
```
export SNOWFLAKE_TEST_ACCOUNT=
export SNOWFLAKE_TEST_USER=
export SNOWFLAKE_TEST_PASSWORD=
export SNOWFLAKE_TEST_AUTHENTICATOR= # e.g. snowflake | externalbrowser
export SNOWFLAKE_TEST_ROLE=
export SNOWFLAKE_TEST_DATABASE=
export SNOWFLAKE_TEST_WAREHOUSE=
export SNOWFLAKE_TEST_SCHEMA=
```
4) Run integration tests
```
cd integration_tests/
dbt deps --target snowflake
dbt build --target snowflake
```
### Usage in your dbt project
Add to `packages.yml`:
```
packages:
- package: Snowflake-Labs/dbt_semantic_view
```
Create a model using the Semantic View materialization:
```
{{ config(materialized='semantic_view') }}
TABLES(
{{ source('', '') }},
{{ ref('') }}
)
[ RELATIONSHIPS ( relationshipDef [ , ... ] ) ]
[ FACTS ( semanticExpression [ , ... ] ) ]
[ DIMENSIONS ( semanticExpression [ , ... ] ) ]
[ METRICS ( semanticExpression [ , ... ] ) ]
[ COMMENT = '' ]
[ COPY GRANTS ]
```
Reference a Semantic View from another model:
```
{{ config(materialized='table') }}
select *
from semantic_view(
{{ ref('') }}
[ { METRICS | FACTS } ]
[ DIMENSIONS ]
[ WHERE ]
)
```
### Development
- Python 3.9+ recommended
- Use a venv: `python3 -m venv .venv && source .venv/bin/activate`
- Install tooling as needed: `pip install dbt-snowflake`
### Contributing
We welcome issues and PRs! Please:
- Open an issue to discuss significant changes
- Keep edits focused and include tests where possible
- Follow dbt and Python best practices
### License
Apache License 2.0. See `LICENSE` for details.