| # 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. |
| from datetime import datetime |
| from typing import Dict, Optional, Type |
| |
| from superset.db_engine_specs.base import BaseEngineSpec |
| from superset.db_engine_specs.exceptions import SupersetDBAPIDatabaseError |
| from superset.utils import core as utils |
| |
| |
| class ClickHouseEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method |
| """Dialect for ClickHouse analytical DB.""" |
| |
| engine = "clickhouse" |
| engine_name = "ClickHouse" |
| |
| time_secondary_columns = True |
| time_groupby_inline = True |
| |
| _time_grain_expressions = { |
| None: "{col}", |
| "PT1M": "toStartOfMinute(toDateTime({col}))", |
| "PT5M": "toDateTime(intDiv(toUInt32(toDateTime({col})), 300)*300)", |
| "PT10M": "toDateTime(intDiv(toUInt32(toDateTime({col})), 600)*600)", |
| "PT15M": "toDateTime(intDiv(toUInt32(toDateTime({col})), 900)*900)", |
| "PT0.5H": "toDateTime(intDiv(toUInt32(toDateTime({col})), 1800)*1800)", |
| "PT1H": "toStartOfHour(toDateTime({col}))", |
| "P1D": "toStartOfDay(toDateTime({col}))", |
| "P1W": "toMonday(toDateTime({col}))", |
| "P1M": "toStartOfMonth(toDateTime({col}))", |
| "P0.25Y": "toStartOfQuarter(toDateTime({col}))", |
| "P1Y": "toStartOfYear(toDateTime({col}))", |
| } |
| |
| @classmethod |
| def get_dbapi_exception_mapping(cls) -> Dict[Type[Exception], Type[Exception]]: |
| from urllib3.exceptions import NewConnectionError |
| |
| return {NewConnectionError: SupersetDBAPIDatabaseError} |
| |
| @classmethod |
| def get_dbapi_mapped_exception(cls, exception: Exception) -> Exception: |
| new_exception = cls.get_dbapi_exception_mapping().get(type(exception)) |
| if new_exception == SupersetDBAPIDatabaseError: |
| return SupersetDBAPIDatabaseError("Connection failed") |
| if not new_exception: |
| return exception |
| return new_exception(str(exception)) |
| |
| @classmethod |
| def convert_dttm(cls, target_type: str, dttm: datetime) -> Optional[str]: |
| tt = target_type.upper() |
| if tt == utils.TemporalType.DATE: |
| return f"toDate('{dttm.date().isoformat()}')" |
| if tt == utils.TemporalType.DATETIME: |
| return f"""toDateTime('{dttm.isoformat(sep=" ", timespec="seconds")}')""" |
| return None |