Files
superset2/superset/db_engine_specs/teradata.py
2026-01-21 10:54:01 -08:00

75 lines
2.8 KiB
Python

# 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 superset.db_engine_specs.base import BaseEngineSpec, DatabaseCategory
class TeradataEngineSpec(BaseEngineSpec):
"""Dialect for Teradata DB."""
engine = "teradatasql"
engine_name = "Teradata"
metadata = {
"description": "Teradata is an enterprise data warehouse platform.",
"logo": "teradata.png",
"homepage_url": "https://www.teradata.com/",
"categories": [
DatabaseCategory.TRADITIONAL_RDBMS,
DatabaseCategory.PROPRIETARY,
],
"pypi_packages": ["teradatasqlalchemy"],
"connection_string": "teradatasql://{user}:{password}@{host}",
"default_port": 1025,
"drivers": [
{
"name": "teradatasqlalchemy (Recommended)",
"pypi_package": "teradatasqlalchemy",
"connection_string": "teradatasql://{user}:{password}@{host}",
"is_recommended": True,
"notes": "No ODBC drivers required.",
},
{
"name": "sqlalchemy-teradata (ODBC)",
"pypi_package": "sqlalchemy-teradata",
"is_recommended": False,
"notes": "Requires ODBC driver installation.",
"docs_url": "https://downloads.teradata.com/download/connectivity/odbc-driver/linux",
},
],
}
max_column_name_length = 30 # since 14.10 this is 128
_time_grain_expressions = {
None: "{col}",
"PT1M": "TRUNC(CAST({col} as DATE), 'MI')",
"PT1H": "TRUNC(CAST({col} as DATE), 'HH')",
"P1D": "TRUNC(CAST({col} as DATE), 'DDD')",
"P1W": "TRUNC(CAST({col} as DATE), 'WW')",
"P1M": "TRUNC(CAST({col} as DATE), 'MONTH')",
"P3M": "TRUNC(CAST({col} as DATE), 'Q')",
"P1Y": "TRUNC(CAST({col} as DATE), 'YEAR')",
}
@classmethod
def epoch_to_dttm(cls) -> str:
return (
"CAST(((CAST(DATE '1970-01-01' + ({col} / 86400) AS TIMESTAMP(0) "
"AT 0)) AT 0) + (({col} MOD 86400) * INTERVAL '00:00:01' "
"HOUR TO SECOND) AS TIMESTAMP(0))"
)