Your users want charts. They want to see their revenue over time, their top customers by order value, their support ticket trends — all inside your app, not exported to a spreadsheet.
So you open up the docs for some enterprise BI platform and realize: this is overkill. You don't need a full data warehouse, a semantic layer, a drag-and-drop report builder, and a six-figure annual contract. You just want to run a SQL query and show the result as a line chart.
The good news: you absolutely can, and it's less work than you think. If you want a ready-made path, tools like Draxlr handle this out of the box. But this article walks through the practical patterns for embedding live SQL-backed charts in your app without buying or building a full BI stack.
Why Developers Reach for BI Tools Prematurely
The instinct makes sense. You need charts → you Google "analytics for apps" → you land on Tableau Embedded, Looker, or PowerBI Embedded. These are great tools, but they come with real overhead:
- Weeks of setup and data modeling
- Per-seat or per-embed pricing that balloons as you grow
- A separate data pipeline or semantic layer requirement
- Complex SDKs to integrate and maintain
For many apps, the actual requirement is simpler: run a SQL query, transform the result into [{x, y}] shaped data, pass it to a charting library. That's it. No warehouse, no pipeline, no vendor lock-in.
The Core Pattern: SQL → JSON → Chart
The fundamental pattern looks like this:
User loads dashboard
→ Your API runs a SQL query against your DB
→ Returns JSON array
→ Frontend renders it with a charting library
Let's make it concrete. Suppose you have a SaaS app and want to show each customer their monthly revenue.
The Query
SELECT
DATE_TRUNC('month', created_at) AS month,
SUM(amount_cents) / 100.0 AS revenue
FROM orders
WHERE
account_id = $1
AND status = 'paid'
AND created_at >= NOW() - INTERVAL '12 months'
GROUP BY 1
ORDER BY 1;
This returns rows like:
| month | revenue |
|---|---|
| 2025-07-01 | 4820.00 |
| 2025-08-01 | 5210.50 |
| 2025-09-01 | 6340.00 |
The API Endpoint
// Express / Node example
app.get('/api/charts/revenue', requireAuth, async (req, res) => {
const { rows } = await db.query(`
SELECT
DATE_TRUNC('month', created_at) AS month,
SUM(amount_cents) / 100.0 AS revenue
FROM orders
WHERE account_id = $1
AND status = 'paid'
AND created_at >= NOW() - INTERVAL '12 months'
GROUP BY 1
ORDER BY 1
`, [req.user.accountId]);
res.json(rows);
});
The Frontend Chart
Using Chart.js (a lightweight option, ~60kb):
const data = await fetch('/api/charts/revenue').then(r => r.json());
new Chart(ctx, {
type: 'line',
data: {
labels: data.map(r => r.month),
datasets: [{
label: 'Monthly Revenue',
data: data.map(r => r.revenue),
}]
}
});
That's a real, live, customer-scoped chart with about 30 lines of code.
A Few Charts Worth Having by Default
Once you have the pattern down, adding charts is fast. Here are three that cover 80% of what customers ask for.
1. Monthly Active Users
SELECT
DATE_TRUNC('month', event_time) AS month,
COUNT(DISTINCT user_id) AS active_users
FROM events
WHERE account_id = $1
AND event_time >= NOW() - INTERVAL '6 months'
GROUP BY 1
ORDER BY 1;
2. Top 10 Customers by Spend
SELECT
c.name,
SUM(o.amount_cents) / 100.0 AS total_spend
FROM orders o
JOIN customers c ON c.id = o.customer_id
WHERE o.account_id = $1
AND o.status = 'paid'
GROUP BY c.name
ORDER BY total_spend DESC
LIMIT 10;
3. Funnel Conversion by Step
SELECT
step_name,
COUNT(DISTINCT user_id) AS users
FROM funnel_events
WHERE account_id = $1
AND created_at >= NOW() - INTERVAL '30 days'
GROUP BY step_name
ORDER BY MIN(step_order);
Each of these maps cleanly to a bar chart, line chart, or horizontal bar chart with a one-line frontend binding.
The One Thing You Must Get Right: Tenant Isolation
The most dangerous mistake when embedding charts is forgetting that every query runs in a multi-tenant context. A bug that lets one customer's data leak into another customer's chart is a serious incident.
Always scope every query to the authenticated account:
-- ✅ Safe: account_id scoped in WHERE clause
SELECT DATE_TRUNC('month', created_at), SUM(amount)
FROM orders
WHERE account_id = $1 -- $1 comes from your auth session
GROUP BY 1;
-- ❌ Dangerous: no tenant scope
SELECT DATE_TRUNC('month', created_at), SUM(amount)
FROM orders
GROUP BY 1;
If you use an ORM, make sure your base query scope always injects the tenant filter. If you're writing raw SQL, enforce a code review rule: every chart query must reference account_id = $1 (or equivalent).
A deeper safety layer is PostgreSQL row-level security (RLS), which enforces tenant isolation at the database level even if a query forgets the filter — but even without RLS, disciplined query scoping is non-negotiable.
Caching Matters More Than You Think
Live charts that hit your production database on every page load can become a problem fast. For charts that aggregate over large tables (revenue over 2 years, MAU trends), even a 5-minute cache dramatically reduces load.
Simple approach with Redis or Postgres:
async function getCachedChartData(key, ttlSeconds, queryFn) {
const cached = await redis.get(key);
if (cached) return JSON.parse(cached);
const data = await queryFn();
await redis.set(key, JSON.stringify(data), 'EX', ttlSeconds);
return data;
}
// Usage
const data = await getCachedChartData(
`revenue:${accountId}`,
300, // 5 minutes
() => db.query(revenueQuery, [accountId])
);
For most customer-facing dashboards, 5–15 minute cache TTLs are invisible to users and meaningfully protect your DB under load.
Common Mistakes
1. Returning too many rows to the frontend. If your query returns 50,000 rows and you send all of them to the browser, you'll crash the chart render. Always aggregate in SQL — let the database do the grouping and summarizing, not JavaScript.
2. Using client-side GROUP BY instead of SQL. Fetching raw events and grouping in the browser is slow, wasteful on bandwidth, and exposes row-level data you probably shouldn't be sending.
3. Hardcoding date ranges. Make time windows configurable so users can toggle between 7 days, 30 days, 90 days. A single $2 parameter for the interval handles this cleanly.
4. Not handling empty data. When a new customer signs up, all chart queries return zero rows. Make sure your frontend gracefully shows an empty state rather than crashing.
5. Forgetting indexes on your date columns. A created_at index (or a partial index scoped to the most recent months) is the difference between a 12ms chart query and a 4-second one.
-- Add this if you don't have it
CREATE INDEX idx_orders_account_created
ON orders (account_id, created_at DESC);
When to Actually Buy a Tool
The DIY approach works well until it doesn't. Consider an off-the-shelf solution when:
- You need users to build their own custom reports (not just view pre-built ones)
- You're aggregating across multiple databases or data sources
- Your compliance requirements demand audit logging of every data access
- Your engineering team is spending more than a sprint per quarter maintaining chart code
At that point, tools like Draxlr, Holistics, or Embeddable let you wrap your SQL queries in a managed layer with embedding, auth, and caching handled for you — without the full cost and complexity of an enterprise BI platform.
Key Takeaways
- You don't need a BI tool to ship useful charts — the pattern is: SQL query → API endpoint → charting library
- Always scope every query to the authenticated tenant; missing this is a data leak waiting to happen
- Aggregate data in SQL, not JavaScript — let the database do what it's good at
- Cache aggressively for large aggregations; 5 minutes of caching is invisible to users
- Add indexes on
(account_id, created_at)before you go to production, not after
Have you built embedded charts the DIY way, or did you reach for a tool? Drop your approach in the comments — always curious what stacks teams are using in practice.
For further actions, you may consider blocking this person and/or reporting abuse
