Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Collection of assorted Teradata Tools

Project Description

tdtools is a collection of tools and utilities that I developed for my personal use. I am making these tools open-source in the hope that someone else might find them useful.

NOTE: These tools are not endorsed by Teradata Inc.


Theses tools are tested with Python 3.4 and Python 3.5. Python 2.7 version isn’t part of the testing and most likely will not work. However, if there is a strong interest in using Python 2.7 and changes required to support Python 2.7 are minimal, I may consider making selected modules support Python 2.7.

There is a dependency on teradata python package. It’ll be downloaded automatically if you use standard python installer pip.


Use Python’s standard pip utility to install tdtools. tdtools can be install in an virtualenv.

$ pip install tdtools


C:\>python -m pip install tdtools


No configuration is required except setting up the needed ODBC connections. All scripts that are part of tdtools accept arbitrary ODBC connection strings using --tdconn parameter.

If more flexibility is needed, for example, to use Teradata REST APIs, it may be done by providing in your PYTHONPATH. Have a look at module to get an idea about what can be overriden in


All tools are command-line utilities that are automatically installed when tdtools is installed using pip. What follows is a brief description of each tool. Each tool support --help or -h command-line option that shows detailed description of options supported.

Command Purpose
dbtree Prints Teradata database hierarchy.
vwtree Prints (or save) view hierarchy.
tptload Generate (and optionally run on Linux) TPT load script.

All show* utilities generate DDLs for different types of Teradata objects.

Command Objects
showdb Database or user
showgrant Grants to user/role
showprof Profile
showrole Role
showtvm Wrapper for Teradata SHOW <object> command
showzone Zone

All ls* utilities print Teradata object information from DBC tables. Currently supported commands are:

Command Objects
lstb Tables
lsvw Views
lsmc Macros
lspr Stored Procedures
lsfn Functions
lsji Join Indexes

Known Issues

  1. When using teradata.tdrest as method for database connection, certain show* commands will not work correctly. This is due to an upstream defect. Note that this error does not occur when using teradata.tdodbc, the default method for database connection.
  2. SQL command show in xml view doesn’t always return referenced object list. When this happens, vwtree will print an error and not display view hierarchy.


If you encounter an issue, report it using issue tracker. I’ll try to provide a fix as soon as I can. If you already have a fix, send me a pull request.


Feel free to fork this repository and enhance it in a way you see fit. If you think your changes will benefit more people, send me a pull request.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(43.0 kB) Copy SHA256 Hash SHA256
py3 Wheel Dec 28, 2016
(27.9 kB) Copy SHA256 Hash SHA256
Source Dec 28, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting