Bruin Semantic Layer

Workflow

1. Find the repository root and inspect semantic/ before editing. Bruin loads every .yml and .yaml model under the repository-level semantic/ directory next to .bruin.yml.
2. Use local source of truth before guessing: docs/core-concepts/semantic-layer.md, docs/commands/query.md, docs/commands/semantic.md, semantic-engine/model.go, semantic-engine/engine.go, semantic-engine/graph.go, and semantic-engine/checks.go.
3. Keep model names unique across the semantic catalog. New models should set schema: v1, although omitted schema defaults to v1.
4. Prefer reusable, business-named metrics, dimensions, and segments. Avoid putting dashboard-specific logic into one large SQL query.
5. Validate with bruin semantic validate, run bruin semantic check when a connection is available, then run the repository-required final checks before finishing.

Model Pattern

Create or edit files under semantic/:

schema: v1
name: orders
label: Orders
description: Revenue and order metrics