Teradata
This documentation describes the integration of MindsDB with Teradata, the complete cloud analytics and data platform for Trusted AI. The integration allows MindsDB to access data from Teradata and enhance Teradata with AI capabilities.
Prerequisites
Before proceeding, ensure the following prerequisites are met:
- Install MindsDB locally via Docker or Docker Desktop.
- To connect Teradata to MindsDB, install the required dependencies following this instruction.
Connection
Establish a connection to Teradata from MindsDB by executing the following SQL command and providing its handler name as an engine.
Required connection parameters include the following:
host
: The hostname, IP address, or URL of the Teradata server.user
: The username for the Teradata database.password
: The password for the Teradata database.
Optional connection parameters include the following:
database
: The name of the Teradata database to connect to. Defaults is the user’s default database.
Usage
Retrieve data from a specified table by providing the integration, database and table names:
Run Teradata SQL queries directly on the connected Teradata database:
The above examples utilize teradata_datasource
as the datasource name, which is defined in the CREATE DATABASE
command.
Troubleshooting
Database Connection Error
- Symptoms: Failure to connect MindsDB with the Teradata database.
- Checklist:
- Make sure the Teradata database is active.
- Confirm that host, user and password are correct. Try a direct connection using a client like DBeaver.
- Ensure a stable network between MindsDB and Teradata.
SQL statement cannot be parsed by mindsdb_sql
- Symptoms: SQL queries failing or not recognizing table names containing spaces or special characters.
- Checklist:
- Ensure table names with spaces or special characters are enclosed in backticks.
- Examples:
- Incorrect: SELECT * FROM integration.travel-data
- Incorrect: SELECT * FROM integration.‘travel-data’
- Correct: SELECT * FROM integration.`travel-data`
Connection Timeout Error
- Symptoms: Connection to the Teradata database times out or queries take too long to execute.
- Checklist:
- Ensure the Teradata server is running and accessible (if the server has been idle for a long time, it may have shut down automatically).