Apache Superset is a Data Visualization and Data Exploration Platform
Go to file
Ville Brofeldt 1f5eec1c4a
chore: improve release documentation (#10292)
* fix: releasing readme.md

* fix: improvements to release documentation
2020-07-11 19:00:02 +03:00
.github build: enable Cypress tests for visualizations (#10206) 2020-06-30 17:10:17 -07:00
RELEASING chore: improve release documentation (#10292) 2020-07-11 19:00:02 +03:00
docker build: Add python 3.8 to the build matrix (#9827) 2020-05-17 14:49:51 -07:00
docs docs(fix): /swaggerview/v1 has moved to /swagger/v1 (#10276) 2020-07-09 15:16:52 -07:00
helm/superset fix: Fix for updated cache dependency (#9850) 2020-05-20 09:42:43 -07:00
scripts feat: Switch from nosetest to pytest (#10177) 2020-06-29 15:36:06 -07:00
superset chore: Releasing SQL Lab Celery results (#10279) 2020-07-10 09:53:57 -07:00
superset-frontend logo gets the vertically-centered flexbox treatment in jinja template (#10281) 2020-07-10 16:11:49 -07:00
tests feat: add contribution operation and fix cache_key bug (#10286) 2020-07-10 17:06:05 +03:00
.codecov.yml Adding codecov targets and thresholds (#7433) 2019-06-03 15:26:42 -07:00
.dockerignore SIP-32: Moving frontend code to the base of the repo (#9098) 2020-02-09 17:53:56 -08:00
.flaskenv Flask App factory PR #1 (#8418) 2019-11-20 15:47:06 +00:00
.fossa.yml SIP-32: Moving frontend code to the base of the repo (#9098) 2020-02-09 17:53:56 -08:00
.gitignore feat: Add owners and physical/virtual status to Datasets API list endpoint (#10025) 2020-06-10 22:04:40 +03:00
.pre-commit-config.yaml chore: bump black to 19.10b0 and mypy to 0.770 (#9378) 2020-04-04 13:23:18 -07:00
.pylintrc chore: Upgrade pylint to 2.5.3 and fix most new rules (#10101) 2020-06-18 14:03:42 -07:00
.rat-excludes [docker] fix, Dockerfile for frontend builds (#9114) 2020-02-12 15:48:24 +00:00
CHANGELOG.md doc: Add changelog for 0.36.0 (#9570) 2020-04-17 19:55:51 +03:00
CODE_OF_CONDUCT.md Copying in Markdown formatted Apache Code of Conduct. (#8615) 2019-11-20 14:42:53 -08:00
CONTRIBUTING.md chore: bump python dependencies (#9786) 2020-05-13 18:49:34 +03:00
DISCLAIMER Add disclaimer and remove counter (#6738) 2019-01-22 14:18:16 -08:00
Dockerfile fix: issue with duplicated dependencies (#9837) 2020-05-19 08:46:52 -07:00
Dockerfile-dev fix: issue with duplicated dependencies (#9837) 2020-05-19 08:46:52 -07:00
INSTALL.md Improvements related to ASF release process (#7539) 2019-07-03 22:33:14 -07:00
LICENSE.txt Introducing Inter UI & Fira typefaces (#9207) 2020-03-04 17:32:08 -08:00
MANIFEST.in Update MANIFEST.in (#9261) 2020-03-25 22:00:41 -07:00
NOTICE Add release refinements from 0.35.2 release (#8925) 2020-02-18 07:14:31 +02:00
README.md Update README.md (#10221) 2020-07-01 19:36:11 -07:00
UPDATING.md chore: improve release documentation (#10292) 2020-07-11 19:00:02 +03:00
alembic.ini Add licenses to translations (#6732) 2019-01-22 08:21:13 -08:00
babel-node [adhoc-filters] Adding adhoc-filters to all viz types (#5206) 2018-06-18 15:43:18 -07:00
docker-compose.yml Removing node_modules volume in docker-compose.yml (#10236) 2020-07-03 08:00:09 -07:00
gen_changelog.sh Add licenses to translations (#6732) 2019-01-22 08:21:13 -08:00
pypi_push.sh [pypi] Include compiled translations on Pypi pkg (#9567) 2020-04-17 16:28:10 +01:00
pytest.ini feat: support nulls in the csv uploads (#10208) 2020-07-06 13:26:43 -07:00
requirements-dev.txt feat: Switch from nosetest to pytest (#10177) 2020-06-29 15:36:06 -07:00
requirements.txt chore: Bumping Celery (#10280) 2020-07-10 09:12:12 -07:00
setup.cfg docs(fix): /swaggerview/v1 has moved to /swagger/v1 (#10276) 2020-07-09 15:16:52 -07:00
setup.py feat(api): bump marshmallow and FAB to version 3 (#9964) 2020-07-07 13:26:54 +01:00
tox.ini feat: Switch from nosetest to pytest (#10177) 2020-06-29 15:36:06 -07:00

README.md

Superset

Build Status PyPI version Coverage Status PyPI Get on Slack Documentation dependencies Status

Superset

A modern, enterprise-ready business intelligence web application.

Why Superset | Database Support | Installation and Configuration | Get Help | Contributor Guide | Resources | Superset Users | License |

Screenshots & Gifs

View Dashboards


Slice & dice your data


Query and visualize your data with SQL Lab


Visualize geospatial data with deck.gl


Choose from a wide array of visualizations


Why Superset

Superset provides:

  • 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 underlying exposed dashboards. The dashboards and charts act as a starting 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.
  • An extensible, high granularity security model allowing intricate rules 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
  • Deep integration with Druid allows for Superset to stay blazing fast while slicing and dicing large, realtime datasets
  • Fast loading dashboards with configurable caching

Database Support

Superset speaks many SQL dialects through SQLAlchemy - a Python SQL toolkit that is compatible with most databases. A list of supported databases can be found here.

Installation and Configuration

See in the documentation

Get Help

Slack Community Guidelines

If you decide to join the Community Slack, please adhere to the following rules:

1. Treat everyone in the community with respect.

  • We strive to make this community a warm place for people from all industries, use cases, geographies, and backgrounds. Harassment of any kind is not acceptable and wont be tolerated.
  • Please follow the guidelines as outlined in the Superset Community code of conduct here.

2. Use the right channel.

  • Channels are an effective way to organize and focus discussions while also empowering members to opt-in to the types of content theyre interested in. When questions are posted or discussions are started in the wrong channel, it dilutes the trust of the members in the channel and, more practically, makes it harder for your questions to be answered.

3. Ask thoughtful questions.

  • Were all here to help each other out. The best way to get help is by investing effort into your questions. First check and see if your question is answered in the Superset documentation or on Stack Overflow. You can also check Github issues to see if your question or feature request has been submitted before. Then, use Slack search to see if your question has already been asked and answered in the past. If you still feel the need to ask a question, make sure you include:

  • The steps youve already taken

  • Relevant details presented cleanly (text stacktraces, formatted markdown, or screenshots. Please dont paste large blocks of code unformatted or post photos of your screen from your phone)

  • The specific question you have or the specific type of help you're seeking

4. Avoid double posting

  • This Slack community is not a customer support channel and all members are here voluntarily. If you arent getting a response to a question you have, make sure you look at rules 1, 2, and 3. Its also worth remembering that there may not be someone in the community who has the context to help you out.

5. Communicate openly

  • Unless you have explicit permission from the person, please avoid sending direct messages to individuals. Communicating in public channels ensures that were all respecting each others attentions and we can scalably moderate our communication to mitigate harassment or discrimination. Do not use direct messages to pitch products and services. If you are receiving unwelcome direct messages, please notify an admin.

6. Practice good Slack hygiene by using threads for discussions and emojis for light reactions.

  • The medium is the message. Slack can foster a warm, collaborative, and organized community when used effectively. We want to respect peoples attentions (thread notifications > channel notifications > DM notifications) and we want to improve information density (a member should be able to browse and explore many convo threads, not just see one thread discussed in a top level channel).

Contributor Guide

Interested in contributing? Check out Contributing.MD to learn how to contribute and best practices.

Resources

Superset Users

Here's a list of organizations that have taken the time to send a PR to let the world know they are using Superset. If you are a user and want to be recognized, all you have to do is file a simple PR like this one. Join our growing community!

  1. 6play [@CoryChaplin]
  2. AiHello [@ganeshkrishnan1]
  3. Airbnb
  4. Airboxlab [@antoine-galataud]
  5. Aktia Bank plc [@villebro]
  6. American Express [@TheLastSultan]
  7. Amino [@shkr]
  8. Apollo GraphQL [@evans]
  9. Ascendica Development [@davidhassan]
  10. Astronomer [@ryw]
  11. bilibili [@Moinheart]
  12. Brilliant.org
  13. Capital Service S.A. [@pkonarzewski]
  14. Clark.de
  15. Cloudsmith [@alancarson]
  16. CnOvit [@xieshaohu]
  17. Deepomatic [@Zanoellia]
  18. Dial Once
  19. Digit Game Studios
  20. Douban [@luchuan]
  21. DouroECI [@nunohelibeires]
  22. Dragonpass [@zhxjdwh]
  23. Dremio [@narendrans]
  24. ELMO Cloud HR & Payroll
  25. Endress+Hauser [@rumbin]
  26. Faasos [@shashanksingh]
  27. Fanatics [@coderfender]
  28. FBK - ICT center
  29. Fordeal [@Renkai]
  30. GFG - Global Fashion Group [@ksaagariconic]
  31. GfK Data Lab [@mherr]
  32. Grassroot
  33. GrowthSimple
  34. Hostnfly [@alexisrosuel]
  35. HuiShouBao [@Yukinoshita-Yukino]
  36. Intercom [@kate-gallo]
  37. jampp
  38. komoot [@christophlingg]
  39. Konfío [@uis-rodriguez]
  40. Kuaishou [@zhaoyu89730105]
  41. Let's Roam
  42. Lime [@cxmcc]
  43. Living Goods [@chelule]
  44. Lyft
  45. Maieutical Labs [@xrmx]
  46. Myra Labs [@viksit]
  47. Nielsen [@amitNielsen]
  48. Now [@davidkohcw]
  49. Ona [@pld]
  50. Peak AI [@azhar22k]
  51. PeopleDoc [@rodo]
  52. Popoko VM Games Studio
  53. Preset, Inc.
  54. Pronto Tools [@zkan]
  55. PubNub [@jzucker2]
  56. QPID Health
  57. Qunar [@flametest]
  58. Rakuten Viki
  59. Reward Gateway
  60. Safaricom [@mmutiso]
  61. Scoot [@haaspt]
  62. ScopeAI [@iloveluce]
  63. Shopee [@xiaohanyu]
  64. Shopkick [@LAlbertalli]
  65. Showmax [@bobek]
  66. source{d} [@marnovo]
  67. Steamroot
  68. Tails.com [@alanmcruickshank]
  69. Tenable [@dflionis]
  70. THE ICONIC [@ksaagariconic]
  71. timbr.ai [@semantiDan]
  72. TME QQMUSIC/WESING
  73. Tobii [@dwa]
  74. Tooploox [@jakubczaplicki]
  75. TrustMedis [@famasya]
  76. Twitter
  77. Udemy [@sungjuly]
  78. VIPKID [@illpanda]
  79. WeSure
  80. Whale
  81. Windsor.ai [@octaviancorlade]
  82. Yahoo!
  83. Zaihang
  84. Zalando [@dmigo]
  85. Zalora [@ksaagariconic]

License

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.