Fuego
Release Notes

In Fuego 0.28.0, you can now copy/paste queries, export them as .txt, and use Firestore’s Explain and Analyze to inspect query plans, index usage, cost, and execution stats.

big-idea

Fuego 0.28.0: Enhanced Query Portability and Firestore Explain/Analyze Integration

What’s New in 0.28.0

  • Support for “Explain and Analyze” query metrics: Fuego now integrates Firestore’s Query Explain functionality, allowing you to pinpoint query performance characteristics and optimize accordingly.
  • Copy/Paste support for queries: You can now effortlessly copy and paste queries. This simplifies rerunning identical queries across different collections or databases—greatly improving iteration speed and flexibility when tinkering with data.
  • Share queries as .txt files (where supported): Export and share your queries in plain-text .txt format. Whether you’re collaborating with teammates or keeping a local history, this makes portability and traceability easier. Share Query

What “Explain and Analyze” Brings to the Table

Firestore’s Query Explain offers transparent insights into how your queries are processed—paralleling SQL’s familiar EXPLAIN [ANALYZE]. With the default mode, it outlines how the backend plans the query, revealing which indexes are used and helping you verify index coverage and structure.

Switch on the analyze option, and you get deeper visibility: the tool runs the query and reports performance stats like read operations, billing details, and runtime execution latency—helping you measure real cost and efficiency on a per-query basis.

This is extremely valuable for fine-tuning query patterns and indexing strategies, especially when working through edge cases in large or complex datasets. Explain and Analyze Query

Key Notes:

  • The default explain mode incurs only a single read operation (no full execution), while the analyze variant runs the query normally and bills accordingly.
  • Query Explain is meant for ad-hoc optimization, not aggregate metrics—it’s best used iteratively as you tweak queries.

Why This Matters for You

  • Speeds up query tuning workflows: Copy/paste and query sharing reduce friction when experimenting or collaborating.
  • Deepens visibility into query behavior: Explain and Analyze reveal what’s happening under the hood—index usage, costs, and performance—enabling smarter optimization.