teradatasqlalchemy

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 on this page — 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

teradatasqlalchemy on PyPI

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

Evidence: teradatasqlalchemy-20.0.0.9-py3-none-any.whl

Keywords: Teradata

Tags

More Front-Ends packages