---
id: teradatasql
version: "20.0.0.65"
license: Teradata License Agreement
license_treatment: unclear
maintenance: active
---

# teradatasql — Teradata SQL Driver for Python

License: unclear · Maintenance: active · Downloads: 10.4M/mo

## What it is and what it does

teradatasql is the official Teradata SQL Driver for Python, implementing the PEP-249 database API specification. It allows Python applications to establish connections to Teradata Database systems and execute SQL queries, handling authentication, query execution, and result retrieval through a standard database interface.

The driver depends on pycryptodome, though that dependency is only required for running the included TJEncryptPassword.py sample program; the driver core does not use it. The package is actively maintained, supports modern Python versions (3.7 through 3.11), and runs on Windows, macOS, and Linux across multiple processor architectures (x64 Intel/AMD, ARM, and Power). Installation is straightforward via pip, with optional dependency skipping available if you do not need the sample encryption utility.

Use it for:

- Connect Python applications to Teradata data warehouses for ETL, reporting, or analytics workflows.
- Execute parameterized SQL queries and retrieve results in a standard Python database interface.
- Migrate or integrate legacy Teradata systems with modern Python data pipelines.
- Encrypt database passwords for secure credential management using the bundled TJEncryptPassword utility.
- Build cross-platform Python services that query Teradata on Windows, macOS, or Linux infrastructure.

## Worth the install?

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

A PEP-249 compliant Python database driver that enables applications to connect to and query Teradata Database systems.

Yes, if you need to connect Python to a Teradata Database. The driver is actively maintained, has low install friction, supports current Python versions, and implements the standard PEP-249 interface. However, review the proprietary Teradata License Agreement before use in commercial or open-source redistribution contexts, and note that beta features carry no functional guarantees.

## Install

pip install teradatasql
uv add teradatasql
poetry add teradatasql

## Installing teradatasql

Before you install: Low install friction; single runtime dependency (pycryptodome) is optional for core driver functionality. Active maintenance with a release 2 days old. Supports Python 3.7 through 3.11 on Windows, macOS, and Linux across multiple processor architectures.

License in practice: Licensed under Teradata License Agreement (proprietary, not SPDX-identified). License treatment is unclear; review the LICENSE file bundled with installation before use in commercial or redistributed contexts. Beta features are provided as-is without functional guarantees.

Quickstart:

pip install teradatasql

import teradatasql

connection = teradatasql.connect(host='teradata-host', user='username', password='password')
cursor = connection.cursor()
cursor.execute('SELECT * FROM table')
results = cursor.fetchall()

Requires 64-bit Python 3.7 or later; 32-bit Python is not supported. Teradata Database server must be accessible at the specified host.

Verify before relying:

- Whether the proprietary Teradata License Agreement permits use in open-source or commercial projects without additional licensing.
- Performance characteristics and connection pooling capabilities compared to other Teradata client libraries.
- Whether beta/preview features are documented and which features carry that designation.

## Package facts

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

## Tags

teradata database connection, python teradata driver, teradata sql client, database api pep 249, teradata query execution, python database adapter, database-driver, teradata, pep-249

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