---
id: teradatasqlalchemy
version: "20.0.0.9"
license: Teradata License Agreement
license_treatment: unclear
maintenance: aging
---

# teradatasqlalchemy — Teradata SQL Driver Dialect for SQLAlchemy

License: unclear · Maintenance: aging · Downloads: 5.2M/mo

## What it is and what it does

teradatasqlalchemy is a SQLAlchemy dialect that bridges Python applications to Teradata databases. It works by implementing SQLAlchemy's dialect interface, allowing developers to use SQLAlchemy's ORM, Core, and SQL expression APIs against Teradata instead of writing raw SQL. The package depends on sqlalchemy and teradatasql and requires 64-bit Python 3.4 or later on Windows, macOS, or Linux.

The dialect maps Teradata-specific data types—including arrays, vectors, JSON, XML, and temporal types—to SQLAlchemy type objects, and provides Teradata-specific methods like partition_by() and has_table() with datalake support. Recent versions added queryband telemetry tracking, support for views and external tables, and expanded array type coverage. Connection is configured via a teradatasql:// URL scheme with parameters for account, authentication, and connection tuning.

Use it for:

- Build Python applications using SQLAlchemy ORM against Teradata without writing native SQL.
- Migrate SQLAlchemy code from other databases to Teradata by swapping the connection dialect.
- Query Teradata tables and views programmatically within data pipelines or ETL workflows.
- Track application usage and performance via queryband telemetry integration with Teradata logs.
- Work with Teradata-specific data types (arrays, vectors, JSON, XML) through SQLAlchemy's type system.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a SQLAlchemy dialect that enables Python applications to connect to and query Teradata databases using SQLAlchemy's ORM and SQL expression language.

Yes, if you are locked into Teradata and need SQLAlchemy integration. The package is stable (no vulnerabilities), has low install friction, and is widely used. However, the proprietary license is unclear and maintenance is aging (241 days since last release). Verify license terms and test compatibility with your SQLAlchemy and Teradata versions before committing to production use.

## Install

pip install teradatasqlalchemy
uv add teradatasqlalchemy
poetry add teradatasqlalchemy

## Installing teradatasqlalchemy

Before you install: Low friction installation as a pure-Python wheel. Maintenance status is aging—last release was 241 days ago—but the package remains actively used (top 5000 on PyPI) and has no known security vulnerabilities.

License in practice: Licensed under a proprietary Teradata License Agreement with unclear terms. Users should review the LICENSE file included in the package installation to understand usage restrictions before adopting it in production.

Quickstart:

pip install teradatasqlalchemy

import sqlalchemy
eng = sqlalchemy.create_engine('teradatasql://guest:please@whomooz')

Requires 64-bit Python 3.4 or later; 32-bit Python is not supported.

Verify before relying:

- Whether the proprietary license permits commercial use without additional licensing agreements.
- Current state of SQLAlchemy 2.0+ compatibility beyond what release notes indicate.
- Whether 64-bit Python requirement is enforced or advisory.

## Package facts

- License: Teradata License Agreement (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 5.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sqlalchemy teradata dialect, teradata database python orm, connect teradata sqlalchemy, teradata sql driver, python teradata database adapter, sqlalchemy teradata connector, teradata query builder python, sqlalchemy-dialect, teradata-integration

[View on SkillFed](https://skillfed.io/packages/teradatasqlalchemy) · [View on PyPI](https://pypi.org/project/teradatasqlalchemy/)