Oven logo

Oven

teradatasql20.0.0.30

Published

Teradata SQL Driver for Python

pip install teradatasql

Package Downloads

Weekly DownloadsMonthly Downloads

Project URLs

Requires Python

>=3.7

Dependencies

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.

Table of Contents

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.

PlatformCommand
macOS or Linuxpip install teradatasql
Windowspy -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.

PlatformCommand
macOS or Linuxpip install --no-cache-dir -U teradatasql
Windowspy -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.

PlatformCommand
macOS or Linuxpip install --no-deps teradatasql
Windowspy -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.