Teradata SQL Driver for Python

This package enables Python applications to connect to the Teradata Database.

This package implements the PEP-249 Python Database API Specification 2.0.

This package requires 64-bit Python 3.7 or later and runs on the following operating systems and processor architectures. 32-bit Python is not supported.

Windows x64 on 64-bit Intel and AMD processors
macOS on 64-bit ARM processors
macOS on 64-bit Intel processors
Linux x64 on 64-bit Intel and AMD processors
Linux ARM64 on 64-bit ARM processors
Linux ppc64le on 64-bit Power processors

For community support, please visit Teradata Community.

For Teradata customer support, please visit Teradata Customer Service.

Please note, this driver may contain beta/preview features ("Beta Features"). As such, by downloading and/or using the driver, in addition to agreeing to the licensing terms below, you acknowledge that the Beta Features are experimental in nature and that the Beta Features are provided "AS IS" and may not be functional on any machine or in any environment.

Copyright 2025 Teradata. All Rights Reserved.

Installation

The teradatasql package depends on the pycryptodome package which is available from PyPI.

Use pip install to download and install the driver and its dependencies automatically.

Platform	Command
macOS or Linux	`pip install teradatasql`
Windows	`py -3 -m pip install teradatasql`

When upgrading to a new version of the driver, you may need to use pip install's --no-cache-dir option to force the download of the new version.

Platform	Command
macOS or Linux	`pip install --no-cache-dir -U teradatasql`
Windows	`py -3 -m pip install --no-cache-dir -U teradatasql`

The teradatasql package depends on the pycryptodome package, because one of the included sample programs (TJEncryptPassword.py) uses pycryptodome. The driver itself does not use pycryptodome.

If you want to avoid installing pycryptodome, you can use the --no-deps option of pip install to avoid installing pycryptodome. Without pycryptodome, you will not be able to run the TJEncryptPassword.py sample program.

Platform	Command
macOS or Linux	`pip install --no-deps teradatasql`
Windows	`py -3 -m pip install --no-deps teradatasql`

License

Use of the driver is governed by the License Agreement for the Teradata SQL Driver for Python.

When the driver is installed, the LICENSE and THIRDPARTYLICENSE files are placed in the teradatasql directory under your Python installation directory.

In addition to the license terms, the driver may contain beta/preview features ("Beta Features"). As such, by downloading and/or using the driver, in addition to the licensing terms, you acknowledge that the Beta Features are experimental in nature and that the Beta Features are provided "AS IS" and may not be functional on any machine or in any environment.

Documentation

Documentation and sample programs are available from Teradata on github.com.

When the driver is installed, the README.md file is placed in the teradatasql directory under your Python installation directory. This permits you to view the documentation offline, when you are not connected to the Internet.

The README.md file is a plain text file containing the documentation for the driver. While the file can be viewed with any text file viewer or editor, your viewing experience will be best with an editor that understands Markdown format.

Package profile

teradatasql

Releases

Release table

PyPI Downloads

Dependencies

Details

Project URLs

Dependencies

Package description