feat: add TDengine.py driver to db_engine

README.md

@@ -137,6 +137,7 @@ Here are some of the major database solutions that are supported:
   <img src="https://superset.apache.org/img/databases/sap-hana.png" alt="oceanbase" border="0" width="220" />
   <img src="https://superset.apache.org/img/databases/denodo.png" alt="denodo" border="0" width="200" />
   <img src="https://superset.apache.org/img/databases/ydb.svg" alt="ydb" border="0" width="200" />
+  <img src="https://superset.apache.org/img/databases/tdengine.png" alt="TDengine" border="0" width="200" />
 </p>
 
 **A more comprehensive list of supported databases** along with the configuration instructions can be found [here](https://superset.apache.org/docs/configuration/databases).

docs/docs/configuration/databases.mdx

@@ -77,6 +77,7 @@ are compatible with Superset.
 | [Snowflake](/docs/configuration/databases#snowflake)                    | `pip install snowflake-sqlalchemy`                                                 | `snowflake://{user}:{password}@{account}.{region}/{database}?role={role}&warehouse={warehouse}`                                                        |
 | SQLite                                                    | No additional library needed                                                       | `sqlite://path/to/file.db?check_same_thread=false`                                                                                                     |
 | [SQL Server](/docs/configuration/databases#sql-server)                  | `pip install pymssql`                                                              | `mssql+pymssql://`                                                                                                                                     |
+| [TDengine](/docs/configuration/databases#tdengine)                      | `pip install taospy`  `pip install taos-ws-py`                                     | `taosws://<user>:<password>@<host>:<port>`                                                                                                             |
 | [Teradata](/docs/configuration/databases#teradata)                      | `pip install teradatasqlalchemy`                                                   | `teradatasql://{user}:{password}@{host}`                                                                                                               |
 | [TimescaleDB](/docs/configuration/databases#timescaledb)                | `pip install psycopg2`                                                             | `postgresql://<UserName>:<DBPassword>@<Database Host>:<Port>/<Database Name>`                                                                          |
 | [Trino](/docs/configuration/databases#trino)                            | `pip install trino`                                                                | `trino://{username}:{password}@{hostname}:{port}/{catalog}`                                                                                            |
@@ -1336,6 +1337,26 @@ starrocks://<User>:<Password>@<Host>:<Port>/<Catalog>.<Database>
 StarRocks maintains their Superset docuementation [here](https://docs.starrocks.io/docs/integrations/BI_integrations/Superset/).
 :::
 
+#### TDengine
+
+The recommended connector library for TDengine is
+[taospy](https://pypi.org/project/taospy/).
+You need to install the extras as well for this library.
+We recommend adding something like the following
+text to your requirements file:
+
+```
+taospy>=2.7.19
+taos-ws-py>=0.3.5
+```
+
+The expected connection string is formatted as follows:
+
+```
+taosws://<user>:<password>@<host>:<port>
+```
+
+
 #### Teradata
 
 The recommended connector library is

superset/db_engine_specs/TDengine.py

@@ -0,0 +1,33 @@
+# TDengine driver for Apache SuperSet
+from superset.db_engine_specs.base import  BaseEngineSpec
+from urllib import parse
+
+class TDengineEngineSpec(BaseEngineSpec):
+    engine = "taosws"
+    engine_name = "TDengine"
+    max_column_name_length = 64
+    default_driver = "taosws"
+    sqlalchemy_uri_placeholder = ("taosws://user:password@host:port/dbname[?key=value&key=value...]")
+
+    # time grain
+    _time_grain_expressions = {
+        None: "{col}",
+        "PT1S": "TIMETRUNCATE({col}, 1s, 0)",
+        "PT1M": "TIMETRUNCATE({col}, 1m, 0)",
+        "PT1H": "TIMETRUNCATE({col}, 1h, 0)",
+        "P1D":  "TIMETRUNCATE({col}, 1d, 0)",
+        "P1W":  "TIMETRUNCATE({col}, 1w, 0)",
+    }
+
+    @classmethod
+    def get_schema_from_engine_params(
+        cls,
+        sqlalchemy_uri: URL,
+        connect_args: dict[str, Any],
+    ) -> Optional[str]:
+        """
+        Return the configured schema.
+
+        A TDengine database is a SQLAlchemy schema.
+        """
+        return parse.unquote(sqlalchemy_uri.database)

tests/unit_tests/db_engine_specs/test_TDengine.py

@@ -0,0 +1,51 @@
+# 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 decimal import Decimal
+from typing import Any, Optional
+from unittest.mock import Mock, patch
+
+import pytest
+from sqlalchemy import types
+from sqlalchemy.engine.url import make_url, URL  # noqa: F401
+from tests.unit_tests.db_engine_specs.utils import assert_convert_dttm
+
+# test dttm
+def test_convert_dttm(
+    target_type: str,
+    expected_result: Optional[str],
+    dttm: datetime,  # noqa: F811
+) -> None:
+    from superset.db_engine_specs.rockset import RocksetEngineSpec as spec  # noqa: N813
+
+    assert_convert_dttm(spec, target_type, expected_result, dttm)
+
+
+# test get schema
+def test_get_schema_from_engine_params() -> None:
+    """
+    Test the ``get_schema_from_engine_params`` method.
+    """
+    from superset.db_engine_specs.TDengine import TDengineEngineSpec
+
+    assert (
+        TDengineEngineSpec.get_schema_from_engine_params(
+            make_url("taosws://user:password@host:port/dbname"), {}
+        )
+        == "dbname"
+    )