Skip to main content

Cartography

Cartography is an AI-powered tool that analyzes your data connections and discovers relationships between them. It helps you understand how your data sources relate to each other — which tables share common fields, where data flows overlap, and what patterns exist across your organization's data.

Running Cartography

  1. Go to Cartography in the left sidebar.
  2. Click Run Cartographer.
  3. Wait for the analysis to complete. The AI examines each data connection's schema and content to find relationships.

The process runs in the background. You can navigate away and come back — progress is saved.

What it discovers

Cartography produces three types of results:

Relationships

Connections between data sources that share common fields or overlapping data. For example, a Tulip table and a SQL query that both contain order IDs.

Entities

Key data entities (objects, concepts) found across your connections. For example, "Production Orders" might appear in multiple connections.

Patterns

Recurring data patterns or flows across your organization's data landscape.

Viewing results

After a run completes, the Cartography page shows results in three tabs:

  • Relationships — A visual map and list of discovered connections between data sources
  • Entities — Key entities found across your data
  • Patterns — Observed data patterns and recommendations

Limits

  • You can run Cartography up to 5 times per day. The remaining run count is displayed on the page.
  • Results from a run become stale after 30 minutes, indicated by a visual marker. You can run again to refresh.
  • The analysis examines connections you have access to. Admins see relationships across all connections; members see only their accessible connections.

When to use it

  • When onboarding to understand an existing data landscape
  • After adding new data connections, to see how they relate to existing ones
  • When planning new widgets or dashboards, to discover data sources you might not have known about