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
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
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
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
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
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
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
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
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
- Table-level: Hex Semantic Model → dbt Semantic Model (via - table_dependencies)
- Field-level: Hex Dimension → dbt Dimension (via - upstream_fields, only for regular dimensions)
- Field-level: Hex Measure → dbt Metric (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.
Last updated
