Profiling Queries with EXPLAIN and PROFILE
Learn to read Cypher execution plans using EXPLAIN and PROFILE to diagnose and fix slow queries in Neo4j.
Profiling Queries with EXPLAIN and PROFILE is a free Neo4j Graph Database Fundamentals lesson on CoddyKit — lesson 4 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Neo4j Graph Database Fundamentals learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
You Cannot Tune What You Cannot See
Before optimizing a query, you must understand how Neo4j executes it. The EXPLAIN and PROFILE keywords reveal the execution plan.
EXPLAIN: The Plan Without Running
EXPLAIN shows the planned operators without actually executing the query. Use it to inspect plans safely, even for writes.
EXPLAIN
MATCH (p:Person {name: 'Alice'})-[:FRIEND]->(f)
RETURN f.name;PROFILE: The Plan With Real Numbers
PROFILE runs the query and reports actual db hits and rows per operator. This is your main tuning tool.
PROFILE
MATCH (p:Person {name: 'Alice'})-[:FRIEND]->(f)
RETURN f.name;Reading Operators
Plans are trees of operators such as:
- NodeByLabelScan — scans all nodes with a label
- NodeIndexSeek — uses an index (fast)
- Expand — follows relationships
- Filter — applies a predicate
The Enemy: Full Scans
A NodeByLabelScan on a large label means Neo4j reads every node of that type. Replacing it with a NodeIndexSeek is the most common big win.
Counting db Hits
db hits estimate work done. Fewer is better. Compare db hits before and after a change to confirm improvement.
Adding an Index to Fix a Scan
If PROFILE shows a label scan filtered by a property, add an index on that property and re-profile.
CREATE INDEX person_name IF NOT EXISTS FOR (p:Person) ON (p.name);Watching Row Counts
Each operator shows estimated and actual rows. A big gap between them means the planner's statistics are stale.
Eager Operators
An Eager operator forces Neo4j to materialize all rows before continuing, often inflating memory. Restructuring the query can sometimes remove it.
Cartesian Products
A CartesianProduct warning means two disconnected patterns multiply together. Connect them with a relationship or a WHERE to avoid an explosion.
// Bad: disconnected
MATCH (a:Person), (b:Company)
RETURN a, b;A Tuning Workflow
Profile, find the most expensive operator, address it (index, restructure, anchor the match), then profile again. Iterate until db hits are acceptable.
Quick Check
Test your profiling knowledge.
Recap
You learned to profile Cypher queries:
- EXPLAIN shows the plan; PROFILE adds real metrics
- Replace label scans with index seeks
- Minimize db hits
- Avoid cartesian products and unnecessary eager operators
- Iterate: profile, fix, re-profile
Frequently asked questions
Is the “Profiling Queries with EXPLAIN and PROFILE” lesson free?
Yes — the full text of “Profiling Queries with EXPLAIN and PROFILE” is free to read here on the web, and the Neo4j Graph Database Fundamentals course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Neo4j Graph Database Fundamentals course, upgrade to CoddyKit PRO.
What will I learn in “Profiling Queries with EXPLAIN and PROFILE”?
Learn to read Cypher execution plans using EXPLAIN and PROFILE to diagnose and fix slow queries in Neo4j. You practise Neo4j Graph Database Fundamentals with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Neo4j Graph Database Fundamentals?
No prior experience is required. Neo4j Graph Database Fundamentals on CoddyKit is structured for beginners through advanced learners; this is — lesson 4 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Profiling Queries with EXPLAIN and PROFILE” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Neo4j Graph Database Fundamentals lesson?
Yes. Every Neo4j Graph Database Fundamentals lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Optimizing Cypher Query Performance
- Advanced Indexing Strategies
- Scaling Neo4j with Causal Clustering
- Profiling Queries with EXPLAIN and PROFILE