Hex Semantic Project Discovered Resources

Overview

The Hex Semantic Project integration discovers the following resources:

• Hex Workspace

• Hex Semantic Project

• Hex Semantic Model

• Hex Dimension

• Hex Measure

• dbt Semantic Model

• dbt Dimension

• dbt Metric

Hex Workspace

A single resource of type "hex_workspace" is observed for each configured workspace in the integration settings.

Properties

Property	Value
name	The workspace identifier from configuration
type	always hex_workspace
subtype	always hex_workspace

Hex Semantic Project

A single resource of type "hex_semantic_project" is observed for each configured semantic project.

Properties

Property	Value
name	The semantic project name from configuration
type	always hex_semantic_project
subtype	always hex_semantic_project
semantic_project_type	Type of semantic project (e.g., "dbt_metricflow")
workspace_id	The parent workspace ID

Hex Semantic Model

Semantic models are discovered from dbt MetricFlow YAML files. Only semantic models with config.meta.hex configuration are processed.

Properties

Property	Value
name	The semantic model name
type	always hex_semantic_model
subtype	always hex_semantic_model
description	Model description from YAML

Relationships

• Parent: Hex Semantic Project

• Dependencies: References corresponding dbt semantic model as upstream

Hex Dimension

Dimensions are discovered from both semantic model dimensions and entities. There are two types:

Regular Dimensions

Discovered from the dimensions section of semantic models. These have corresponding dbt dimensions and field-level lineage.

Entity-based Dimensions

Discovered from the entities section of semantic models. Only entities with types primary, unique, natural, or foreign are processed. These do NOT have corresponding dbt dimensions or field-level lineage.

Properties

Property	Value
name	The dimension name
type	always hex_dimension
subtype	always hex_dimension
description	Dimension description

Relationships

• Parent: Hex Semantic Model

• upstream_fields: References corresponding dbt dimension (only for regular dimensions, not entity-based dimensions)

Hex Measure

Measures are discovered from semantic models (when create_metric: true) and standalone simple metrics that reference existing measures. We currently do not observe non-simple dbt metrics.

Properties

Property	Value
name	The measure name
type	always hex_measure
subtype	always hex_measure
description	Measure description

Relationships

• Parent: Hex Semantic Model

• Field-level Lineage: References corresponding dbt metric via upstream_fields

dbt Semantic Model

dbt semantic models correspond to each valid Hex semantic model and are created to maintain lineage.

Properties

Property	Value
name	The semantic model name
type	always dbt_semantic_model
subtype	always dbt_semantic_model
description	Model description

dbt Dimension

dbt dimensions correspond to each regular dimension (from the dimensions section) in valid semantic models. Note that entity-based dimensions do NOT have corresponding dbt dimension resources.

Properties

Property	Value
name	The dimension name
type	always dbt_dimension
subtype	always dbt_dimension

Relationships

• Parent: dbt Semantic Model

dbt Metric

dbt metrics are created for measures with create_metric: true and standalone simple metrics.

Properties

Property	Value
name	The metric name
type	always dbt_metric
subtype	always dbt_metric

Relationships

Parent/Child

• Hex Workspace → Hex Semantic Project: Semantic projects are children of workspaces

• Hex Semantic Project → Hex Semantic Model: Semantic models are children of semantic projects

• Hex Semantic Model → Hex Dimensions and Hex Measures: Dimensions and measures are children of semantic models

• dbt Semantic Model → dbt Dimensions: dbt dimensions are children of dbt semantic models

Cross-Platform Lineage

Source type(s)	Relationship	Target type(s)	Notes
dbt_semantic_model	has upstream	hex_semantic_model	Via table_dependencies
dbt_dimension	has upstream_fields	hex_dimension	Regular dimensions only
dbt_metric	has upstream_fields	hex_measure	Via upstream_fields

Note: Entity-based dimensions (from semantic model entities) do not have cross-platform lineage as they don't have corresponding dbt dimension resources.