Query-to-chart analytics

Build a chart from a question, inspect the SQL, and keep the dashboard configurable

Dashboards connects visual query building, editable SQL, configurable charts, variables, refresh controls, and resizable layouts in one workspace.

Query paths
Visual builder or SQL
Chart setup
Type + fields + colors
Controls
Variables + refresh
Layout
Move + resize blocks

The interface preview uses illustrative data and disabled controls. Available charts, query results, refresh behavior, and collaboration options depend on configured connections, permissions, and deployment.

Illustrative interface

Dashboard chart

Completed-order revenue

Sample configuration - no live data connection or query execution

Query BuilderSQL
Visual query

Selection

public.orders

Read sample
date_trunc(month, created_at)SUM(total_amount)status = completed

Generated SQL

Builder output

READ ONLY
SELECT
  date_trunc('month', orders.created_at) AS month,
  SUM(orders.total_amount) AS revenue
FROM public.orders
WHERE orders.status = 'completed'
GROUP BY 1
ORDER BY 1 ASC
LIMIT 12;

Chart preview

Monthly completed-order revenue

Sample output
Illustrative monthly completed-order revenue$120k$90k$60k$30kJanFebMarAprMayJun$51k$63k$79k$72k$99k$112k

Dashboards keeps the path from question to chart visible. Start with the visual builder or write SQL directly, configure the chart, then arrange the resulting blocks in a dashboard without separating the query from its presentation.

Build the query in the mode that fits the question

The visual builder lets you choose a source and table, select columns, add filters and joins, set sorting, and apply a row limit. Its state can generate SQL for inspection and editing. Use that path when the shape of the question is clearer than the final query text.

Switch to SQL when you need to write or revise the statement directly. The two paths are useful for different stages of the same investigation: assemble the first pass visually, inspect the generated SQL, and refine the query when the question calls for it.

Before adding a chart, check the source, fields, joins, filters, and limit. A chart can make a result easier to read, but it does not establish that the selected data or query logic is correct.

A working sequence

  1. Define the question and select the connection, source, and table that can answer it.
  2. Build or write the query, then inspect the fields, filters, joins, sorting, and row limit.
  3. Configure the chart only after the result shape is suitable for the comparison.
  4. Add the chart to a dashboard with the context a reviewer needs to interpret it.

Configure the chart with the fields in view

Choose a chart type, assign an X field and one or more Y fields, then set the title, legend, display settings, and colors. Map-oriented chart configurations also expose map fields when that configuration is relevant.

The interactive gallery below renders public World Bank data as bar, line, area, pie, radar, and scatter charts. It demonstrates renderer output separately from the disabled product-interface preview above; it is not a live product connection or a statement of current picker availability.

The application registry includes more renderers than the standard chart picker exposes. Available chart choices depend on the interface and deployment; do not assume every registered renderer is directly selectable from the standard picker.

Dashboards / rendering gallery

Six ways to read public records.

This rendering gallery pairs compact SVG charts with USA annual indicators and a 2023 comparison across the United States, Canada, Mexico, and Brazil. Color is paired with direct labels, legends, and focusable marks.

World Bank public indicators · USA 2015–2023 · 2023 country comparison

GDP (current US$), population (people), and life expectancy at birth (years).

Loading live World Bank data · bundled snapshot retrieved 2026-09-02

Bar

2023 GDP by country · current US$

SVG
USACANMEXBRAUSACANMEXBRA

Hover, tap, or focus a mark for its exact value.

Line

USA GDP · current US$ · 2015–2023

SVG
1517192123━●USA GDP

Hover, tap, or focus a mark for its exact value.

Area

USA population · people · 2015–2023

SVG
1517192123▰●USA population

Hover, tap, or focus a mark for its exact value.

Pie

2023 population share · USA, CAN, MEX, BRA

SVG
POP.2023USA 46.9%CAN 5.6%MEX 18.1%BRA 29.4%

Hover, tap, or focus a mark for its exact value.

Radar

USA 2023 profile · normalized to USA 2015–2023 maxima

SVG
GDPPopulationLife expectancy△●USA 2023 / USA maxima

Hover, tap, or focus a mark for its exact value.

Scatter

2023 GDP vs life expectancy · circle size = population

SVG
Life expectancy ↑GDP →USACANMEXBRAUSACANMEXBRA

Hover, tap, or focus a mark for its exact value.

Bundled snapshot retrieved 2026-09-02 is displayed while complete live observations load.

Source: World Bank ↗

Turn a result into a dashboard block

Add chart blocks alongside Markdown blocks to give a dashboard both a visual result and the written context needed to interpret it. A chart block can be edited, duplicated, refreshed, downloaded as CSV, or deleted from its available actions.

Dashboard blocks use a responsive 12-column layout. Move and resize blocks to make the main comparison visible first, keep related filters close to their charts, and preserve space for definitions or review notes. Layout changes persist in the application for the dashboard.

Layout is a presentation decision, not a substitute for query review. A clear grid can make it easier to compare related blocks, but it cannot resolve mismatched time windows, different grains, or incomplete source data.

Keep the question close to the result

Use a Markdown block to record the decision, source boundary, or caveat behind a chart. Chart takeaways provide a place to capture an observation, while comments are available when a chart dashboard block exists. These are review aids, not a claim of real-time collaborative editing or dashboard-level sharing.

When a result needs follow-up, reopen the chart configuration or query rather than treating a static takeaway as the final analysis. The chart, SQL, and block layout should remain inspectable together.

Dashboards / layout

Put the chart beside the context that explains it.

A dashboard can combine chart and Markdown blocks in a responsive 12-column layout. Blocks can be moved and resized, with the resulting layout retained for the dashboard.

Illustrative dashboard canvas12-column layout

Revenue by week

Chart block

8 columns
Sample weekly revenue, weeks one through eight$28kW1$31kW2$29kW3$36kW4$34kW5$42kW6$39kW7$48kW8
Illustrative revenue values in thousands of dollars.
Actual revenue, $kEight-week trendSample values only

Decision context

Markdown block

4 columns

Why the change matters

Use the release note and owner decision beside the chart so a number has working context.

Review the segment before changing the target.

Plan mix

Chart block

4 columns
Enterprise24%Growth18%Team15%Starter12%Scale10%Business8%Pilot6%Education4%Other3%
Nine sample plan segments · 100% distribution

Regional pipeline

Chart block

8 columns
Sample regional pipeline by qualified and review stages44N35NE40E29SE49S34SW51W36NW
QualifiedReview (hatched)Eight sample regional totals
Illustrative pipeline counts. Each labeled regional total combines qualified and review opportunities.

Sample blocks and positions - no live dashboard changes

Parameterize and refresh with operating context

Typed dashboard variables can be defined for inputs that change between views. SQL-variable detection and mapping help connect those inputs to the query. Name variables clearly and check their type and mapping before relying on a filtered result.

Refresh controls include manual refresh and configurable auto-refresh intervals. An interval requests a refresh; it does not guarantee a specific cadence, source availability, query completion, or data freshness. Connection state, permissions, source behavior, and deployment affect the result.

Use manual refresh when you need to deliberately recheck a result. Use an interval when configured repetition is useful, then verify the returned data and timestamps in the context of the source before making a decision.

Review before acting on a changing view

For recurring reviews, document the source, variable values, query assumptions, and expected time window beside the chart. Recheck those details when a dashboard changes shape or a result looks unexpected. Downloaded CSV output and an inspected SQL statement can help make a specific review reproducible.

The preview on this page is illustrative and has no live data connection or query execution. Use Dashboards with connections and permissions configured for the work you need to inspect.

Dashboards / variables and refresh

Keep the question adjustable without obscuring the SQL.

Define typed dashboard variables, then detect and map their SQL references. Refresh can be started manually or configured to run automatically; timing and data freshness still depend on the configured connection and deployment.

Configurable auto-refresh does not guarantee a refresh cadence or the freshness of returned data.

Variables

Illustrative configuration

NameTypeSQL mapping
regionText{{region}}
min_revenueNumber{{min_revenue}}
report_dateDate{{report_date}}
WHERE region = {{region}}
  AND revenue >= {{min_revenue}}
  AND closed_at <= {{report_date}}

Refresh

Manual or configurable automatic refresh

Chart discussion

Takeaways are available for charts.

Comments are available when the dashboard contains a chart block.

Sample configuration - no live data connection or query execution

Open the workspace or read the documentation

Build and configure dashboards in Dashboards. For product guidance, read the visualization documentation.

Bring the question, the work, and the answer into one governed workspace.