User Guide Getting Started Help Center Documentation Community Training

Before configuring Looker to work with Teradata, you must install the hash_md5 user-defined function (UDF) on your Teradata server. You can find instructions for installing the UDF here.

To use Looker with Teradata you will need to configure a Teradata driver. These instructions describe that process, assuming use of a startup script similar to the examples provided here.

To install the driver, you will need to acquire two Teradata files, include them as part of the startup process, and add an option to tell Looker to access the driver.

Installing the Driver

To install the Teradata driver:

  1. Move the JARs to a subdirectory. For example:

    # log in as the looker user
    mkdir -p ~/looker/custom_jdbc_drivers/teradata_driver
    mv ~/terajdbc4.jar ~/looker/custom_jdbc_drivers/teradata_driver/
    mv ~/tdgssconfig.jar ~/looker/custom_jdbc_drivers/teradata_driver/
  2. Create a configuration file.

    Create a configuration file for the new driver, if one does not already exist in the ~/looker directory:

    vim ~/looker/custom_jdbc_config.yml

    In your configuration file, add the following:

    - name: teradata
    dir_name: teradata_driver
    module_path: com.teradata.jdbc.TeraDriver
  3. Configure Looker to use the new driver.

    If you are using a lookerstart.cfg file, add another startup option to the lookerstart.cfg file.

    If you are not using lookerstart.cfg, add the startup option to your startup script or create a new startup script.

    For example:

    vim lookerstart.cfg

    Then add the --use-custom-jdbc-config startup option to the list of LOOKERARGS environment variables. Make sure to leave any other configurations that are set there.

    For example:

  4. Restart Looker:

    ./looker restart

Connecting Looker to Teradata

Configure a database connection via the Looker interface. From the Admin section, select Connections then New Connection. See the Connecting Looker to Your Database documentation page for more information.

Click on Test These Settings to verify the connection is successful. The Testing Database Connectivity documentation page has troubleshooting information.

Feature Support

Looker’s ability to provide some features depends on whether the database dialect supports them.

In the current Looker release, Teradata supports the following Looker features: