Troubleshooting

Teradata Developer Guides

ft:locale
en-US
ft:lastEdition
2026-08-18

Redis connection refused:

redis.exceptions.ConnectionError: Error -2 while writing to socket.
→ Ensure Redis is running. Check with redis-cli ping

Teradata connection failed:

teradatasql.OperationalError: [Error 8017] [SQLState HY000] Connection to database failed
→ Verify credentials and network access to Teradata instance

Consumer group error:

redis.exceptions.ResponseError: BUSYGROUP Consumer Group name already exists
→ The consumer group already exists from a previous run. You can either: - Use a different CONSUMER_GROUP name - Reset with: redis-cli XGROUP DESTROY events:stream teradata-consumer

Missing environment variables:

ValueError: Missing TERADATA_HOST, TERADATA_USER, or TERADATA_PASSWORD environment variables
→ Ensure your .env file exists in the same directory as consumer.py and contains all required variables.