Catalog

What is the Catalog?

The Catalog is the searchable inventory of data assets visible to your role. It brings together warehouse tables, source metadata, Transformation Models, Semantic Models, dashboards, metrics, and lineage into one map.

[picture 1. Catalog page with search results and asset type filters]

What you can use it for

Use the Catalog to answer:

• What data exists in this workspace?
• Which table contains a field?
• Which Transformation Model produces a report-ready dataset?
• Which Semantic Model defines a metric?
• Which dashboards use this model?
• Which upstream sources feed a dashboard?
• Is a connector, table, model, or dashboard stale?

Asset types

Catalog asset types can include:

• Source connectors.
• Source tables and warehouse relations.
• dbt and managed Transformation Models.
• Semantic Models.
• Metrics, measures, and dimensions.
• Dashboards.
• Snapshots and other modeled assets, depending on the workspace.

The exact list depends on the workspace configuration and your role permissions.

Lineage

Lineage connects upstream and downstream assets.

Upstream lineage answers: "What does this depend on?"

Downstream lineage answers: "What will break or need review if this changes?"

Examples:

• A dashboard depends on Semantic Models.
• A Semantic Model depends on a published Transformation Model.
• A Transformation Model depends on source tables.
• A source table depends on a connector.

Catalog and Agent

The Agent uses the Catalog before it queries or builds. This helps it:

• Find the right model instead of guessing table names.
• Prefer governed metrics over raw columns.
• Trace how a dashboard KPI is computed.
• Respect schema and role restrictions.
• Avoid using hidden or restricted assets.
• Identify stale or failed upstream data.

Useful prompts:

• "Search the Catalog for revenue."
• "Find columns named customer_id."
• "Trace upstream from this dashboard."
• "Trace downstream from this Transformation Model."
• "Which dashboards use orders_enriched?"

Catalog refresh

The Catalog is recomputed from the underlying systems. If a source, model, or dashboard was just created, it may not appear until refresh completes.

If the Agent cannot find something that was recently added:

1. Check that the object was published or saved.
2. Confirm your role can access it.
3. Refresh or wait for Catalog metadata.
4. Ask the Agent to search again with the exact name.

Access limits

Catalog search is access-aware. If your role cannot read a schema, dashboard, or model, the Catalog and Agent should not expose it to you. Administrators can manage Agent-visible schemas in Settings > Agent Data Access.