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
- Go to Cartography in the left sidebar.
- Click Run Cartographer.
- 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