38 KiB
Updating Superset
This file documents any backwards-incompatible changes in Superset and assists people when migrating to a new version.
Next
- 19046: Enables the drag and drop interface in Explore control panel by default. Flips
ENABLE_EXPLORE_DRAG_AND_DROP
andENABLE_DND_WITH_CLICK_UX
feature flags toTrue
. - 18936: Removes legacy SIP-15 interim logic/flags—specifically the
SIP_15_ENABLED
,SIP_15_GRACE_PERIOD_END
,SIP_15_DEFAULT_TIME_RANGE_ENDPOINTS
, andSIP_15_TOAST_MESSAGE
flags. Time range endpoints are no longer configurable and strictly adhere to the[start, end)
paradigm, i.e., inclusive of the start and exclusive of the end. Additionally this change removes the now obsoletetime_range_endpoints
from the form-data and resulting in the cache being busted. - 19570: makes sqloxide optional so the SIP-68 migration can be run on aarch64. If the migration is taking too long installing sqloxide manually should improve the performance.
Breaking Changes
- 19274: The
PUBLIC_ROLE_LIKE_GAMMA
config key has been removed, setPUBLIC_ROLE_LIKE = "Gamma"
to have the same functionality. - 19273: The
SUPERSET_CELERY_WORKERS
andSUPERSET_WORKERS
config keys has been removed. Configure Celery directly usingCELERY_CONFIG
on Superset. - 19262: Per SIP-11 and SIP-68 the native NoSQL Druid connector is deprecated and will no longer be supported. Druid SQL is still supported.
- 19231: The
ENABLE_REACT_CRUD_VIEWS
feature flag has been removed (premantly enabled). Any deployments which had set this flag to false will need to verify that the React views support their use case. - 19230: The
ROW_LEVEL_SECURITY
feature flag has been removed (permantly enabled). Any deployments which had set this flag to false will need to verify that the presence of the Row Level Security feature does not interfere with their use case. - 19168: Celery upgrade to 5.X resulted in breaking changes to its command line invocation. Please follow these instructions for adjustments. Also consider migrating you Celery config per here.
- 19142: The
VERSIONED_EXPORT
config key is nowTrue
by default. - 19113: The
ENABLE_JAVASCRIPT_CONTROLS
config key has moved from an app config to a feature flag. Any deployments who overrode this setting will now need to override the feature flag from here onward. - 19107: The
SQLLAB_BACKEND_PERSISTENCE
feature flag is nowTrue
by default, which enables persisting SQL Lab tabs in the backend instead of the browser'slocalStorage
. - 19083: Updates the mutator function in the config file to take a SQL argument and a list of kwargs. Any
SQL_QUERY_MUTATOR
config function overrides will need to be updated to match the new set of params. It is advised regardless of the dictionary args that you list in your function arguments, to keep**kwargs
as the last argument to allow for any new kwargs to be passed in. - 19049: The
APP_ICON_WIDTH
config key has been removed. Superset should now be able to handle different logo sizes without having to explicitly set anAPP_ICON_WIDTH
. This might affect the size of existing custom logos as the UI will now resize them according to the specified space of maximum 148px and not according to the value ofAPP_ICON_WIDTH
. - 19017: Removes Python 3.7 support.
- 18976: When running the app in debug mode, the app will default to use
SimpleCache
forFILTER_STATE_CACHE_CONFIG
andEXPLORE_FORM_DATA_CACHE_CONFIG
. When running in non-debug mode, a cache backend will need to be defined, otherwise the application will fail to start. For installations using Redis or other caching backends, it is recommended to use the same backend for both cache configs. - 18970: The
DISABLE_LEGACY_DATASOURCE_EDITOR
feature flag is nowTrue
by default which disables the legacy datasource editor from being shown in the client. - 17984: The default Flask SECRET_KEY has changed for security reasons. You should always override with your own secret. Set
PREVIOUS_SECRET_KEY
, e.g.PREVIOUS_SECRET_KEY = "\2\1thisismyscretkey\1\2\\e\\y\\y\\h"
, with your previous key and usesuperset re-encrypt-secrets
to rotate you current secrets. - 17881: Previously simple adhoc filter values on string columns were stripped of enclosing single and double quotes. To fully support literal quotes in filters, both single and double quotes will no longer be removed from filter values.
- 17556: Bumps
mysqlclient
from v1 to v2. - 17539: All Superset CLI commands, e.g.
init
,load_examples
, etc. require setting theFLASK_APP
environment variable (which is set by default when.flaskenv
is loaded). - 15254: The
QUERY_COST_FORMATTERS_BY_ENGINE
,SQL_VALIDATORS_BY_ENGINE
andSCHEDULED_QUERIES
feature flags are now defined as config keys given that feature flags are reserved for boolean only values.
Potential Downtime
- 16756: a change which renames the
dbs.allow_csv_upload
column todbs.allow_file_upload
via a (potentially locking) DDL operation. - 17539: all Superset CLI commands (init, load_examples and etc) require setting the FLASK_APP environment variable (which is set by default when .flaskenv is loaded)
- 17360: changes the column type from
VARCHAR(32)
toTEXT
in tabletable_columns
, potentially requiring a table lock on MySQL dbs or taking some time to complete on large deployments. - 17543: introduces new models from SIP-68. The database migration migrates the old models (
SqlaTable
,TableColumn
,SqlMetric
) to the new models (Column
,Table
,Dataset
), and the PR introduces logic to keep the old models in sync with the new ones until they are fully removed. The migration might take considerable time depending on the number of datasets.
Deprecations
- 18960: Persisting URL params in chart metadata is no longer supported. To set a default value for URL params in Jinja code, use the optional second argument:
url_param("my-param", "my-default-value")
.
Other
- 17589: It is now possible to limit access to users' recent activity data by setting the
ENABLE_BROAD_ACTIVITY_ACCESS
config flag to false, or customizing theraise_for_user_activity_access
method in the security manager. - 17536: introduced a key-value endpoint to store dashboard filter state. This endpoint is backed by Flask-Caching and the default configuration assumes that the values will be stored in the file system. If you are already using another cache backend like Redis or Memcached, you'll probably want to change this setting in
superset_config.py
. The key isFILTER_STATE_CACHE_CONFIG
and the available settings can be found in Flask-Caching docs. - 17882: introduced a key-value endpoint to store Explore form data. This endpoint is backed by Flask-Caching and the default configuration assumes that the values will be stored in the file system. If you are already using another cache backend like Redis or Memcached, you'll probably want to change this setting in
superset_config.py
. The key isEXPLORE_FORM_DATA_CACHE_CONFIG
and the available settings can be found in Flask-Caching docs.
1.4.1
Breaking Changes
- 17984: Default Flask SECRET_KEY has changed for security reasons. You should always override with your own secret. Set
PREVIOUS_SECRET_KEY
(ex: PREVIOUS_SECRET_KEY = "\2\1thisismyscretkey\1\2\e\y\y\h") with your previous key and usesuperset re-encrypt-secrets
to rotate you current secrets
Potential Downtime
Deprecations
Other
1.4.0
Breaking Changes
- 16660: The
columns
Jinja parameter has been renamedtable_columns
to make thecolumns
query object parameter available in the Jinja context. - 16711: The
url_param
Jinja function will now by default escape the result. For instance, the valueO'Brien
will now be changed toO''Brien
. To disable this behavior, callurl_param
withescape_result
set toFalse
:url_param("my_key", "my default", escape_result=False)
.
Potential Downtime
Deprecations
Other
- 16809: When building the superset frontend assets manually, you should now use Node 16 (previously Node 14 was required/recommended). Node 14 will most likely still work for at least some time, but is no longer actively tested for on CI.
1.3.0
Breaking Changes
- 15909: a change which drops a uniqueness criterion (which may or may not have existed) to the tables table. This constraint was obsolete as it is handled by the ORM due to differences in how MySQL, PostgreSQL, etc. handle uniqueness for NULL values.
Potential Downtime
- 14234: Adds the
limiting_factor
column to thequery
table. Give the migration includes a DDL operation on a heavily trafficked table, potential service downtime may be required.
-16454: Adds the extra
column to the table_columns
table. Users using MySQL will either need to schedule downtime or use the percona toolkit (or similar) to perform the migration.
1.2.0
Deprecations
- 13440: Dashboard/Charts reports and old Alerts is deprecated. The following config keys are deprecated:
- ENABLE_ALERTS
- SCHEDULED_EMAIL_DEBUG_MODE
- EMAIL_REPORTS_CRON_RESOLUTION
- EMAIL_ASYNC_TIME_LIMIT_SEC
- EMAIL_REPORT_BCC_ADDRESS
- EMAIL_REPORTS_USER
Other
- 13772: Row level security (RLS) is now enabled by default. To activate the feature, please run
superset init
to expose the RLS menus to Admin users. - 13980: Data health checks no longer use the metadata database as an interim cache. Though non-breaking, deployments which implement complex logic should likely memoize the callback function. Refer to documentation in the confg.py file for more detail.
- 14255: The default
CSV_TO_HIVE_UPLOAD_DIRECTORY_FUNC
callable logic has been updated to leverage the specified database and schema to ensure the upload S3 key prefix is unique. Previously tables generated via upload from CSV with the same name but differ schema and/or cluster would use the same S3 key prefix. Note this change does not impact previously imported tables.
1.1.0
Breaking Changes
- This is the first release since we adopted semantic versioning (SIP-57). There are no breaking changes in 1.1.0 since this is a minor release.
Potential Downtime
- 13111 has a database migration that replaces
directed_force
charts with newergraph_chart
charts based on Apache ECharts. - 13216 adds a UUID column to models that are missing it. The original migration script that added the column would incorrectly complete when the column couldn't be added, resulting in a broken schema. The script is optimized for MySQL and Postgres, so depending on the database and the number of objects this migration might take considerable time.
- 12960 populates the granularity parameter in existing charts. Depending on the number of charts without a
granularity
orgranularity_sqla param
this might take considerable time. - 13052 updates the label in existing pie charts, setting
label_type
frompie_label_type
. Depending on the number of pie charts this might take considerable time. - 12680 creates a new table,
dashboard_roles
, for role based dashboard level access. - 12552 updates charts that have the time range defined using "until" and "since". Depending on the number of charts this might take considerable time.
Deprecations
- 12552 removes the use of unclear time offsets, eg, "30 days". An error message is displayed if the user doesn't specify "ago" or "later", instructing the user of the correct format.
- 12627 deprecates the legacy alerts module.
Other
- shillelagh is now the recommended module to connect Superset to Google Spreadsheets since it's more robust and has extensive test coverage. You should uninstall the
gsheetsdb
module and install theshillelagh
module in its place. Shillelagh is a drop-in replacement, so no modifications are needed to be done on existing queries, datasets, or charts.
1.0.0
Breaking Changes
-
11509: Dataset metadata updates check user ownership, only owners or an Admin are allowed.
-
Security simplification (SIP-19), the following permission domains were simplified:
- 12072:
Query
withcan_read
,can_write
- 12036:
Database
withcan_read
,can_write
. - 12012:
Dashboard
withcan_read
,can_write
. - 12061:
Log
withcan_read
,can_write
. - 12000:
Dataset
withcan_read
,can_write
. - 12014:
Annotation
withcan_read
,can_write
. - 11981:
Chart
withcan_read
,can_write
. - 11853:
ReportSchedule
withcan_read
,can_write
. - 11856:
CssTemplate
withcan_read
,can_write
. - 11764:
SavedQuery
withcan_read
,can_write
. Old permissions will be automatically migrated to these new permissions and applied to all existing security Roles.
- 12072:
-
11499: Breaking change:
STORE_CACHE_KEYS_IN_METADATA_DB
config flag added (default=False
) to writeCacheKey
records to the metadata DB.CacheKey
recording was enabled by default previously. -
11704 Breaking change: Jinja templating for SQL queries has been updated, removing default modules such as
datetime
andrandom
and enforcing static template values. To restore or extend functionality, useJINJA_CONTEXT_ADDONS
andCUSTOM_TEMPLATE_PROCESSORS
insuperset_config.py
. -
11509: Config value
TABLE_NAMES_CACHE_CONFIG
has been renamed toDATA_CACHE_CONFIG
, which will now also hold query results cache from connected datasources (previously held inCACHE_CONFIG
), in addition to the table names. If you will setDATA_CACHE_CONFIG
to a new cache backend different than your previousCACHE_CONFIG
, plan for additional cache warmup to avoid degrading charting performance for the end users. -
11575 The Row Level Security (RLS) config flag has been moved to a feature flag. To migrate, add
ROW_LEVEL_SECURITY: True
to theFEATURE_FLAGS
dict insuperset_config.py
. -
11259: config flag ENABLE_REACT_CRUD_VIEWS has been set to
True
by default, set toFalse
if you prefer to the vintage look and feel. However, we may discontinue support on the vintage list view in the future. -
11244: The
REDUCE_DASHBOARD_BOOTSTRAP_PAYLOAD
feature flag has been removed after being set to True for multiple months. -
11172: Turning off language selectors by default as i18n is incomplete in most languages and requires more work. You can easily turn on the languages you want to expose in your environment in superset_config.py
-
11172: Breaking change: SQL templating is turned off by default. To turn it on set
ENABLE_TEMPLATE_PROCESSING
to True onFEATURE_FLAGS
Potential Downtime
-
11920: Undoes the DB migration from 11714 to prevent adding new columns to the logs table. Deploying a sha between these two PRs may result in locking your DB.
-
11714: Logs significantly more analytics events (roughly double?), and when using DBEventLogger (default) could result in stressing the metadata database more.
-
11098: includes a database migration that adds a
uuid
column to most models, and updatesDashboard.position_json
to include chart UUIDs. Depending on number of objects, the migration may take up to 5 minutes, requiring planning for downtime.
Deprecations
- 11155: The
FAB_UPDATE_PERMS
config parameter is no longer required as the Superset application correctly informs FAB under which context permissions should be updated.
0.38.0
-
10887: Breaking change: The custom cache backend changed in order to support the Flask-Caching factory method approach and thus must be registered as a custom type. See here for specifics.
-
10674: Breaking change: PUBLIC_ROLE_LIKE_GAMMA was removed is favour of the new PUBLIC_ROLE_LIKE so it can be set to whatever role you want.
-
10590: Breaking change: this PR will convert iframe chart into dashboard markdown component, and remove all
iframe
,separator
, andmarkup
slices (and support) from Superset. If you have important data in those slices, please backup manually. -
10562: EMAIL_REPORTS_WEBDRIVER is deprecated use WEBDRIVER_TYPE instead.
-
10567: Default WEBDRIVER_OPTION_ARGS are Chrome-specific. If you're using FF, should be
--headless
only -
10241: change on Alpha role, users started to have access to "Annotation Layers", "Css Templates" and "Import Dashboards".
-
10324: Facebook Prophet has been introduced as an optional dependency to add support for timeseries forecasting in the chart data API. To enable this feature, install Superset with the optional dependency
prophet
or directlypip install fbprophet
. -
10320: References to blacklist/whitelist language have been replaced with more appropriate alternatives. All configs referencing containing
WHITE
/BLACK
have been replaced withALLOW
/DENY
. Affected config variables that need to be updated:TIME_GRAIN_BLACKLIST
,VIZ_TYPE_BLACKLIST
,DRUID_DATA_SOURCE_BLACKLIST
.
0.37.1
- 10794: Breaking change:
uuid
python package is not supported on Jinja2 anymore, only uuid functions are exposed eg:uuid1
,uuid3
,uuid4
,uuid5
.
0.37.0
-
9964: Breaking change on Flask-AppBuilder 3. If you're using OAuth, find out what needs to be changed here.
-
10233: a change which deprecates the
ENABLE_FLASK_COMPRESS
config option in favor of the Flask-CompressCOMPRESS_REGISTER
config option which serves the same purpose. -
10222: a change which changes how payloads are cached. Previous cached objects cannot be decoded and thus will be reloaded from source.
-
10130: a change which deprecates the
dbs.perm
column in favor of SQLAlchemy hybrid attributes. -
10034: a change which deprecates the public security manager
assert_datasource_permission
,assert_query_context_permission
,assert_viz_permission
, andrejected_tables
methods with theraise_for_access
method which also handles assertion logic for SQL tables. -
10031: a change which renames the following public security manager methods:
can_access_datasource
tocan_access_table
,all_datasource_access
tocan_access_all_datasources
,all_database_access
tocan_access_all_databases
,database_access
tocan_access_database
,schema_access
tocan_access_schema
, anddatasource_access
tocan_access_datasource
. Regrettably it is not viable to provide aliases for the deprecated methods as this would result in a name clash. Finally thecan_access_table
(previouslycan_access_database
) method signature has changed, i.e., the optionalschema
argument no longer exists. -
10030: a change which renames the public security manager
schemas_accessible_by_user
method toget_schemas_accessible_by_user
. -
9786: with the upgrade of
werkzeug
from version0.16.0
to1.0.1
, thewerkzeug.contrib.cache
module has been moved to a standalone package cachelib. For example, to import theRedisCache
class, please use the following import:from cachelib.redis import RedisCache
. -
9794: introduces
create view as
functionality in the sqllab. This change will require thequery
table migration and potential service downtime as that table has quite some traffic. -
9572: a change which by default means that the Jinja
current_user_id
,current_username
, andurl_param
context calls no longer need to be wrapped viacache_key_wrapper
in order to be included in the cache key. Thecache_key_wrapper
function should only be required for Jinja add-ons.
0.36.0
-
8867: a change which adds the
tmp_schema_name
column to thequery
table which requires locking the table. Given thequery
table is heavily used performance may be degraded during the migration. Scheduled downtime may be advised. -
9238: the config option
TIME_GRAIN_FUNCTIONS
has been renamed toTIME_GRAIN_EXPRESSIONS
to better reflect the content of the dictionary. -
9218: SQLite connections have been disabled by default for analytics databases. You can optionally enable SQLite by setting
PREVENT_UNSAFE_DB_CONNECTIONS
toFalse
. It is not recommended to change this setting, as arbitrary SQLite connections can lead to security vulnerabilities. -
9133: Security list of permissions and list views has been disable by default. You can optionally enable them back again by setting the following config keys:
FAB_ADD_SECURITY_PERMISSION_VIEW
,FAB_ADD_SECURITY_VIEW_MENU_VIEW
,FAB_ADD_SECURITY_PERMISSION_VIEWS_VIEW
toTrue
. -
9173: Changes the encoding of the query source from an int to an enum.
-
9120: Changes the default behavior of ad-hoc sharing of queries in SQLLab to one that links to the saved query rather than one that copies the query data into the KVStore model and links to the record there. This is a security-related change that makes SQLLab query sharing respect the existing role-based access controls. Should you wish to retain the existing behavior, set two feature flags:
"KV_STORE": True
will re-enable the/kv/
and/kv/store/
endpoints, and"SHARE_QUERIES_VIA_KV_STORE": True
will tell the front-end to utilize them for query sharing. -
9109: Expire
filter_immune_slices
andfilter_immune_filter_fields
to favor dashboard scoped filter metadatafilter_scopes
. -
9046: Replaces
can_only_access_owned_queries
byall_query_access
favoring a white list approach. Since a new permission is introduced usesuperset init
to create and associate it by default to theAdmin
role. Note that, by default, all nonAdmin
users will not be able to access queries they do not own. -
8901: The datasource's update timestamp has been added to the query object's cache key to ensure updates to datasources are always reflected in associated query results. As a consequence all previously cached results will be invalidated when updating to the next version.
-
8699: A
row_level_security_filters
table has been added, which is many-to-many withtables
andab_roles
. The applicable filters are added to the sqla query, and the RLS ids are added to the query cache keys. If RLS is enabled in config.py (ENABLE_ROW_LEVEL_SECURITY = True
; by default, it is disabled), they can be accessed through theSecurity
menu, or when editing a table. -
8732: Swagger user interface is now enabled by default. A new permission
show on SwaggerView
is created bysuperset init
and given to theAdmin
Role. To disable the UI, setFAB_API_SWAGGER_UI = False
on config. -
8721: When using the cache warmup Celery task you should now specify the
SUPERSET_WEBSERVER_PROTOCOL
variable in your configuration (probably either "http" or "https"). This defaults to "http". -
8512:
DRUID_IS_ACTIVE
now defaults to False. To enable Druid-API-based functionality, override theDRUID_IS_ACTIVE
configuration variable by setting it toTrue
for your deployment. -
8450: The time range picker now uses UTC for the tooltips and default placeholder timestamps (sans timezone).
-
8418: FLASK_APP / Worker App have changed. FLASK_APP should be updated to
superset.app:create_app()
and Celery Workers should be started with--app=superset.tasks.celery_app:app
-
9017:
SIP_15_ENABLED
now defaults to True which ensures that for all new SQL charts the time filter will behave like [start, end). Existing deployments should either disable this feature to keep the status quo or inform their users of this change prior to enabling the flag. TheSIP_15_GRACE_PERIOD_END
option provides a mechanism for specifying how long chart owners have to migrate their charts (the default is indefinite).
0.35.0
-
8370: Deprecates the
HTTP_HEADERS
variable in favor ofDEFAULT_HTTP_HEADERS
andOVERRIDE_HTTP_HEADERS
. To retain the same behavior you should useOVERRIDE_HTTP_HEADERS
instead ofHTTP_HEADERS
.HTTP_HEADERS
will still work but may be removed in a future update. -
We're deprecating the concept of "restricted metric", this feature was not fully working anyhow.
-
8117: If you are using
ENABLE_PROXY_FIX = True
, review the newly-introduced variable,PROXY_FIX_CONFIG
, which changes the proxy behavior in accordance with Werkzeug -
8069: introduces MessagePack and PyArrow for async query results backend serialization. To disable set
RESULTS_BACKEND_USE_MSGPACK = False
in your configuration. -
8371: makes
tables.table_name
,dbs.database_name
,datasources.cluster_name
, andclusters.cluster_name
non-nullable. Depending on the integrity of the data, manual intervention may be required.
0.34.0
-
7848: If you are running redis with celery, celery bump to 4.3.0 requires redis-py upgrade to 3.2.0 or later.
-
7667: a change to make all Unix timestamp (which by definition are in UTC) comparisons refer to a timestamp in UTC as opposed to local time.
-
7653: a change which deprecates the table_columns.database_expression column. Expressions should be handled by the DB engine spec conversion, Python date format, or custom column expression/type.
-
The repo no longer contains translation binaries (
.mo
) files. If you want translations in your build, you now have to run the commandbabel-compile --target superset/translations
as part of your builds -
5451: a change which adds missing non-nullable fields to the
datasources
table. Depending on the integrity of the data, manual intervention may be required. -
5452: a change which adds missing non-nullable fields and uniqueness constraints (which may be case insensitive depending on your database configuration) to the
columns
andtable_columns
tables. Depending on the integrity of the data, manual intervention may be required. -
fabmanager
command line is deprecated since Flask-AppBuilder 2.0.0, use the newflask fab <command>
integrated with Flask cli. -
SUPERSET_UPDATE_PERMS
environment variable was replaced byFAB_UPDATE_PERMS
config boolean key. To disable automatic creation of permissions setFAB_UPDATE_PERMS = False
on config. -
5453: a change which adds missing non-nullable fields and uniqueness constraints (which may be case insensitive depending on your database configuration) to the metrics and sql_metrics tables. Depending on the integrity of the data, manual intervention may be required.
-
7616: this bug fix changes time_compare deltas to correctly evaluate to the number of days prior instead of number of days in the future. It will change the data for advanced analytics time_compare so
1 year
from 5/1/2019 will be calculated as 365 days instead of 366 days.
Superset 0.32.0
npm run backend-sync
is deprecated and no longer needed, will fail if called- 5445: a change which prevents encoding of empty string from form data in the database. This involves a non-schema changing migration which does potentially impact a large number of records. Scheduled downtime may be advised.
Superset 0.31.0
-
If you use
Hive
orPresto
, we've moved some dependencies that were in the main package as optional now. To get these packages, runpip install superset[presto]
and/orpip install superset[hive]
as required. -
Similarly, if you use Celery's
flower
,gsheetsdb
,thrift
orthrift-sasl
, those dependencies have now been made optional in our package, meaning you may have to install them in your environment post 0.31.0 -
boto3 / botocore was removed from the dependency list. If you use s3 as a place to store your SQL Lab result set or Hive uploads, you may have to rely on an alternate requirements.txt file to install those dependencies.
-
From 0.31.0 onwards, we recommend not using the npm package
yarn
in favor of good oldnpm install
. While yarn should still work just fine, you should probably align to guarantee builds similar to the ones we use in testing and across the community in general.
Superset 0.30.0
- 0.30.0 includes a db_migration that removes allow_run_sync. This may require downtime because during the migration if the db is migrated first, superset will get 500 errors when the code can't find the field (until the deploy finishes).
Superset 0.29.0
-
India was removed from the "Country Map" visualization as the geojson file included in the package was very large
-
5933/6078: changes which add schema and table metadata cache timeout logic at the database level. If left undefined caching of metadata is disabled.
Superset 0.28.0
-
Support for Python 2 is deprecated, we only support >=3.6 from
0.28.0
onwards -
Superset 0.28 deprecates the previous dashboard layout. While 0.27 offered a migration workflow to users and allowed them to validate and publish their migrated dashboards individually, 0.28 forces the migration of all dashboards through an automated db migration script. We do recommend that you take a backup prior to this migration.
-
Superset 0.28 deprecates the
median
cluster label aggregator for mapbox visualizations. This particular aggregation is not supported on mapbox visualizations going forward. -
Superset 0.28 upgrades
flask-login
to>=0.3
, which includes a backwards-incompatible change:g.user.is_authenticated
,g.user.is_anonymous
, andg.user.is_active
are now properties instead of methods.
Superset 0.27.0
- Superset 0.27 start to use nested layout for dashboard builder, which is not backward-compatible with earlier dashboard grid data. We provide migration script to automatically convert dashboard grid to nested layout data. To be safe, please take a database backup prior to this upgrade. It's the only way people could go back to a previous state.
Superset 0.26.0
- Superset 0.26.0 deprecates the
superset worker
CLI, which is a simple wrapper around thecelery worker
command, forcing you into crafting your own nativecelery worker
command. Your command should look something likecelery worker --app=superset.sql_lab:celery_app --pool=gevent -Ofair
Superset 0.25.0
Superset 0.25.0 contains a backwards incompatible changes. If you run a production system you should schedule downtime for this upgrade.
The PRs below have more information around the breaking changes:
-
9825: Support for Excel sheet upload added. To enable support, install Superset with the optional dependency
excel
-
4587 : a backward incompatible database migration that requires downtime. Once the db migration succeeds, the web server needs to be restarted with the new version. The previous version will fail
-
4565 : we've changed the security model a bit where in the past you would have to define your authentication scheme by inheriting from Flask App Builder's
from flask_appbuilder.security.sqla.manager import SecurityManager
, you now have to derive Superset's own derivativesuperset.security.SupersetSecurityManager
. This can provide you with more hooks to define your own logic and/or defer permissions to another system as needed. For all implementation, you simply have to import and deriveSupersetSecurityManager
in place of theSecurityManager
-
4835 : our
setup.py
now only pins versions where required, giving you more latitude in using versions of libraries as needed. We do now provide arequirements.txt
with pinned versions if you want to run the suggested versions thatSuperset
builds and runs tests against. Simplypip install -r requirements.txt
in your build pipeline, likely prior topip install superset==0.25.0