2019-01-22 11:21:13 -05:00
<!--
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.
-->
2016-11-10 02:08:22 -05:00
Superset
2015-07-02 18:16:59 -04:00
=========
2016-11-10 02:08:22 -05:00
2020-07-20 17:14:09 -04:00
[![License ](https://img.shields.io/badge/License-Apache%202.0-blue.svg )](https://opensource.org/licenses/Apache-2.0)
![GitHub release (latest SemVer) ](https://img.shields.io/github/v/release/apache/incubator-superset )
2017-07-19 04:17:56 -04:00
[![Build Status ](https://travis-ci.org/apache/incubator-superset.svg?branch=master )](https://travis-ci.org/apache/incubator-superset)
2019-09-18 19:36:08 -04:00
[![PyPI version ](https://badge.fury.io/py/apache-superset.svg )](https://badge.fury.io/py/apache-superset)
2018-03-04 15:49:55 -05:00
[![Coverage Status ](https://codecov.io/github/apache/incubator-superset/coverage.svg?branch=master )](https://codecov.io/github/apache/incubator-superset)
2019-10-06 17:06:51 -04:00
[![PyPI ](https://img.shields.io/pypi/pyversions/apache-superset.svg?maxAge=2592000 )](https://pypi.python.org/pypi/apache-superset)
2020-07-20 17:14:09 -04:00
[![Get on Slack ](https://img.shields.io/badge/slack-join-orange.svg )](https://join.slack.com/t/apache-superset/shared_invite/zt-g8lpruog-HeqpgYrwdfrD5OYhlU7hPQ)
2020-09-16 12:56:56 -04:00
[![Documentation ](https://img.shields.io/badge/docs-apache.org-blue.svg )](https://superset.apache.org)
2020-07-20 17:14:09 -04:00
[![Dependencies Status ](https://david-dm.org/apache/incubator-superset/status.svg?path=superset-frontend )](https://david-dm.org/apache/incubator-superset?path=superset-frontend)
2016-11-10 02:08:22 -05:00
2016-12-06 23:59:44 -05:00
< img
2020-10-01 17:23:56 -04:00
src="https://github.com/apache/incubator-superset/raw/master/superset-frontend/branding/superset-logo-horiz-apache.png"
2016-12-06 23:59:44 -05:00
alt="Superset"
width="500"
/>
2020-05-06 14:55:20 -04:00
A modern, enterprise-ready business intelligence web application.
2015-08-08 11:02:56 -04:00
2020-07-14 16:27:02 -04:00
[**Why Superset** ](#why-superset ) |
2020-08-03 16:50:52 -04:00
[**Supported Databases** ](#supported-databases ) |
2020-05-06 14:55:20 -04:00
[**Installation and Configuration** ](#installation-and-configuration ) |
[**Get Help** ](#get-help ) |
[**Contributor Guide** ](#contributor-guide ) |
[**Resources** ](#resources ) |
2020-07-14 16:27:02 -04:00
[**Superset Users** ](INTHEWILD.md )
2016-01-27 16:56:23 -05:00
2020-05-06 14:55:20 -04:00
## Screenshots & Gifs
2016-01-27 16:56:23 -05:00
2020-09-22 01:48:55 -04:00
**Gallery**
< kbd > < a href = "https://superset.apache.org/gallery" > < img title = "Gallery" src = "https://raw.githubusercontent.com/apache/incubator-superset/master/superset-frontend/images/screenshots/gallery.png" > < / a > < / kbd > < br / >
2016-11-17 14:45:40 -05:00
**View Dashboards**
2017-03-21 17:00:09 -04:00
2020-02-09 20:53:56 -05:00
< kbd > < img title = "View Dashboards" src = "https://raw.githubusercontent.com/apache/incubator-superset/master/superset-frontend/images/screenshots/bank_dash.png" > < / kbd > < br / >
2016-09-14 19:39:40 -04:00
2018-04-14 18:32:26 -04:00
**Slice & dice your data**
2017-03-21 17:00:09 -04:00
2020-02-09 20:53:56 -05:00
< kbd > < img title = "Slice & dice your data" src = "https://raw.githubusercontent.com/apache/incubator-superset/master/superset-frontend/images/screenshots/explore.png" > < / kbd > < br / >
2017-03-21 17:00:09 -04:00
2018-04-14 18:32:26 -04:00
**Query and visualize your data with SQL Lab**
2016-09-14 19:39:40 -04:00
2020-02-09 20:53:56 -05:00
< kbd > < img title = "SQL Lab" src = "https://raw.githubusercontent.com/apache/incubator-superset/master/superset-frontend/images/screenshots/sqllab.png" > < / kbd > < br / >
2017-03-21 17:00:09 -04:00
2018-04-14 18:32:26 -04:00
**Visualize geospatial data with deck.gl**
2017-03-21 17:00:09 -04:00
2020-02-09 20:53:56 -05:00
< kbd > < img title = "Geospatial" src = "https://raw.githubusercontent.com/apache/incubator-superset/master/superset-frontend/images/screenshots/deckgl_dash.png" > < / kbd > < br / >
2016-09-14 19:39:40 -04:00
2018-04-14 18:32:26 -04:00
**Choose from a wide array of visualizations**
2017-03-21 17:00:09 -04:00
2020-02-09 20:53:56 -05:00
< kbd > < img title = "Visualizations" src = "https://raw.githubusercontent.com/apache/incubator-superset/master/superset-frontend/images/screenshots/visualizations.png" > < / kbd > < br / >
2015-09-21 16:48:02 -04:00
2020-05-06 14:55:20 -04:00
## Why Superset
2015-09-21 16:48:02 -04:00
2016-11-10 02:08:22 -05:00
Superset provides:
2017-06-17 02:31:50 -04:00
* An intuitive interface to explore and visualize datasets, and
create interactive dashboards.
* A wide array of beautiful visualizations to showcase your data.
* Easy, code-free, user flows to drill down and slice and dice the data
2020-03-14 16:38:09 -04:00
underlying exposed dashboards. The dashboards and charts act as a starting
2017-06-17 02:31:50 -04:00
point for deeper analysis.
* A state of the art SQL editor/IDE exposing a rich metadata browser, and
an easy workflow to create visualizations out of any result set.
2015-09-21 16:48:02 -04:00
* An extensible, high granularity security model allowing intricate rules
2017-06-17 02:31:50 -04:00
on who can access which product features and datasets.
Integration with major
authentication backends (database, OpenID, LDAP, OAuth, REMOTE_USER, ...)
* A lightweight semantic layer, allowing to control how data sources are
exposed to the user by defining dimensions and metrics
* Out of the box support for most SQL-speaking databases
2016-11-10 02:08:22 -05:00
* Deep integration with Druid allows for Superset to stay blazing fast while
2015-09-21 16:48:02 -04:00
slicing and dicing large, realtime datasets
2016-06-13 12:25:22 -04:00
* Fast loading dashboards with configurable caching
2015-09-21 16:48:02 -04:00
2020-08-03 16:50:52 -04:00
## Supported Databases
2015-08-08 11:02:56 -04:00
2020-02-24 05:30:25 -05:00
Superset speaks many SQL dialects through SQLAlchemy - a Python
2020-08-03 16:50:52 -04:00
SQL toolkit that is compatible with most databases. Here are some of the major database solutions that are supported:
< p align = "center" >
< img src = "superset-frontend/images/redshift.png" alt = "redshift" border = "0" width = "106" height = "41" / >
< img src = "superset-frontend/images/google-biquery.png" alt = "google-biquery" border = "0" width = "114" height = "43" / >
< img src = "superset-frontend/images/snowflake.png" alt = "snowflake" border = "0" width = "152" height = "46" / >
< img src = "superset-frontend/images/presto.png" alt = "presto" border = "0" width = "152" height = "46" / >
< img src = "superset-frontend/images/druid.png" alt = "druid" border = "0" width = "135" height = "37" / >
< img src = "superset-frontend/images/postgresql.png" alt = "postgresql" border = "0" width = "132" height = "81" / >
< img src = "superset-frontend/images/mysql.png" alt = "mysql" border = "0" width = "119" height = "62" / >
< img src = "superset-frontend/images/mssql-server.png" alt = "mssql-server" border = "0" width = "93" height = "74" / >
< img src = "superset-frontend/images/db2.png" alt = "db2" border = "0" width = "62" height = "62" / >
< img src = "superset-frontend/images/sqlite.png" alt = "sqlite" border = "0" width = "102" height = "45" / >
< img src = "superset-frontend/images/sybase.png" alt = "sybase" border = "0" width = "128" height = "47" / >
< img src = "superset-frontend/images/mariadb.png" alt = "mariadb" border = "0" width = "83" height = "63" / >
< img src = "superset-frontend/images/vertica.png" alt = "vertica" border = "0" width = "128" height = "40" / >
< img src = "superset-frontend/images/oracle.png" alt = "oracle" border = "0" width = "121" height = "66" / >
< img src = "superset-frontend/images/firebird.png" alt = "firebird" border = "0" width = "86" height = "56" / >
< img src = "superset-frontend/images/greenplum.png" alt = "greenplum" border = "0" width = "140" height = "45" / >
< img src = "superset-frontend/images/clickhouse.png" alt = "clickhouse" border = "0" width = "133" height = "34" / >
< img src = "superset-frontend/images/exasol.png" alt = "exasol" border = "0" width = "106" height = "59" / >
< img src = "superset-frontend/images/monet-db.png" alt = "monet-db" border = "0" width = "106" height = "46" / >
< img src = "superset-frontend/images/apache-kylin.png" alt = "apache-kylin" border = "0" width = "56" height = "64" / >
< / p >
A complete list of supported databases can be found
2020-09-15 16:18:42 -04:00
[here ](https://superset.incubator.apache.org/docs/databases/installing-database-drivers ).
2017-06-17 02:31:50 -04:00
2015-07-22 11:53:38 -04:00
2020-05-06 14:55:20 -04:00
## Installation and Configuration
2015-09-05 12:23:46 -04:00
2020-09-15 16:18:42 -04:00
[See in the documentation ](https://superset.incubator.apache.org/docs/installation/installing-superset-using-docker-compose )
2015-09-05 12:23:46 -04:00
2020-07-15 18:21:20 -04:00
## Get Involved
2020-06-30 23:20:09 -04:00
2020-07-15 18:21:20 -04:00
* Ask and answer questions on [StackOverflow ](https://stackoverflow.com/questions/tagged/apache-superset )
2020-07-17 17:10:50 -04:00
* [Join our community's Slack ](https://join.slack.com/t/apache-superset/shared_invite/zt-g8lpruog-HeqpgYrwdfrD5OYhlU7hPQ )
2020-07-15 18:21:20 -04:00
and please read our [Slack Community Guidelines ](CODE_OF_CONDUCT.md#slack-community-guidelines )
* [Join our dev@superset.apache.org Mailing list ](https://lists.apache.org/list.html?dev@superset.apache.org )
2020-06-30 23:20:09 -04:00
2015-12-11 11:51:13 -05:00
2020-05-06 14:55:20 -04:00
## Contributor Guide
2015-09-27 21:02:00 -04:00
2020-07-15 18:21:20 -04:00
Interested in contributing? Check out our
[CONTRIBUTING.md ](https://github.com/apache/superset/blob/master/CONTRIBUTING.md )
to find resources around contributing along with a detailed guide on
how to set up a development environment.
2016-02-27 10:47:56 -05:00
2017-06-17 02:31:50 -04:00
2020-05-06 14:55:20 -04:00
## Resources
2017-06-17 02:31:50 -04:00
2020-06-22 22:34:41 -04:00
* Superset 101 -- Getting Started Guide (From [Preset ](https://preset.io ) [Blog ](https://preset.io/blog/ ))
* [Installing Apache Superset Locally ](https://preset.io/blog/2020-05-11-getting-started-installing-superset/ )
* [Installing Database Drivers ](https://preset.io/blog/2020-05-18-install-db-drivers/ )
* [Connect Superset To Google Sheets ](https://preset.io/blog/2020-06-01-connect-superset-google-sheets/ )
* [Create Your First Chart ](https://preset.io/blog/2020-06-08-first-chart/ )
2020-07-01 22:36:11 -04:00
* [Create Time Series Charts ](https://preset.io/blog/2020-06-26-timeseries-chart/ )
2020-05-06 14:55:20 -04:00
* [Docker image ](https://hub.docker.com/r/preset/superset/ )
2020-05-21 12:35:13 -04:00
* [Youtube Channel ](https://www.youtube.com/channel/UCMuwrvBsg_jjI2gLcm04R0g )
* [May 15, 2020: Virtual Meetup Recording. Topics: 0.36 Overview, Committers Self-Intro, Roadmap ](https://www.youtube.com/watch?v=tXGDmqjmcTs&t=20s )
2020-08-04 16:29:58 -04:00
* [July 16, 2020: Virtual Meetup Recording. Topics: Visualization Plugins, 0.37 Preview, Demo ](https://www.youtube.com/watch?v=f6up5x_iRbI )
2020-07-28 01:46:37 -04:00
* [So, You Want to Build a Superset Viz Plugin... ](https://preset.io/blog/2020-07-02-hello-world/ )