# 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 Optional from superset.db_engine_specs.base import BaseEngineSpec class ClickHouseEngineSpec(BaseEngineSpec): # pylint: disable=abstract-method """Dialect for ClickHouse analytical DB.""" engine = "clickhouse" time_secondary_columns = True time_groupby_inline = True _time_grain_functions = { 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 convert_dttm(cls, target_type: str, dttm: datetime) -> Optional[str]: tt = target_type.upper() if tt == "DATE": return f"toDate('{dttm.date().isoformat()}')" if tt == "DATETIME": return f"""toDateTime('{dttm.isoformat(sep=" ", timespec="seconds")}')""" return None