<!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->

Superset

<picture width="500"> <source width="600" media="(prefers-color-scheme: dark)" src="https://superset.apache.org/img/superset-logo-horiz-dark.svg" alt="Superset logo (dark)" /> </picture>

A modern, enterprise-ready business intelligence web application.

Documentation

• User Guide — For analysts and business users. Explore data, build charts, create dashboards, and connect databases.
• Administrator Guide — Install, configure, and operate Superset. Covers security, scaling, and database drivers.
• Developer Guide — Contribute to Superset or build on its REST API and extension framework.

Why Superset? | Supported Databases | Release Notes | Get Involved | Resources | Organizations Using Superset

Why Superset?

Superset is a modern data exploration and data visualization platform. Superset can replace or augment proprietary business intelligence tools for many teams. Superset integrates well with a variety of data sources.

Superset provides:

• A no-code interface for building charts quickly
• A powerful, web-based SQL Editor for advanced querying
• A lightweight semantic layer for quickly defining custom dimensions and metrics
• Out of the box support for nearly any SQL database or data engine
• A wide array of beautiful visualizations to showcase your data, ranging from simple bar charts to geospatial visualizations
• Lightweight, configurable caching layer to help ease database load
• Highly extensible security roles and authentication options
• An API for programmatic customization
• A cloud-native architecture designed from the ground up for scale

Screenshots & Gifs

Video Overview

<!-- File hosted here https://github.com/apache/superset-site/raw/lfs/superset-video-4k.mp4 -->

superset-video-1080p.webm

Large Gallery of Visualizations

<kbd></kbd>

Craft Beautiful, Dynamic Dashboards

<kbd></kbd>

No-Code Chart Builder

<kbd></kbd>

Powerful SQL Editor

<kbd></kbd>

Supported Databases

Superset can query data from any SQL-speaking datastore or data engine (Presto, Trino, Athena, and more) that has a Python DB-API driver and a SQLAlchemy dialect.

Here are some of the major database solutions that are supported:

<!-- SUPPORTED_DATABASES_START --> <p align="center"> <a href="https://superset.apache.org/docs/databases/supported/amazon-athena" title="Amazon Athena"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/amazon-dynamodb" title="Amazon DynamoDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/amazon-redshift" title="Amazon Redshift"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-doris" title="Apache Doris"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-drill" title="Apache Drill"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-druid" title="Apache Druid"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-hive" title="Apache Hive"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-impala" title="Apache Impala"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-kylin" title="Apache Kylin"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-pinot" title="Apache Pinot"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-solr" title="Apache Solr"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/apache-spark-sql" title="Apache Spark SQL"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/ascend" title="Ascend"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/aurora-mysql-data-api" title="Aurora MySQL (Data API)"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/aurora-postgresql-data-api" title="Aurora PostgreSQL (Data API)"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/azure-data-explorer" title="Azure Data Explorer"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/azure-synapse" title="Azure Synapse"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/clickhouse" title="ClickHouse"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/cloudflare-d1" title="Cloudflare D1"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/cockroachdb" title="CockroachDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/couchbase" title="Couchbase"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/cratedb" title="CrateDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/databend" title="Databend"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/databricks" title="Databricks"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/denodo" title="Denodo"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/dremio" title="Dremio"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/duckdb" title="DuckDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/elasticsearch" title="Elasticsearch"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/exasol" title="Exasol"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/firebird" title="Firebird"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/firebolt" title="Firebolt"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/google-bigquery" title="Google BigQuery"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/google-sheets" title="Google Sheets"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/greenplum" title="Greenplum"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/hologres" title="Hologres"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/ibm-db2" title="IBM Db2"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/ibm-netezza-performance-server" title="IBM Netezza Performance Server"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/mariadb" title="MariaDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/microsoft-sql-server" title="Microsoft SQL Server"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/monetdb" title="MonetDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/mongodb" title="MongoDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/motherduck" title="MotherDuck"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/oceanbase" title="OceanBase"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/oracle" title="Oracle"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/presto" title="Presto"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/risingwave" title="RisingWave"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/sap-hana" title="SAP HANA"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/sap-sybase" title="SAP Sybase"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/shillelagh" title="Shillelagh"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/singlestore" title="SingleStore"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/snowflake" title="Snowflake"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/sqlite" title="SQLite"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/starrocks" title="StarRocks"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/superset-meta-database" title="Superset meta database"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/tdengine" title="TDengine"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/teradata" title="Teradata"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/timescaledb" title="TimescaleDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/trino" title="Trino"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/vertica" title="Vertica"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/ydb" title="YDB"></a> &nbsp; <a href="https://superset.apache.org/docs/databases/supported/yugabytedb" title="YugabyteDB"></a> </p> <!-- SUPPORTED_DATABASES_END -->

A more comprehensive list of supported databases along with the configuration instructions can be found here.

Want to add support for your datastore or data engine? Read more here about the technical requirements.

Installation and Configuration

Try out Superset's quickstart guide or learn about the options for production deployments.

Get Involved

• Ask and answer questions on StackOverflow using the apache-superset tag
• Join our community's Slack and please read our Slack Community Guidelines
• Join our [email protected] Mailing list. To join, simply send an email to [email protected]
• If you want to help troubleshoot GitHub Issues involving the numerous database drivers that Superset supports, please consider adding your name and the databases you have access to on the Superset Database Familiarity Rolodex
• Join Superset's Town Hall and Operational Model recurring meetings. Meeting info is available on the Superset Community Calendar

Contributor Guide

Interested in contributing? Check out our Developer Guide to find resources around contributing along with a detailed guide on how to set up a development environment.

Resources

• Superset "In the Wild" - see who's using Superset, and add your organization to the list!
• Feature Flags - the status of Superset's Feature Flags.
• Standard Roles - How RBAC permissions map to roles.
• Superset Wiki - Tons of additional community resources: best practices, community content and other information.
• Superset SIPs - The status of Superset's SIPs (Superset Improvement Proposals) for both consensus and implementation status.

Understanding the Superset Points of View

• The Case for Dataset-Centric Visualization

• Understanding the Superset Semantic Layer

• Getting Started with Superset

  • Superset in 2 Minutes using Docker Compose
  • Installing Database Drivers
  • Building New Database Connectors
  • Create Your First Dashboard
  • Comprehensive Tutorial for Contributing Code to Apache Superset

• Resources to master Superset by Preset

• Deploying Superset

  • Official Docker image
  • Helm Chart

• Recordings of Past Superset Community Events

  • Mixed Time Series Charts
  • How the Bing Team Customized Superset for the Internal Self-Serve Data & Analytics Platform
  • Live Demo: Visualizing MongoDB and Pinot Data using Trino
  • Introduction to the Superset API
  • Building a Database Connector for Superset

• Visualizations

  • Creating Viz Plugins
  • Managing and Deploying Custom Viz Plugins
  • Why Apache Superset is Betting on Apache ECharts

• Superset API

Repo Activity

<a href="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats?repo_id=39464018" target="_blank" align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=dark" width="655" height="auto" /> </picture> </a> <!-- Made with [OSS Insight](https://ossinsight.io/) --> <!-- telemetry/analytics pixel: -->