Setup Teradata SQL Assistant.

Before You Start

Before you set up any SQL client, you’ll need:

Download and install Cirro ODBC driver

First, download the Cirro ODBC driver for your system.

  • Open Cirro in a web browser.
  • Click Download Drivers, found at the bottom of the page.
  • Click the relevant 32 or 64 bit driver for your system.
  • Choose a download folder then click OK.
  • Run the downloaded installer then close when finished.

Next, we add the driver to the ODBC Data Source Administrator page.

  • Open Windows Settings and search on "ODBC"
  • Now choose the 32 or 64 bit driver version.
  • Click User DSN then Add.
  • Choose the Cirro Driver.
  • Click Finish.

When the driver is added, the system automatically displays the Cirro ODBC data source config tool.

There's two ways to setup the driver:

  1. Default - the driver defaults to "CIRRO" as the remote system. This gives access to all databases your user account has been granted.
  2. Passthrough - set up the driver with a database name and your Cirro account name and password. Click Resources then Datasources to find the database name.

You'll need to substitute your connection details for the example values below.

Field Description Example Values
Datasource Name Arbitrary title for the data source Cirro_ODBC
Cirro server hostname or ip address Hostname or IP address of the Cirro instance
Cirro server port The port the driver can access the server (defaults to 1521) 1521
Remote System Enter "CIRRO" to connect to Cirro Hub (and all the databases in the system), or use database name for passthrough connection. CIRRO
User name Cirro user name cirrouser
Password/Confirm Password Cirro user password cirropassword
Connection String Extra Properties Specific connection details. In this example, set tableNameQuery=true to use two-part object names in SQL queries (e.g., "database.schema.table" becomes "database-schema-table"). tableNameQuery=true
Extra JVM args Additional Java Virtual Machine arguments none
Log level 0-7 leave blank for default none

Download Application

  • Install Teradata on your client machine.

Define ODBC Datasource

This is a five step process that you’ll need to repeat for each database you want to query.

  • First, click Tools then Define ODBC Data Source

  • Second, click Add on the ODBC Data Source Administrator dialog.

  • Third, choose the Cirro ODBC driver and click OK.

  • Fourth, enter the connection details and click OK when finished.

Field Description Example values
Datasource Name Get the Cirro datasource name from Resources > Datasources and the Name column. Remember: Check if it is Enabled MyCirroDatabase
Cirro server host name or IP address hostname or IP address of the Cirro system.
Cirro server port Accept default value 1527 1527
Remote System Accept the default. CIRRO
User name, Password, Confirm Password Your Cirro account user name and password. If you’re using a timed one-time Password, add this to the end of your password. MyCirroUsername/MyCirroPassword
  • Finally, click OK on the ODBC Data Source Administrator dialog.

Connect to datasource

It’s a two step process to connect to each individual datasource.

  • First, click Tools then Connect.

  • Second, choose one data source you’ve set up.

    • Select Machine Data Source.

    • Choose the Data Source.

    • click OK.


If you’re having trouble connecting or seeing Datasources, check our Troubleshooting guide.