The Teradata Plug-in for Eclipse is based on the Eclipse plug-in framework and Data Tools Platform (DTP). Teradata Plug-in for Eclipse enables Eclipse DTP to operate with the Teradata Database and value-added features.
► NOTE: This version requires Java Runtime Environment 1.6 or greater.
To install the Teradata Plug-in for Eclipse via the Eclipse Update Site process, bring up Eclipse and run the Software Updates process.
- From the main menu, select Help then Install New Software...
- In the Work with field, select the Add... button.
- Enter Teradata Update Site in the Name field and the Teradata Plug-in for Eclipse URL (http://downloads.teradata.com/download/cdn/tools/tdide/tdide-14.10.01.00/update/site.xml) as the Location.
- Click OK
- Select all of the Teradata Plug-in for Eclipse features to install.
- Click Next to proceed with the installation.
To install from a local Teradata Plug-in for Eclipse Update Site, download the zip file locally. Refer to the Installation Guide for further instructions on installing Teradata Plug-in for Eclipse.
Teradata Plug-in for Eclipse contains open source components. A package containing the source code and licenses for these components is also available above for download. This package does not contain proprietary Teradata source code.
For help getting started using the Teradata Plug-in, refer to the Getting Started with Teradata Plug-in for Eclipse article.
Readme
Teradata Plug-in for Eclipse 14.10.01 release information.
Supported Platforms:
=============================
Windows Vista - Microsoft Windows Vista Enterprise, 32-bit and 64-bit
Windows XP Professional - Microsoft Windows XP Professional, 32-bit and 64-bit
Windows Server - Microsoft Windows Server 2003, 32-bit and 64-bit
- Microsoft Windows Server 2008, 32-bit and 64-bit
Windows 2000 - Microsoft Windows 2000, 32-bit
Windows 7 - Microsoft Windows 7, 32-bit and 64-bit
Windows 8 - Microsoft Windows 8, 32-bit and 64-bit
Apple Mac - OSX 10.5, 10.6, 10.7, and 10.8
Dependent Eclipse Software:
=============================
Eclipse IDE for Java JEE Developers Kepler (4.3 R1)
Eclipse IDE for Java JEE Developers Juno (4.2.2 SR2)
Supported Teradata Databases Versions:
======================================
Teradata Database 12.0
Teradata Database 13.0
Teradata Database 13.10
Teradata Database 14.00
Teradata Database 14.10
Supported Aster Databases Versions:
======================================
Aster Database 5.0
Aster Database 5.10
Required Software:
=============================
Java Runtime Environment (JRE) version 1.6 or greater
Install Instructions;
=============================
Once the dependent software has been downloaded, Teradata Plug-in for Eclipse can
be installed and configured. Follow this procedure to install Teradata Plug-in for
Eclipse 14.10 using the Eclipse Update Site install procedure.
To install Teradata Plug-in for Eclipse 14.10.01:
1. From the main menu, click Help and then click Install New Software….
2. Click the Add... button.
3. Type ”Teradata Update Site” in the Name field and the Teradata Plug-in for
Eclipse update site URL as the Location:
http://downloads.teradata.com/download/cdn/tools/tdide/tdide-14.10.01.00/update/site.xml
4. Click OK to add the site.
5. Select each of the Teradata Plug-in for Eclipse components, and then click Next.
6. When the Feature License Agreement appears, select I accept the terms in the
license agreement, and then click Next. A list of features appears with the feature
version, size, and Eclipse install location.
7. Verify that the information is correct, and then click Finish to continue the
installation. A warning message appears regarding unsigned JAR content.
8. Click OK to continue.
9. When a message appears asking if you want to restart Eclipse, click Yes.
Bug Fixes
================================
The following bugs were fixed in 14.10.01:
IDE-7532 Aster SQL Exception is thrown while expanding the schemas that have special character in the name
IDE-7855 Aster schema cache - can't get row count for table in schema cache
IDE-7858 Aster quick select doesn't qualify table names
IDE-7917 Don't filter out database if parent is not in list.
IDE-7931 Show DSE Hierarchy is running out of Memory trying to load huge number of databases/users
IDE-8030 Generate DDL returns comments first causing Show DDL to show comment
IDE-8209 Aster: Columns are not displaying under the 'Columns' node in the DSE if table name contains special characters
IDE-8229 HadoopViaOozie: Exceptions thrown while exporting a table from Teradata to Hadoop
IDE-8230 Transfer History Filter: Exception is thrown while launching the Help contents for Transfer History Filter
IDE-8238 Show DSE Hierarchy : Exceptions are thrown while trying to access any object in the DSE for a database that has a huge number of Users/Databases
IDE-8239 Teradata : Load Data and Export Data menu options should be disabled when selecting multiple tables from DSE
IDE-8244 HadoopViaOozie: Finish button is not enabled after editing the name of the target table in the Import from Hadoop wizard
IDE-8246 Sample Contents -> Error message is thrown when selecting 'Sample Contents' for table with LOB column
IDE-8316 Table Editor: smallint column type is not working for Show values
IDE-8328 HadoopViaOozie - Import from Hadoop: Unhandled event loop exception is thrown when the user clicks on the empty space in the Tables list box
IDE-8330 Export Table to Hadoop--> Data type ‘double’ is displayed twice in the Destination Type combo for all numeric data types
IDE-8333 Closing connection for Table Data editor causes errors forcing user to quit application on refresh
Improvements
================================
The following improvements were implemented in 14.10.01:
IDE-7684 Aster JDBC Driver 5.11
IDE-8024 Sample Content performs SQL SAMPLE (Teradata) or LIMIT (Aster) command
IDE-8033 Aster Load Tables and Views performance improvement
IDE-8139 Teradata Resultset processing should count rows instead of resultset.last() call
Hadoop Configuration Support:
=============================
Teradata Studio provides an option to transfer data to and from Hadoop systems using its feature called the
Smart Loader for Hadoop. The Smart Loader for Hadoop uses the Teradata Connector for Hadoop (TDCH), which is
installed on the Hadoop node, to provide the data transfer to and from the Hadoop system. Teradata Studio
requires TDCH version 1.0.9a. The following are the system requirements of TDCH 1.0.9a:
System
JRE/JDK 1.6
Supported Teradata Database versions:
Teradata Database 13.0
Teradata Database 13.10
Teradata Database 14.0
Teradata Database 14.10
Supported Hortonworks Data Platform (HDP) versions:
HDP 1.3.2 (Hadoop 1.2.0, Hive(HCatalog) 0.11.0)
HDP 1.1.0.17 (Hadoop 1.0.3, Hive 0.9.0, HCatalog 0.4.0)
Teradata Connector for Hadoop Setup:
====================================
The TDCH 1.0.9a must be installed and configured on the Hadoop system. Teradata Plugin for Eclipse's Smart Loader
for Hadoop uses Oozie to submit the data transfer workflow on the Hadoop System. Please follow these instructions
to configure the Hadoop System and create the Oozie workflow files.
1) Download and install the TDCH (version 1.0.9a or greater) onto your Hadoop system.
2) Download the Configure Oozie script (configureOozie.sh) from the Teradata Plugin for Eclipse download page onto your Hadoop system.
3) Change the mode so the script is executable:
chmod +x configureOozie.sh
4) Run the configureOozie script through dos2unix to remove any hidden Windows characters from the file.
dos2unix configureOozie.sh
5) Execute the configureOozie.sh script as root user, providing the locations of your Hadoop services.
The usage of the configureOozie.sh script is as follows (this is all a single line):
Usage: ./configureOozie.sh nn=nameNodeHost [jt=jobTrackerHost] [oozie=oozieHost] [nnPort=nameNodePortNum] [jtPort=jobTrackerPortNum] [ooziePort=ooziePortNum] [webhcatPort=webhcatPortNum] [webhdfsPort=webhdfsPortNum]
(The parameters surrounded by [ ] are optional. The “[“ and “]” are not part of the command.)
nn - The Name Node host name (required)
jt - The Job Tracker host name (uses nn parameter value if omitted)
oozie - The Oozie host name (uses nn parameter value if omitted)
nnPort - The Name node port number (8020 if omitted)
jtPort - The Job Tracker port number (50300 if omitted)
ooziePort - The Oozie port number (11000 if omitted)
webhcatPort - The WebHCatalog port number (50111 if omitted)
webhdfsPort - The WebHDFS port number (50070 if omitted)
The port numbers are HDP’s defaults. So, if the system being set up has all the services
hosted on a single system on the default ports, only the nn parameter is needed.
Example: ./configureOozie.sh nn=hdp001-nn jt=hdp001-jt oozie=hdp001-jt
Warning: On a Teradata appliance, use the master nodes' virtual hostnames (i.e. hdp001-nn, hdp001-jt) instead of their physical hostnames (i.e. hdp001-8).
The script will exit with an error message if the TDCH is not in its expected location.
Otherwise the script will display a message indicating the parameters values. A sample
message is as follows:
The following is the specification of the Hadoop services used by the Oozie workflows:
{
"Distribution":"HDP",
"DistributionVersion":"3.2.1",
"WebHCatalog":"hostname",
"WebHCatalogPort":50111,
"WebHDFS":"hostname",
"WebHDFSPort":50070,
"JobTracker":"hostname",
"JobTrackerPort":50300,
"NameNode":"hostname",
"NameNodePort":8020,
"Oozie":"hostname",
"OoziePort":11000
}
** You must also make sure the Teradata IDE client machine can access the Hadoop system services. Thus, you may need to add the Hadoop services names and IP addresses to your host file or DNS service.