https://github.com/Giorgi/EFCore.Visualizer

Entity Framework Core queries debugger visualizer.
https://github.com/Giorgi/EFCore.Visualizer

debugger-visualizer efcore mysql postgersql query-plan sql-server sqlite visual-studio

Last synced: 16 days ago
JSON representation

Entity Framework Core queries debugger visualizer.

• Host: GitHub
• URL: https://github.com/Giorgi/EFCore.Visualizer
• Owner: Giorgi
• License: gpl-3.0
• Created: 2024-01-23T20:06:45.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-13T20:22:02.000Z (about 1 month ago)
• Last Synced: 2025-04-08T02:38:39.459Z (16 days ago)
• Topics: debugger-visualizer, efcore, mysql, postgersql, query-plan, sql-server, sqlite, visual-studio
• Language: C#
• Homepage: https://marketplace.visualstudio.com/items?itemName=GiorgiDalakishvili.EFCoreVisualizer
• Size: 2.45 MB
• Stars: 565
• Watchers: 11
• Forks: 14
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
![EFCore.Visualizer](doc/IconMedium.png "EFCore.Visualizer")

# Entity Framework Core Query Plan Visualizer

View Entity Framework Core query plan directly inside Visual Studio.

[![Visual Studio Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/GiorgiDalakishvili.EFCoreVisualizer?style=for-the-badge&logo=visualstudio&label=Download%20Now&color=purple)](https://marketplace.visualstudio.com/items?itemName=GiorgiDalakishvili.EFCoreVisualizer)

[![Visual Studio Marketplace Downloads](https://img.shields.io/visual-studio-marketplace/d/GiorgiDalakishvili.EFCoreVisualizer?style=for-the-badge)](https://marketplace.visualstudio.com/items?itemName=GiorgiDalakishvili.EFCoreVisualizer)

[![Visual Studio Marketplace Rating](https://img.shields.io/visual-studio-marketplace/r/GiorgiDalakishvili.EFCoreVisualizer?style=for-the-badge)](https://marketplace.visualstudio.com/items?itemName=GiorgiDalakishvili.EFCoreVisualizer&ssr=false#review-details)

## Introduction

With the Entity Framework Core query plan debugger visualizer, you can view the query plan of your queries directly inside Visual Studio. Currently, the visualizer supports SQL Server, PostgreSQL, SQLite, MySQL and Oracle.

> [!IMPORTANT] 

> The visualizer requires **Visual Studio Version 17.9.0 ([Released on February 13th](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-9-now-available/)) or newer** and supports **EF Core 7 or newer**.

## Usage

After installing the [extension from the marketplace](https://marketplace.visualstudio.com/items?itemName=GiorgiDalakishvili.EFCoreVisualizer), a new debugger visualizer will be added to Visual Studio. When debugging, hover over your queries and there will be an option to view the query plan (Here we show the actual query plan which means it forces query execution ):

![VariableVisualizer](doc/VariableVisualizer.png)

Click on 'Query Plan Visualizer' and the query plan will be displayed for your query.

### SQL Server:

![Sql Server Plan](doc/SqlServerDarkMode.png)

![Sql Server Plan](doc/SqlServerLightMode.png)

### PostgreSQL:

![PostgreSQL Plan](doc/PostgreSQLPlan2.png)

![PostgreSQL Plan](doc/PostgreSQLPlan1.png)

### MySQL:

![MySQL Plan](doc/MySqlLightMode.png)

![MySQL Plan](doc/MySqlDarkMode.png)

### SQLite:

![SQLite Plan](doc/SQLitePlan.png)

### Oracle:

The query plan includes Actual IO stats, Outline data, Projections, and Predicates.

![Oracle Plan](doc/OraclePlan1.png)

![Oracle Plan](doc/OraclePlan2.png)

## Known Issues:

 - If query plan extraction takes more than 5 seconds, you will get [Evaluation timed out error](https://github.com/Giorgi/EFCore.Visualizer/issues/25)

 - If your project uses Application Insights, you might get [Cannot evaluate expression since the function evaluation requires all threads to run.](https://github.com/Giorgi/EFCore.Visualizer/issues/28) when viewing query plan. **Workaround** - disable Application Insights when running your project with a debugger attached.

## Credits

This extension uses [pev2](https://github.com/dalibo/pev2/), [html-query-plan](https://github.com/JustinPealing/html-query-plan) and 

[Treeflex](https://dumptyd.github.io/treeflex/) to display query plans.