New: AI & text-to-SQL on your own SupersetBook a demo
Docs
Quickstart

Quickstart

Connect a database, deploy Superset, model your data with AI, and build your first dashboard.

This guide takes you from zero to a live dashboard in a few minutes.

1. Create a workspace

Sign up at app.d23.io and create a workspace. A workspace is your isolated Superset environment — it holds your database connections, datasets, charts, dashboards, and users.

2. Connect a database

Add a database connection so Superset can query your data.

  • Go to Settings → Database Connections and click + Database.
  • Select your database type (Snowflake, BigQuery, Postgres, ClickHouse, Redshift, Databricks, etc.).
  • Enter your connection string or fill in the guided form. D23 stores credentials encrypted at rest.

Browse the integrations directory for connection guides per database.

3. Create a dataset

A dataset is a table, view, or SQL query that Superset can chart.

  • Go to Datasets → + Dataset, choose your database and table (or write a virtual SQL dataset).
  • Set column types, mark time columns, and define any calculated columns or metrics.

4. Ask AI (text-to-SQL)

Open SQL Lab and click Ask AI. Type your question in plain English — "Show monthly revenue by region for 2025" — and D23 generates, runs, and explains the SQL. Edit before running if needed.

5. Build a chart

  • From your dataset, click Create chart.
  • Choose a chart type (bar, line, time-series, table, map, etc.).
  • Drag dimensions and metrics into the query builder, then click Run.
  • Save the chart and add it to a dashboard.

6. Publish a dashboard

  • Go to Dashboards → + Dashboard, drag in your charts, and arrange the layout.
  • Click Save and share the link, or embed it in your product (see Deployment).

Next steps

  • Concepts — how datasets, charts, and dashboards fit together.
  • Governance — SSO, row-level security, and audit.
  • Deployment — managed vs. your own cloud.