Skip to content
A fast, consistent tool for working with data frame like objects within Teradata and take advantage of the Big Data and Machine Learning analytics capabilities of Vantage.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial commit Jul 9, 2019 Update README for v16.20.00.04 release Aug 20, 2019
THIRDPARTYLICENSE Initial commit Jul 9, 2019

tdplyr - Teradata R Package


The Teradata R package (tdplyr) combines the benefits of open source R language environment with the massive parallel processing capabilities of Teradata Vantage, which includes the Teradata Machine Learning Engine analytic functions and the Teradata NewSQL Engine in-database analytic functions. It allows users to develop and run R programs that take advantage of the Big Data and Machine Learning analytics capabilities of Vantage.

This package interface makes available to R users a collection of functions for analytics that reside on Vantage, so that they can perform in-database analytics with no SQL coding required. Specifically, the Teradata R package provides functions for data manipulation and transformation, data filtering and sub-setting, on remote Teradata database table and can be used in conjunction with open source R capabilities. Moreover, the Teradata R package conforms and works with the functions of the dbplyr package and most of the verbs of the dplyr package.

Teradata Vantage Client R Analytic library
Copyright © 2018, Teradata. All Rights Reserved.

For Teradata R package documentation, please visit Teradata R Package Documentation

For Teradata customer support, please visit Teradata Access

General product information is available in the Teradata Documentation website

  • Teradata R Package User Guide – B700-4005
  • Teradata R Function Reference – B700-4007
  • Teradata® Vantage Machine Learning Engine Analytic Function Reference - B700-4003
  • Teradata® Database Analytic Functions - B035-1206


The Teradata R package (tdplyr) contains proprietary code and cannot be offered on CRAN. It is available from Teradata's R package repository.

The Teradata R package depends on the dplyr, dbplyr, DBI, magrittr and teradatasql packages which are available from CRAN and Teradata's R package repository.

To download and install dependencies automatically, specify the Teradata R package repository and CRAN in the repos argument for install.packages.

Rscript -e "install.packages('tdplyr',repos=c('',''))"

Minimum System Requirements

R: (64 bit only)

  • R v3.4.3 or later versions

Teradata Vantage:

  • Vantage 1.0 - Maintenance Update 2 or later versions
  • NewSQL Engine 16.20 Feature Update 1 or later versions
  • Teradata Machine Learning Engine or later versions

Supported Drivers:

  • Teradata SQL Driver for R (Recommended)
  • Teradata ODBC Driver 16.20 (Deprecated)

Operating Systems: (64-bit only)

  • Windows 7
  • MacOS OSX 10.9
  • Ubuntu 16
  • RHEL 7
  • SLES/OpenSUSE 12

Change Log


  • Added 4 new SQLEngine analytic functions, which will work only with Vantage 1.1.
    • td_antiselect_sqle
    • td_pack_sqle
    • td_string_similarity_sqle
    • td_unpack_sqle


  • Support for Teradata SQL driver for R has been added. Teradata recommends to use Teradata SQL driver for R with tdplyr.
  • Simplified procedure to install tdplyr package with its dependent packages including Teradata SQL driver for R.
  • Support added to td_create_context(connect to Teradata Vantage) to support different logon mechanisms with Teradata SQL Driver. Logon mechanisms supported are: TD2, LDAP, TDNEGO, KRB5(for Kerberos).
  • 11 new analytic function (9 for MLEngine and 2 for SQLEngine) wrappers have been added.
  • Below ML Engine analytic functions have new arguments added and the new arguments will work only with Teradata Vantage 1.1 or later releases.
    • td_decision_forest_mle
    • td_decision_tree_mle
    • td_knn_mle
    • td_varmax_mle


  • 45 new Analytic functions added. The package now has 105 analytic functions(9 SQLEngine and 96 MLEngine functions)
  • Enhanced copy_to function to have "append" option.
  • Updated analytic function names to contain information about the execution engine. Analytic function names will have "_sqle" or "_mle" extension in the function names.
  • Configurable aliases for Analytic functions


  • Initial release of Teradata R package for analytics within Teradata Vantage
  • Provide compatibility with dplyr package verbs for a SQL-like grammar via R functions for data manipulation
  • Provides compatibility with dbplyr package which provides a database backend for R and enables using remote database tables as in-memory R data frames
  • Supports connectivity to Teradata database using Teradata ODBC driver
  • Provides R interface to run MLEngine and SQLEngine analytic functions within Teradata Vantage
  • Support for 3 major OS Platforms(Windows/OSX/Linux)
You can’t perform that action at this time.