Development Status
- 5 - Production/Stable
Programming Language
- Python :: 3 :: Only
- Python :: 3.7
- Python :: 3.8
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
Operating System
- Microsoft :: Windows
- MacOS :: MacOS X
- POSIX :: Linux
Topic
- Database :: Front-Ends
License
- Other/Proprietary License
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.
| 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.
Wheel compatibility matrix
Files in release
pycryptodome