john-bodley commented on a change in pull request #9444: Implement dttm column configuration through db extra config URL: https://github.com/apache/incubator-superset/pull/9444#discussion_r402066069
########## File path: docs/installation.rst ########## @@ -1379,8 +1379,14 @@ Prior to SIP-15 SQLAlchemy used inclusive endpoints however these may behave lik To remedy this rather than having to define the date/time format for every non-IS0 8601 date-time column, once can define a default column mapping on a per database level via the ``extra`` parameter :: { + "main_dttm_column": "ds", Review comment: I sense these default settings (including the `python_date_format_by_column_name` should be documented outside of the SIP-15 section (this section can then reference said section). This would help to provide context regarding default database specific fields which may be inherited either by new Superset tables going forward or used as a fallback (in the case of SIP-15) if a value isn't defined. Additionally I was wondering if having all these nested under a `defaults` section (and possibly scoped to domain) which ensures more consistency (and thus no need for the `default_` prefix), i.e., something of the form: ```json { "defaults": { "table": { "main_dttm_col": "ds", "expression_by_column_name": { "hour_ts": "CAST(hour_ts as INTEGER)" }, "dttm_column_names": ["ds", "hour_ts"], "python_date_format_by_column_name": { "ds": "%Y-%m-%d", "hour_ts": "epoch_s" } } } } ``` Note if we go down this route the `UPDATING.md` would need to be updated to reflect the breaking SIP-15 config change. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services --------------------------------------------------------------------- To unsubscribe, e-mail: notifications-unsubscr...@superset.apache.org For additional commands, e-mail: notifications-h...@superset.apache.org