marivo.semantic.prepare_dimension#

marivo.semantic.prepare_dimension(*, entity, column, scope=None)[source]#

Prepare a dimension authoring brief for one entity column.

Profiles the column data from the datasource and checks for matches against existing dimensions.

Parameters:

  • entity (str) – Qualified entity reference (e.g. "sales.orders").

  • column (str) – Column name to prepare a dimension brief for.

  • scope (ScanScope | None) – Bounded scan configuration.

Returns:

A single DimensionBrief with status, profile, and match evidence.

Return type:

DimensionBrief

Example

>>> import marivo.semantic as ms
>>> brief = ms.prepare_dimension(entity="sales.orders", column="region")
>>> brief.status