Teradata Studio

Teradata Studio is a client based graphical interface used to perform database administration tasks on the Teradata Database. It is built on the Eclipse Rich Client Platform (RCP). For more information on Teradata Studio, refer to the article Teradata Studio.

Teradata Studio Express contains several open-source components. A package containing the source code and licenses for these components is also available for download. This package does not contain proprietary Teradata source code.

For community support, please visit the Tools Forum.

► NOTE:This version requires Java Runtime Environment 1.6 or later. (To find out what version of Java you are running, open a DOS window and enter: java -version)

README

Teradata Studio 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
     Ret Hat Server - Red Hat Advanced Server 2.1, 3.0, and 4.0, 32-bit
                    - Red Hat Advanced Server 4.0, 64-bit
     Red Hat Platform - Red Hat Advanced Platform 5.0, 32-bit and 64-bit
     SUSE Linux Enterprise - SUSE Linux Enterprise 9, 32-bit and 64-bit
                      - SUSE Linux Enterprise 10, 32-bit and 64-bit
              - SUSE Linux Enterprise 11, 32-bit and 64-bit
     Apple Mac - OSX 10.5, 10.6, 10.7, and 10.8

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;
====================================
     Download the Teradata Studio zip file from the download site.

  For Windows install:
     1) Unzip the Teradata Studio package to your local file system.
     2) Run the setup.exe to launch the Teradata Studio installation.
     3) Teradata Studio is installed in the Program Files directory.
        For example, C:\Program Files (x86)\Teradata\Client\14.10\Teradata Studio.
    When Teradata Studio is started, a 'workspace' directory is created in your
    home directory (C:\Users\<user>\workspace-studio). This directory contains
    workspace files, including the SQL project folder. The teradata.log file is
    located in the install \configuration directory.


  For Linux install:
    1) Unzip and untar the Teradata Studio package to your local file system.
        gunzip TeradataStudio__linux_x86.14.10.01.00-1.tar.gz
        tar -xvf TeradataStudio__linux_x86.14.10.01.00-1.tar
    2) Change directories (CD) to the TeradataStudio.14.01.01.00 directory
        cd TeradataStudio.14.10.01.00
    3) Switch to Super User or Root and execute the RPM (Package Management) command to
       install Teradata Studio on Linux.
        su
        ./studioinstall TeradataStudio-14.10.01.00-1.x86.rpm
    4) Provide the path to where you would like to install Teradata Studio.
       The default location is /opt/teradata. When Teradata Studio is started, a 'workspace'
       directory is created in the location where you launched Teradata Studio (TeradataStudio) from,
       called workspace-studio. This directory contains workspace files, including the SQL project folder.
       The teradata.log file is located in the install /configuration directory.

    Note: To check whether Teradata Studio is installed or not, run the following command:
        rpm -qa TeradataStudio
    To remove the Teradata Studio product from your Linux system, run the following
    command:
        rpm -e TeradataStudio

  For Mac OS Install:
    1) Unzip the Teradata Studio package to your local file system.
    2) Double click on the Teradata Studio.pkg package to invoke the Teradata Studio installer
    3) You can change the install location or use the default install location, which is the
       /Applications/TeradataStudio folder. When Teradata Studio is started, a 'workspace-studio' folder
       is created in the user's Documents folder. This folder contains the workspace files, including the
       SQL project folder. The teradata.log file is located in the install /configuration directory.
 

Running Teradata Studio:
====================================
    Windows:
       Double click the Teradata Studio desktop icon shortcut.

    Linux:
       Update your path variable to include the TeradataStudio directory. Execute TeradataStudio.

    Mac:
       Execute Teradata Studio in the TeradataStudio directory.


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
        (Note: We have increased the memory allocations in the TeradataStudio.ini file from 256 to 512.)
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 Studio'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 Studio 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 Studio 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.